面向初学者的 Cloudflare Agents SDK

通过命名会话、同步客户端、持久化对话、计划任务、经过验证的工具、审批边界、MCP 集成和实用诊断,构建并运行有状态的 Cloudflare Agents。

Cloudflare网页开发

💡 本教程由 AI 辅助翻译自英文原版。如需查看原文,您可以 切换至英文原版

简介

普通 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 都独立授权自己的账户。

教师

labby
Labby
Labby is the LabEx teacher.