Open Agents 会话管理指南如何创建、恢复与归档编码任务【免费下载链接】open-agentsAn open source template for building cloud agents.项目地址: https://gitcode.com/GitHub_Trending/op/open-agentsOpen Agents 是一个开源的云编码智能体Coding Agent参考应用它的会话管理Session Management是整套系统的核心每个会话绑定一个独立云沙箱负责编码任务的创建、恢复与归档。本文带你快速看懂这三件事是如何运作的——从一条提示词到可运行的代码变更全程无需保持笔记本参与。先搞懂结构会话Session与聊天ChatOpen Agents 是三层系统Web - Agent workflow - Sandbox VMWeb 层负责登录、会话列表、聊天界面与流式输出Agent 层作为持久化工作流Workflow运行可跨多个持久化步骤执行沙箱层执行环境提供文件系统、Shell、Git 与开发服务器。在数据模型中一个 Session会话对应一个沙箱而一个会话下可以挂多个Chat聊天。每次新对话就是新建一个 Chat消息按时间持久化会话可随时切回。相关定义见 schema.ts数据库操作层在 sessions.ts。创建编码任务一个请求三步完成当你点击新建会话前端会向POST /api/sessions发起请求route.ts 中按顺序完成三件事安全防护机器人识别 每用户每分钟 10 次的创建频率限制写入数据库通过 createSessionWithInitialChat 在同一个事务里创建会话和初始聊天状态置为running沙箱状态为provisioning准备中异步拉起沙箱调用kickSandboxProvisioningWorkflow启动供给工作流克隆仓库、切换分支、准备执行环境。几个贴心细节自动命名不填标题时系统会从随机城市名中挑选一个不重复的名称random-city.ts避免列表里一片新会话自动开新分支开启isNewBranch后系统按用户名缩写/随机后缀生成分支名你的改动不会直接落在主干上可选自动化可以按会话覆盖自动提交推送和自动创建 PR的偏好。 想本地跑起来git clone https://gitcode.com/GitHub_Trending/op/open-agents然后bun install bun run web。恢复会话快照休眠与唤醒机制云沙箱不会永远开机——闲置 30 分钟后自动休眠这是 Open Agents 会话恢复的关键。完整状态机见 SANDBOX-LIFECYCLE.mdprovisioning ──▶ active ──▶ hibernating ──▶ hibernated ▲ │ └──── 用户点击 Resume ───────┘事件系统行为用户发消息刷新lastActivityAt顺延休眠倒计时闲置满 30 分钟打快照snapshot并停止沙箱进入hibernated用户点击 Resume从快照恢复沙箱继续之前的工作会话归档停止沙箱、清理快照状态置为archived恢复之所以无缝是因为沙箱支持基于快照的恢复文件系统、Git 分支、开发服务器状态都保存在快照里。核心评估逻辑在 lifecycle.ts持久化工作流能扛过部署与冷启动的可存活睡眠在 sandbox-lifecycle.ts。前端每 15 秒轮询GET /api/sandbox/status同步状态状态芯片会显示Active / Paused / No sandbox你随时知道沙箱是醒着还是睡了。归档编码任务保留记录释放资源任务完成后归档会话是善后的标准动作。调用PATCH /api/sessions/[sessionId]route.ts将状态改为archived底层执行 archive-session.ts 中的流程回刷 Git 状态连上沙箱读取真实分支查询 PR 最新状态open / merged / closed确保列表显示的是准确信息更新会话记录状态与生命周期状态同步置为archived清空过期时间等字段后台收尾异步停止沙箱、清除快照 URL 与沙箱状态——聊天历史、Diff 缓存、PR 编号全部保留随时可以在已归档标签页翻查侧边栏逻辑见 inbox-sidebar.tsx。归档后的会话在侧边栏有独立的分页列表默认每页 50 条最多 100 条既不打扰进行中的任务也不丢失历史成果。✅会话状态速查表状态lifecycleState含义你能做什么provisioning沙箱准备中等待克隆完成active沙箱运行中正常对话、看 Diffhibernated已休眠点击 Resume 恢复archived已归档查看历史、翻找 PRfailed异常查看 lifecycleError 详情小结Open Agents 的会话管理可以一句话概括创建即开沙箱闲置即休眠归档即清场。三层分离架构Web / Agent 工作流 / 沙箱 VM让智能体执行不依赖单一请求、沙箱生命周期可独立休眠与恢复这正是它在云端跑长编码任务依然稳的关键。核心源码路径会话 APIapp/api/sessions/数据库层lib/db/sessions.ts生命周期工作流app/workflows/sandbox-lifecycle.ts归档逻辑lib/sandbox/archive-session.ts【免费下载链接】open-agentsAn open source template for building cloud agents.项目地址: https://gitcode.com/GitHub_Trending/op/open-agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考