【open-agents】一个能自动写代码、跑环境、提 PR 的开源智能体参考实现
Open Agents 是一个开源的参考应用,它帮你构建并运行能在后台自主完成编程任务的 AI 智能体——比如读代码、改文件、执行命令、启动服务、提交 PR,全程无需本地电脑持续在线。
主要功能与特性
- ✅ 对话驱动的编程智能体:支持文件读写、代码搜索、Shell 执行、任务分解、技能调用和网页访问等工具能力
- ✅ 持久化多步工作流:基于 Vercel Workflow SDK 实现长周期运行、实时流式响应与中途取消
- ✅ 隔离式沙盒环境:每个任务运行在独立的 Vercel 沙盒中,支持快照保存与按需恢复(自动休眠/唤醒)
- ✅ 完整 GitHub 协作流:可克隆仓库、创建分支、自动提交更改、推送代码并生成 Pull Request(可选启用)
- ✅ 会话共享与语音输入:生成只读链接分享对话过程;可选集成 ElevenLabs 实现语音转文字输入
快速上手
项目支持一键部署到 Vercel 或本地运行:
本地启动(需已安装 Bun):
bun install
cp apps/web/.env.example apps/web/.env
# 编辑 .env 填入 POSTGRES_URL、JWE_SECRET、ENCRYPTION_KEY 等必要变量
bun run web
Vercel 部署推荐流程:
1. Fork 本仓库
2. 在 Vercel 导入项目,配置至少以下环境变量:
env
POSTGRES_URL=
JWE_SECRET=
ENCRYPTION_KEY=
3. 后续按需添加 Vercel OAuth 和 GitHub App 凭据以启用登录与代码协作功能
⚠️ 注意:完整功能依赖多项外部服务(PostgreSQL、Vercel OAuth、GitHub App),请参考官方文档进行安装与配置。
适用场景与目标用户
- 开发者与团队:希望快速验证“AI 编程智能体”架构可行性,或基于此搭建内部自动化开发助手
- AI 工具构建者:需要可复用的 Agent + 沙盒 + Web UI 分层参考实现,避免从零设计控制流与状态管理
- 教育与研究者:学习如何将大模型推理、工作流编排、安全执行环境(沙盒)与真实开发平台(GitHub)解耦集成
它不是开箱即用的 SaaS 产品,而是一个“可 fork、可修改、可演进”的工程样板——适合愿意投入少量配置成本,换取对智能体系统底层逻辑清晰掌控的实践者。
总结
Open Agents 清晰展现了现代 AI 编程智能体的一种务实落地路径:通过分层解耦(Web 层 / Agent 工作流层 / 沙盒执行层),兼顾灵活性、安全性与可维护性。它不追求黑盒封装,而是把关键决策(如“Agent 不在沙盒内运行”)显性化,为后续扩展模型、工具或基础设施留出空间。如果你正探索如何让 AI 真正参与软件开发闭环,这是一个值得深入研究的高质量起点。
