用途：指导在 Cloudflare 上使用 Agents SDK 构建有状态、可持久化的 AI 智能体与聊天机器人，适用于需要实时交互、后台定时任务或 WebSocket 通信的场景。
主要能力：智能体基于 Durable Objects 运行在边缘，每个用户或会话拥有独立实例并可水平扩展；通过 onConnect、onMessage、onClose、onStart、onStateUpdate 等生命周期方法处理连接与消息；setState 会持久化状态并同步到所有已连接客户端，重连后状态可恢复；内置 SQLite，可用 this.sql 执行建表、插入与查询；支持 schedule 安排延迟、指定日期或 cron 表达式（如 "0 9 * * *"）的定时任务，并可 getSchedules、cancelSchedule；AIChatAgent 提供自动消息历史、可恢复流式响应与 saveMessages 持久化；客户端可用 agents/react 的 useAgent 钩子或原生 WebSocket 连接。
使用方式：前置条件为启用 Workers 的 Cloudflare 账户、Node.js 18+ 与包管理器、Wrangler CLI（npm install -g wrangler）。快速开始：npm create cloudflare@latest -- my-agent --template=cloudflare/agents-starter，然后 cd my-agent 与 npm start，本地运行于 http://localhost:8787。入口用 routeAgentRequest 路由到 /agents/:class/:name，客户端连接形如 wss://my-agent.workers.dev/agents/MyAgent/session-id。Wrangler 需配置 [ai] binding、[durable_objects] binding 与 migrations。部署用 npx wrangler deploy，日志用 wrangler tail。
限制：资料未提供收费、价格与性能数据；具体错误处理与高级模式需参考其 references 文档。