用途:Cloudflare Agents SDK 用于在 Workers 上构建、讲解或调试有状态智能体应用,涵盖持久状态、RPC、调度、工作流、聊天、MCP、邮件和 Webhook 等能力。
主要能力:基于 SQLite 的持久状态并通过 setState 自动同步到客户端;@callable() 方法经 WebSocket 调用;schedule()、scheduleEvery() 与 cron 定时任务;通过 AgentWorkflow 运行持久多步工作流;runFiber()/stash() 实现可在 Durable Object 驱逐后存活的执行;内置 FIFO 队列 queue() 与 this.retry() 指数退避重试;MCP 客户端与服务端集成;邮件接收与安全回复;AIChatAgent 支持可恢复流、消息持久化和工具;服务端主动消息、React hooks、可观测性、Web Push 与 Webhook;语音和浏览器工具为实验性。
使用方式:在项目中安装 agents(npm install agents);聊天智能体需再装 @cloudflare/ai-chat、ai、@ai-sdk/react。Wrangler 配置需开启 nodejs_compat,为每个智能体类配置 Durable Object 绑定与 exports,使用 sqlite 存储;不要启用 experimentalDecorators。请求路由到 /agents/{agent-name}/{instance-name},也可用 getAgentByName 自定义路由。先检查清单、锁文件、已安装版本和包管理器,再按项目策略安装。
适用场景:需要长连接、持久状态、定时与后台任务的智能体,聊天与工具调用、MCP 集成、多步工作流、邮件或 Webhook 处理。
限制:语音、浏览器工具、Think、Code Mode 等标注为实验性;文档可能过时,任务前应优先查阅官方文档;具体收费、部署价格与效果资料暂未提供。