开发与工程

Cloudflare Agents SDK 构建指南

帮助开发者在 Cloudflare Workers 上构建具备持久状态、实时通信和可靠后台执行能力的 AI Agent。

49/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 3.1k
最近更新
13 天前
License
Apache-2.0
cloudflare-workersagents-sdkdurable-objectswebsockets
+3mcpreact-hooksworkflow-orchestration

这个 Skill 能做什么,适合哪些场景?

该技能面向使用 Cloudflare Agents SDK 构建 AI Agent 的开发者。它涵盖 Agent 类、持久状态、WebSocket、可调用 RPC、定时任务、Workflows、队列、重试、MCP、聊天应用和 React 客户端钩子。技能要求优先检索 Cloudflare Agents 文档,以降低预训练知识过时带来的风险。语音、浏览器工具和 Think 被明确标为实验性功能。

指导用户检查并安装 agents npm 包,配置 Wrangler 中的 Durable Objects、SQLite 迁移和 Workers AI 绑定,编写 Agent 类、状态校验、RPC 方法和路由。它还提供调度、工作流、持久执行、队列、重试、聊天流、MCP、邮件、Webhook、推送通知、可观测性及 React 客户端的 API 示例,并指向对应的 Cloudflare 文档和本地参考文件。

适合
  • 开发者需要在 Cloudflare Workers 上创建带持久状态的聊天 Agent 或协作应用时使用。
  • 团队需要通过 WebSocket、RPC 和 React hooks 构建实时客户端体验时使用。
  • 工程师需要运行可恢复的多步骤后台任务、队列任务或带重试逻辑的工作流时使用。
  • 开发者需要让 Agent 连接 MCP 服务或在 Cloudflare 上构建 MCP 服务器时使用。
  • 团队需要为 Agent 增加定时任务、邮件处理、Webhook、推送通知或观测事件时使用。

如何安装这个 Skill?

使用前请注意
  • 核心能力覆盖邮件、浏览器自动化、MCP、Webhook、推送和代码执行,部署前应逐项审查权限、鉴权、数据外传、人工审批和回滚方案。
  • 引用的 Cloudflare 文档需要联网检索;应确认目标环境可访问,并在中国大陆网络受限时准备镜像、缓存或本地版本。
  • 示例未在本次审查中执行,不能据此确认 API 版本兼容性、迁移正确性或生产稳定性。
  • 未提供明确版本、变更日志和维护责任,升级 SDK 前应重新核对所有外部引用。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
需要预先安装
  • Node.js and npm
  • Cloudflare Workers

该技能属于 cloudflare/skills 集合。可运行 npx skills add https://github.com/cloudflare/skills 安装集合;也可将对应技能目录复制到所用 Agent 客户端的技能目录,例如 OpenAI Codex 使用 ~/.codex/skills/。仓库未说明单独安装 agents-sdk 技能的专用命令。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/cloudflare/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/agents-sdk" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 在 Cloudflare Workers 上构建一个带持久状态和 WebSocket 的 AI Agent

在支持 Agent Skills 标准的客户端中提出与 Cloudflare Agents SDK 相关的请求,例如“在 Cloudflare Workers 上构建一个带持久状态和 WebSocket 的 AI Agent”。开始实现前,按技能建议访问 https://developers.cloudflare.com/agents/ 获取最新文档;项目中可先运行 npm ls agents,若未安装则运行 npm install agents。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖从 Agent 类和状态管理到工作流、队列、重试、聊天流和 MCP 的完整开发路径。
  • 提供 Wrangler 配置、路由、RPC、React hooks 等可直接参考的代码示例。
  • 明确提醒优先检索官方文档,适合 Agents SDK 可能快速变化的场景。
局限
  • 主要适用于 Cloudflare Workers 与 Agents SDK 生态,不是通用 Agent 开发指南。
  • 语音、浏览器工具和 Think 功能仍标记为实验性。
  • 来源未提供独立测试套件、性能数据或成本评估。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Cloudflare Agents SDK 构建指南 本页 49 · 谨慎使用 ★ 3.1k 13 天前 Apache-2.0
Cloudflare Durable Objects 构建指南 48 · 谨慎使用 ★ 3.1k 13 天前 Apache-2.0
PinMe UniwebPay 支付集成 60 · 推荐 ★ 3.7k 3 个月前 MIT
Cloudflare 邮件服务技能 52 · 谨慎使用 ★ 3.1k 13 天前 Apache-2.0
Azure AI Foundry Agent Framework ✓ Microsoft · 官方 50 · 谨慎使用 ★ 2.7k 3 个月前 MIT

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
49/ 100 五分制 2.5 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全11 / 25 · 2.2/5

材料包含 OAuth、HMAC、安全回复、密钥存储、MCP 加固及人工审批示例,显示出部分安全意识;但涉及邮件、浏览器、Webhook、推送、MCP 和代码执行等外部影响时,未系统说明最小权限、完整数据流、敏感数据处理、回滚或用户确认边界,因此扣分。

2可靠稳定8 / 20 · 2.0/5

文档结构和示例相互基本一致,覆盖安装、配置、核心 API、恢复、重试和异常提示;但多个引用文件仅要求继续读取外部文档,缺少本地测试、版本锁定、关键路径复现证据及统一错误处理。按静态校准,不能超过10分,故扣分。

3适用触发10 / 15 · 3.3/5

前置描述明确面向在 Cloudflare Workers 上构建有状态代理、工作流、实时应用、MCP、聊天、语音和浏览器自动化,触发场景较清楚;但非适用边界、输入输出契约和语义触发条件不够完整,且核心检索依赖 Cloudflare 海外文档,未说明中国大陆网络可达性或中文支持,因此扣分。

4规范维护8 / 15 · 2.7/5

具备分层目录、安装命令、配置示例、参考文件、实验性标记、Apache-2.0 许可证和迁移注意事项;但缺少明确的 SDK/文档版本、变更日志、维护责任人、更新路径、常见故障排查和系统化限制说明,因此扣分。

5有效结果7 / 15 · 2.3/5

内含可直接改编的 TypeScript、React、Wrangler 和 API 示例,并覆盖较多 Agents SDK 功能,核心指导价值明确;但示例未执行验证,部分内容依赖外部文档且复杂场景仍需用户自行整合、鉴权和测试。静态校准最高7分,故取上限。

6证据核验5 / 10 · 2.5/5

提供了大量指向 Cloudflare 官方文档的主题映射和可审计代码片段,具备有限的主要来源追踪性;但没有提交测试套件、CI 覆盖关键路径或第三方复现结果,且本次仅静态阅读,因此不超过5分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 70215303d44a 评估证据[1][2][3][4][5][6][7][8][9][10][11][12]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

它是否负责部署 Cloudflare 应用?
技能提供 Wrangler 配置和部署相关参考,但来源没有说明它会自动执行部署。
使用聊天 Agent 需要哪些 npm 包?
来源给出的命令是 `npm install agents @cloudflare/ai-chat ai @ai-sdk/react`。
MCP 是该技能的必需依赖吗?
不是。MCP 是覆盖的集成功能,只有需要连接 MCP 服务或构建 MCP 服务器时才使用。
如何处理 Agents SDK 文档变化?
技能明确建议优先检索 Cloudflare Agents 官方文档,而不是完全依赖预训练知识。

同仓库的其他 Skills

均来自 cloudflare/skills

开发与工程

Cloudflare Durable Objects 构建指南

帮助代理构建和审查 Cloudflare 上的有状态协调应用。

★ 3.1k FS 48 谨慎使用 13 天前
开发与工程

Cloudflare 邮件服务技能

帮助智能体在 Cloudflare 上配置并实现事务性邮件收发与邮件路由。

★ 3.1k FS 52 谨慎使用 13 天前
开发与工程

Workers 生产实践审查

按最新 Cloudflare 资料审查并编写可上线的 Workers 代码。

★ 3.1k FS 57 谨慎使用 13 天前
开发与工程

Cloudflare Wrangler 部署助手

帮助代理可靠地使用 Wrangler 构建、开发、部署和管理 Cloudflare Workers。

★ 3.1k FS 49 谨慎使用 13 天前
开发与工程

Cloudflare Sandbox 构建助手

帮助代理在 Cloudflare Workers 上构建安全的隔离代码执行环境。

★ 3.1k FS 46 谨慎使用 13 天前
开发与工程

Cloudflare 平台开发技能

帮助代理检索资料并构建 Cloudflare 应用。

★ 3.1k FS 45 不推荐 13 天前
自动化与运维

Cloudflare One 迁移规划师

将 Zscaler、Palo Alto、传统 VPN、SWG 或 SASE 迁移规划为可验证的 Cloudflare One 方案。

★ 3.1k FS 58 推荐 13 天前
自动化与运维

Cloudflare One 零信任架构顾问

帮助代理设计、配置和排查 Cloudflare One 部署。

★ 3.1k FS 55 谨慎使用 13 天前
开发与工程

Turnstile 全链路接入助手

为现有表单完成 Cloudflare Turnstile 的前端嵌入、后端校验与验证。

★ 3.1k FS 54 谨慎使用 13 天前
开发与工程

网页性能审计

用 Chrome DevTools MCP 定位网页加载、核心体验指标和可访问性问题。

★ 3.1k FS 43 不推荐 13 天前

相关 Skills