5分钟快速开始:Vercel Open Agents

一个用于在Vercel上构建和运行云端智能体的开源模板,快速部署并体验AI驱动的编码代理。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Node.js >=18 必需

所需工具

Git

克隆仓库

必需
Vercel CLI

部署到Vercel

操作步骤

1

克隆仓库并安装依赖

从GitHub克隆项目并安装必要的Node.js依赖包。

克隆项目到本地
git clone https://github.com/vercel-labs/open-agents.git
进入项目目录并安装依赖
cd open-agents && npm install

预期结果::依赖安装成功,无错误信息。

确保Node.js版本符合要求,否则可能安装失败。

2

设置环境变量

创建本地环境配置文件并填入基本值,以便应用启动。

复制环境变量示例文件
cp apps/web/.env.example apps/web/.env
添加一个示例PostgreSQL连接字符串(需替换为真实值)
echo 'POSTGRESURL=postgresql://user:pass@localhost:5432/db' >> apps/web/.env

预期结果::文件创建成功,无错误。

POSTGRESURL是启动所需的最小环境变量,可使用Neon等免费服务获取。

3

启动本地开发服务器

运行开发命令以在本地启动应用并查看效果。

启动开发服务器
npm run dev

预期结果::服务器启动,输出类似'ready - started server on 0.0.0.0:3000'的信息。

打开浏览器访问 http://localhost:3000 查看应用界面。

验证成功

确认应用已成功运行并显示基本界面。

浏览器打开 http://localhost:3000 显示登录或欢迎页面
终端无错误日志,服务器持续运行

快速提示

部署

使用Vercel一键部署可跳过本地设置,快速上线。

配置

环境变量如JWESECRET和ENCRYPTIONKEY需自行生成,可用openssl命令。

常见问题

1

npm install失败

检查Node.js版本,确保>=18,并尝试删除node_modules后重试。

2

应用启动后显示错误页面

确认环境变量POSTGRESURL已正确设置,并重启服务器。

下一步

部署到Vercel

按照README部署指南,添加Vercel OAuth和GitHub App以启用完整功能。

探索代理功能

在本地或部署后,尝试使用聊天界面与AI代理交互,体验编码任务。

助手