跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

执行框架

最后更新 查看 MarkdownAgent 设置

执行框架是一种循环,使智能体能够持续执行任务,而非仅调用一次模型。

它负责围绕模型开展每轮工作:构建提示词、加载记忆、选择工具、处理工具结果、流式返回响应、持久化消息,以及决定智能体应继续还是停止。

要构建新 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 被驱逐后恢复的方式。
  • 扩展点 — 每轮执行、步骤、工具调用和恢复事件前后的钩子。

相关资源

会话

跨轮次存储对话上下文和记忆。

这篇文档对您有帮助吗?