技能说明
Cloudflare 官方 Agents SDK 技能，覆盖有状态 Agent、定时任务、RPC、MCP、流式聊天和持久化工作流。 适用范围：Cloudflare Workers、Durable Objects、Agents SDK 与相关 MCP 集成。 限制：需要 Node.js、Workers 项目和对应 Cloudflare 配置；Voice、浏览器工具和 Think 等部分能力仍是实验性功能。 安全提示：部署前确认项目、绑定、权限、网络和密钥；不要修改旧 migration，也不要把凭据写入代码或日志。
关于此技能
Cloudflare 官方 Agents SDK 技能，指导 Agent 使用 Cloudflare Workers 与 Agents SDK 构建、调试和审查有状态的 AI Agent 应用。遇到 SDK 版本问题时优先读取 Cloudflare 最新文档。
核心能力
有状态 Agent
处理 Durable Objects 状态、Agent 路由、RPC、定时任务、队列、重试和可持续执行。
实时与工具集成
覆盖流式聊天、MCP 客户端与服务端、邮件、Webhook、浏览器工具、推送通知和可观测性。
适用场景
边缘 Agent 应用
在 Cloudflare Workers 上构建带持久状态、WebSocket、聊天或实时协作的 Agent。
可靠后台任务
需要工作流、队列、重试、定时调度、人工审批或跨故障恢复的 Agent 系统。
使用步骤
- 01
第一步：确认运行环境
确认目标是 Workers、Agents SDK、Durable Objects 还是 MCP 集成，并先确定所需的 npm 包和部署范围。
- 02
第二步：核对安装
检查 npm ls agents；缺少时安装 agents，聊天项目再按需安装 @cloudflare/ai-chat、ai 和 @ai-sdk/react。
- 03
第三步：配置项目
配置 nodejs_compat、Durable Objects 绑定、SQLite migration 和 Workers AI binding，避免修改旧 migration。
- 04
第四步：实现与验证
定义 Agent 类、状态校验、路由、RPC、工作流和重试，先本地验证状态、连接、权限与日志，再考虑部署。
常见问题
它会直接部署到生产吗？+
不会；它提供实现、配置和检查建议，实际部署仍需要明确项目、权限和用户批准。
哪些能力还不稳定？+
Voice、浏览器工具和 Think 等功能在来源文档中标为实验性，使用前应读取当前文档并单独验证。
为什么要先查最新文档？+
技能明确提醒 Agents SDK 会变化，旧记忆可能过时，应以 Cloudflare 当前文档和项目版本为准。
有哪些常见配置坑？+
不要开启 experimentalDecorators；不要修改旧 migration；每个 Agent 类都要有对应的 Durable Objects 绑定和 migration。
安装前检查
把兼容性、来源和安装入口先看清楚，再放进自己的工作流。
Codex · Claude Code · Cursor
已提供来源链接
命令可直接复制
2026/10/18
安装提醒：这项技能可能涉及网络、脚本、文件或凭据权限，安装前请先阅读 SKILL.md，并确认它需要哪些权限。
npx skills add cloudflare/skills --skill agents-sdk