基于Open Agents打造自己的云端智能体完整指南【免费下载链接】open-agentsAn open source template for building cloud agents.项目地址: https://gitcode.com/GitHub_Trending/op/open-agentsOpen Agents是一个开源的云智能体Cloud Agent模板帮助你快速构建属于自己的云端 AI 编程智能体输入一段提示词智能体就会在云端沙箱里自动读代码、改文件、跑命令最后把代码改动提交成 Pull Request——全程无需打开笔记本电脑。它基于 Next.js Vercel Sandbox 构建自带 Web 界面、智能体运行时、沙箱编排和 GitHub 集成开箱即用 Open Agents 是什么Open Agents 本质上是一个三层系统Web - Agent workflow - Sandbox VM层级职责所在位置Web 应用认证、会话、聊天、流式界面apps/web/Agent 智能体在 Vercel 上以持久化工作流方式运行packages/agent/Sandbox 沙箱文件系统、Shell、Git、开发服务器、预览端口packages/sandbox/ 核心设计智能体 ≠ 沙箱这是该项目最重要的架构决策智能体不运行在虚拟机内部而是在沙箱外部通过文件读写、搜索、Shell 命令等工具与沙箱交互。这个分离带来了几个直接好处✅ 智能体执行不再绑定单次请求的生命周期可以跨多个持久化步骤运行✅ 沙箱可以独立休眠hibernate和恢复resume节省资源✅ 模型/提供商的选择与沙箱实现可以各自独立演进✅ 虚拟机保持纯粹的执行环境不会变成控制平面想深入了解架构细节推荐阅读 docs/agents/architecture.md开箱即用的核心功能Open Agents 提供了一整套完整的云智能体能力聊天驱动的编程智能体内置文件、搜索、Shell、任务、技能Skills和网络抓取等工具⚡持久化多步执行基于 Workflow SDK 的运行、流式输出和随时取消隔离的 Vercel 沙箱支持基于快照snapshot的恢复仓库克隆与分支工作在沙箱内完成 Git 操作自动提交、推送并创建 PR任务成功后可自动完成按偏好开启会话分享通过只读链接分享会话记录️语音输入通过 ElevenLabs 转写可选智能体可用的核心工具定义在 packages/agent/tools/index.ts包括read、write、grep、glob、bash、task等系统提示词由 packages/agent/system-prompt.ts 生成确保智能体端到端完成任务、不中途停止。本地快速启动3 步跑起来如果你想在本地先体验一下只需要三步第 1 步克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/op/open-agents cd open-agents bun install第 2 步创建本地环境配置文件cp apps/web/.env.example apps/web/.env然后打开apps/web/.env填入必需的值。最小运行配置只需要两个变量POSTGRES_URL BETTER_AUTH_SECRET其中BETTER_AUTH_SECRET可以用下面的命令生成openssl rand -base64 32完整的环境变量清单可以在 apps/web/README.md 的说明和apps/web/.env.example中查阅。第 3 步启动应用bun run web打开浏览器访问http://localhost:3000你的云端智能体就已经在本地跑起来了 ✨部署到自己的云端Vercel 部署步骤想要一个真正云端的智能体Open Agents 与 Vercel 深度集成部署流程非常顺滑Fork 本仓库并将其导入 Vercel使用官方部署按钮时Neon Postgres 会自动创建在 Vercel 项目设置中配置POSTGRES_URL和BETTER_AUTH_SECRET部署一次获得稳定的生产环境 URL创建Vercel OAuth 应用用于登录回调地址填https://YOUR_DOMAIN/api/auth/callback/vercel填入NEXT_PUBLIC_VERCEL_APP_CLIENT_ID和VERCEL_APP_CLIENT_SECRET后重新部署可选创建GitHub App以解锁完整的仓库访问、推送和 PR 能力Homepage URLhttps://YOUR_DOMAINCallback URLhttps://YOUR_DOMAIN/api/auth/callback/githubSetup URLhttps://YOUR_DOMAIN/api/github/app/callback部署完成后你的团队就可以各自拥有一个独立可定制的云端智能体平台而不是使用别人的服务 沙箱如何工作自动休眠与恢复云端沙箱不是一直开着的——Open Agents 内置了智能的生命周期管理沙箱空闲30 分钟后自动休眠先做快照再停止虚拟机标准配置的硬超时为5 小时Hobby 配置下为 40 分钟用户再次发消息或点击Resume时沙箱从快照秒级恢复之前的文件、开发服务器状态都还在这意味着你可以放心把智能体交给它跑长任务资源成本可控。整个状态机provisioning → active → hibernated → 恢复在 apps/web/SANDBOX-LIFECYCLE.md 中有完整说明。项目结构速览找到你想改的地方Open Agents 是一个 Turborepo monorepo目录职责清晰非常适合 fork 后二次开发apps/web Next.js 应用工作流、认证、聊天 UI packages/agent 智能体实现工具、子智能体、技能、上下文管理 packages/sandbox 沙箱抽象与 Vercel 沙箱集成 packages/shared 共享工具新手开发时建议重点关注这几个入口智能体本体packages/agent/open-agent.ts工具注册表packages/agent/tools/index.ts子智能体explorer 只读探索 / executor 完整执行packages/agent/subagents/数据库表结构apps/web/lib/db/schema.ts沙箱配置与超时apps/web/lib/sandbox/config.ts常用开发命令日常开发和调试这几个命令够用命令作用bun run web启动开发服务器bun run checkLint 格式检查bun run fixLint 格式自动修复bun run typecheck全部包类型检查bun run ci完整 CI检查、类型检查、测试、迁移检查bun test运行所有测试写在最后Open Agents 的价值不在于又一个聊天机器人而在于它把云端智能体的完整拼图——持久化工作流、隔离沙箱、快照恢复、GitHub 集成——全部开源了出来并明确鼓励你 fork 后按自己的需求改造。无论你是想给团队搭一个后台编码智能体还是想学习云智能体的工程架构从这个模板入手都是最快的一条路。现在fork 它部署它打造你自己的云端智能体吧 【免费下载链接】open-agentsAn open source template for building cloud agents.项目地址: https://gitcode.com/GitHub_Trending/op/open-agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考