执行框架是一种循环,使智能体能够持续执行任务,而非仅调用一次模型。
它负责围绕模型开展每轮工作:构建提示词、加载记忆、选择工具、处理工具结果、流式返回响应、持久化消息,以及决定智能体应继续还是停止。
要构建新 agent,请从在 Durable Object 中运行 Pi Durable 的 Pi harness 开始。你也可以运行 OpenCode,或基于 Agents SDK runtime 自行构建 loop。
执行框架位于 Agents SDK 运行时之上:
- runtime 会协调启动和持久 job、路由以及你安装的功能。这些功能可以添加 WebSocket 连接、共享状态、计划和 MCP 连接。使用可观测性追踪模型调用并检查 runtime 事件。
- 执行框架 为智能体定义行为:模型调用、提示词构建、工具选择、流处理、记忆策略和生命周期钩子。
运行时回答“智能体在哪里运行,以及如何保持持久化?”执行框架回答“智能体在每一轮中执行什么操作?”
对话存储取决于 harness。Pi 和 OpenCode 管理自己的 transcript。Think 和 AIChatAgent 会安装 SDK 的 Sessions 功能。要查找与你的 agent 相关的 API,请参阅选择功能。
如果希望由 Pi Durable ↗ 管理 agent loop、transcript 和恢复,请使用 Pi。这是新 agent 的推荐起点。PiHarness 在 Durable Object 中运行 Pi,并在驱逐后唤醒它。transport 由你选择。
如果需要完全控制模型调用、消息格式、工具循环或 UI 协议,请自行构建执行框架。需要直接组合 Agents SDK 的底层 API 时,可以采用此方式。
如果希望使用 OpenCode 2.0 的会话、工具和插件系统,请使用 OpenCode(实验性)。OpenCodeHarness 在普通 Durable Object 内运行 OpenCode 的 Workerd SDK ↗。
Pi
在 Durable Object 中运行 Pi Durable session,使用 SQLite 存储,并在驱逐后恢复。
OpenCode(实验性)
在普通 Durable Object 中运行 OpenCode 2.0,支持 Workers AI 模型、捆绑插件与持久会话。
执行框架通常负责:
- 提示词构建 — 系统提示词、记忆、检索的上下文和每轮指令。
- 模型执行 — 调用 Workers AI、OpenAI、Anthropic、Gemini 或其他提供程序。
- 工具编排 — 服务端工具、客户端工具、MCP 工具、审批流程,以及获得工具结果后继续执行。
- 消息持久化 — 保存和重放用户、助手及工具消息的方式。
- 流式处理和恢复 — 向客户端流式发送响应,以及在连接中断或 Durable Object 被驱逐后恢复的方式。
- 扩展点 — 每轮执行、步骤、工具调用和恢复事件前后的钩子。
Agents SDK 运行时
使用 Lifecycle 和可选功能在 Durable Object 上组合 harness。
会话
跨轮次存储对话上下文和记忆。
使用 fibers 持久执行
在 Durable Object 被驱逐后恢复长时间运行的智能体任务。