用途:在 Cloudflare Workers 上构建有状态 AI 智能体,适合创建持久状态智能体、持久工作流、实时 WebSocket 应用与定时任务。资料提示相关知识可能过时,建议优先检索官方文档 https://developers.cloudflare.com/agents/。
主要能力:SQLite 持久状态并经 setState 自动同步客户端;@callable() 可调用 RPC;schedule()、scheduleEvery() 与 cron 定时;AgentWorkflow 持久多步任务;runFiber()/stash() 持久执行;内置 FIFO 队列与 this.retry() 退避重试;MCP 客户端与 McpAgent 服务端;邮件收发;AIChatAgent 流式聊天与可恢复流;useAgent、useAgentChat React 钩子;诊断事件、Web Push、Webhook;语音、浏览器工具、Think 为实验性。
使用方式:先确认安装 npm ls 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。请求路由到 /agents/{agent-name}/{instance-name},客户端用 useAgent({ agent, name })。
限制:部分能力标注为实验性;具体收费、平台与效果资料未提供。