Cloudflare Agents SDK 技能用于构建、调试或审查使用 agents 包的 Cloudflare Agents SDK 应用。资料提示，对 Agents SDK 的了解可能已过时，因此任何 Agents SDK 任务都应优先检索官方文档，而不是依赖预训练知识。
用途与适用场景 该技能面向需要在 Cloudflare Workers 上开发智能体应用、聊天应用或需要持久状态、RPC、调度、工作流、MCP 集成、邮件处理等能力的开发者。可用于项目初始化、加入现有项目、配置、调试与代码审查等场景。
主要能力 根据资料，Agents SDK 提供持久状态（基于 SQLite，通过 setState 自动同步到客户端）、可调用 RPC（@callable() 方法通过 WebSocket 调用）、调度（一次性、scheduleEvery 循环、cron 任务）、工作流（通过 AgentWorkflow 执行持久多步后台处理）、持久执行（runFiber()/stash() 可在 DO 驱逐后继续）、内置 FIFO 队列（queue() 带重试）、重试（this.retry() 带指数退避与抖动）、MCP 集成（连接 MCP 服务器或用 createMcpHandler 自建）、邮件处理、流式聊天（AIChatAgent，可恢复流、消息持久化、工具）、服务器驱动消息（saveMessages、waitUntilStable 主动发起对话回合）、React hooks（useAgent、useAgentChat）、可观测性（diagnostics_channel 事件）、推送通知（Web Push + VAPID）、Webhook 接收与验证，以及实验性语音（@cloudflare/voice 的 STT/TTS）、浏览器工具（agents/browser 的 CDP 浏览）和 Think（@cloudflare/think 的高层聊天代理）。
使用方式 首先验证安装：npm ls agents 应显示 agents 包；未安装则运行 npm install agents；聊天代理需 npm install agents @cloudflare/ai-chat ai @ai-sdk/react。Wrangler 配置需设置 nodejs_compat 兼容标志、durable_objects 绑定以及 migrations（new_sqlite_classes）。注意事项包括：不要在 tsconfig 中启用 experimentalDecorators（会破坏 @callable）；不要编辑旧迁移，始终新增标签；每个 agent 类需要独立的 DO 绑定与迁移条目；若用 Workers AI 需添加 "ai": { "binding": "AI" }。
路由与核心 API
请求路由到 /agents/{agent-name}/{instance-name}，例如 Counter 类对应 /agents/counter/user-123。客户端使用 useAgent({ agent: "Counter", name: "user-123" })。自定义路由可用 getAgentByName(env.MyAgent, "instance-id") 再调用 agent.fetch(request)。核心 API 包括：读取状态 this.state.count、写入状态 this.setState({...})、SQL 查询 this.sql...、延迟调度 await this.schedule(60, "task", payload)、cron 调度 await this.schedule("0 * * * *", "task", payload)、间隔调度 await this.scheduleEvery(30, "poll")、RPC 方法 @callable()、流式 RPC @callable({ streaming: true })、启动工作流 await this.runWorkflow("ProcessingWorkflow", params)、持久 fiber await this.runFiber("name", async (ctx) => {...})、入队 this.queue("handler", payload)、退避重试 await this.retry(fn, { maxAttempts: 5 })、广播 this.broadcast(message)、获取连接 this.getConnections(tag?)。
参考文档 资料列出大量参考主题：核心部分包括状态与调度、可调用方法、路由、配置；聊天与流式部分包括流式聊天、客户端 SDK、服务器驱动消息、人机协同；后台处理包括工作流、持久执行、队列与重试；集成包括 MCP、邮件、Webhook 与推送、可观测性；实验性包括 Think、语音、代码模式、浏览器工具。每个主题对应具体文档 URL，用于检索最新信息。
限制 资料未提供该技能的具体收费、价格、平台支持范围、性能效果或完整的使用步骤；这些内容暂未提供。部分能力标记为实验性（语音、浏览器工具、Think），使用时需注意。