用途:在 Cloudflare Workers 上使用 Agents SDK 构建 AI 智能体,适合创建有状态智能体、持久化工作流、实时 WebSocket 应用与定时任务。资料提示相关知识可能过时,建议优先检索官方文档 https://developers.cloudflare.com/agents/ 而非依赖预训练知识。
主要能力:SQLite 持久化状态并经 setState 自动同步客户端;@callable() 可调用 RPC 方法;schedule()、scheduleEvery() 与 cron 定时;AgentWorkflow 持久多步后台处理;runFiber()/stash() 持久执行;内置 FIFO 队列与 this.retry() 指数退避重试;MCP 客户端与 McpAgent 服务端;邮件收发;AIChatAgent 流式聊天与可恢复流;服务端主动消息;React hooks(useAgent、useAgentChat);诊断通道可观测性;Web Push 推送;Webhook 接收;实验性语音、浏览器工具与 Think。
使用方式:先确认安装 npm ls agents,未安装则 npm install agents;聊天智能体需 npm install agents @cloudflare/ai-chat ai @ai-sdk/react。在 wrangler.jsonc 配置 nodejs_compat、durable_objects 绑定与 migrations(new_sqlite_classes),每个智能体类需独立绑定与迁移条目。请求路由到 /agents/{agent-name}/{instance-name},客户端用 useAgent({ agent, name })。
限制与注意:不要在 tsconfig 启用 experimentalDecorators(会破坏 @callable);不要修改旧迁移,始终新增 tag;语音、浏览器工具、Think 为实验性;具体收费、价格与平台细节资料未提供。