C
ChaoBro

Vercel 开源 open-agents:把云端编程 Agent 做成标准化模板

Vercel 开源 open-agents:把云端编程 Agent 做成标准化模板

GitHub 今天 trending 第 8 名,4.9k stars,406 星/天。数字不算爆炸,但点开仓库看了下,有点意思。

vercel-labs/open-agents 不是又一个"用 AI 写代码"的 toy project。它是一套完整的云端 Agent 参考架构——从认证、会话管理、沙箱隔离到 Git 集成和 PR 自动创建,全都有。

三层架构

项目把自己拆成三个层次:

  • Web 层:认证、会话、聊天界面、流式 UI。基于 Next.js。
  • Agent 工作流:在 Vercel 上以 durable workflow 运行,支持流式输出和中途取消。
  • 沙箱 VM:独立的执行环境,有文件系统、shell、git、开发服务器和预览端口。

最关键的洞察是这句:"agent is not the sandbox"。Agent 跑在沙箱外面,通过工具调用与 VM 交互。这意味着沙箱可以休眠、快照、恢复,而 Agent 的状态不受影响。

这个设计比大多数把 Agent 和沙箱绑在一起的方案聪明。你见过那些跑了一半断线、全部进度丢掉的 coding agent 吧?这就是它们没做好状态隔离。

能干什么

已经支持的功能:

  • 对话驱动的编程 Agent,带文件操作、搜索、shell 命令、web 访问等工具
  • Git 仓库克隆和分支操作
  • 自动 commit、push 和 PR 创建
  • 会话分享(只读链接)
  • 语音输入(ElevenLabs 转录)

一键部署到 Vercel,环境变量配好 Postgres URL、Better Auth secret、GitHub App 和 Vercel OAuth 就能跑。

谁该关注

如果你是——

  • 想用 Vercel 基础设施搭建自己的 coding agent 服务
  • 在评估 Vercel sandbox 作为 Agent 执行环境的可行性
  • 需要 durable workflow 模式(多步骤、可中断、可恢复)

这个仓库是个不错的起点。962 次提交说明不是三天拼出来的 demo,团队在认真维护。

如果你对 Vercel 生态不感冒,这个项目的架构思路也有参考价值。Agent 和沙箱分离、durable workflow 做状态管理、快照恢复——这些模式迁移到其他云平台也行得通。

隐患

依赖 Vercel 生态太深。Postgres、Better Auth、Vercel Sandboxes、Vercel OAuth、GitHub App——一整套栈绑在 Vercel 上。想换到 AWS 或自建,工作量不小。

另外 263 个分支、28 个 open issues、22 个 PR,对一个开源参考项目来说活跃度偏高,说明还在快速迭代期,API 可能会变。

主要来源:vercel-labs/open-agents GitHubVercel Labs