普通 Worker 能响应请求,但很多应用还需要稳定身份来保存状态、协调连接的客户端,并在请求结束后继续工作。Cloudflare Agents SDK 在 Workers 和 SQLite-backed Durable Objects 之上提供这种应用模型。
本课逐项构建小型示例支持系统。起初不使用 AI 模型,以清楚观察命名身份、持久化状态和客户端同步;后续加入持久对话、计划任务、模型选择的工具、明确审批、只读 MCP 接口和路由诊断。每个新概念都结合应用需求介绍,无需已有 Agents SDK 经验。
课程包含 8 个引导实验和 1 个独立审批修复挑战。引导实验先教授每项能力,再进入独立挑战。
你将学到什么
- 创建命名支持 Agent: 为稳定名称路由,持久化支持状态,并证明实例相互隔离
- 同步支持仪表板: 连接两个浏览器客户端,观察服务器权威状态的实时更新
- 流式传输持久对话: 流式返回有界回答,重新连接后恢复对话历史
- 安排支持跟进任务: 注册、检查、完成和取消持久 Agent 任务
- 添加经过验证的支持工具: 用 schema 和服务器范围检查连接模型选择的工具与示例记录
- 记录修改前要求审批: 暂停副作用等待人工决定,并安全处理重复投递
- 发布只读 MCP 工具: 经远程 MCP transport 暴露严格验证的示例查询
- 诊断路由错误的 Agent 会话: 修复选择的 Agent 名称,不丢失历史或削弱隔离
- 未经批准的支持更新: 独立修复配套 Agent 的审批前置与恰好一次效果
适合人群
适合熟悉 Workers 和 Durable Objects,希望构建有状态助手与协同客户端的开发者。
先修要求: 完成 Cloudflare Durable Objects for Beginners 和 将 LabEx 连接到你的 Cloudflare 账户。你应理解小型 TypeScript Worker 及每个稳定名称对应一个 Durable Object 的概念;课程从头教授 Agents SDK。
学习环境: 使用自己的专用 Cloudflare 学习账户。每个单元使用全新 VM,单独授权 Wrangler,创建名称唯一的临时资源,最后删除资源并退出登录。练习使用有限的 Workers Free 资源;启用模型的单元只调用少量 Cloudflare 托管推理。
常见问题
需要 Agents SDK 或 AI 经验吗?
无需 Agents SDK 经验。前两个实验不使用 AI,先理解命名身份、持久状态和同步客户端。启用模型的实验需要 Workers AI 基础。
模型能直接修改记录吗?
工具调用提议必须通过 schema 和服务器范围检查。审批实验暂停副作用等待人工决定,并安全处理重复投递;挑战检查效果之前已获得审批。
客户端重新连接后会怎样?
实验区分 Agent 身份、持久对话、服务器权威状态与单个浏览器连接。你还需修复路由错误的会话,同时保留有效历史。
如何清理资源?
在仍有授权时,仅删除实验的临时 Workers 和对象命名空间,确认删除后退出登录。每个 VM 都独立授权自己的账户。



