用途：指导在 Cloudflare 上使用 Agents SDK 构建有状态、可持久化的 AI 智能体与聊天机器人，适用于需要实时交互、定时任务或后台 AI 工作的场景。
主要能力：智能体通过 Durable Objects 在边缘运行，跨请求与重连保持状态；支持 WebSocket 或 HTTP 通信；每个用户或会话拥有独立实例并可水平扩展。核心生命周期包括 onStart、onConnect、onMessage、onClose、onStateUpdate。setState 会持久化并同步到所有已连接客户端，另可用内置 SQLite 执行复杂查询。支持 schedule 定时任务，可传秒数、具体日期或 cron 表达式，并可用 getSchedules、cancelSchedule 管理。AIChatAgent 提供自动消息历史、可恢复流式响应与 saveMessages 持久化。客户端可用 React 的 useAgent 钩子或原生 WebSocket 接入。
使用方式：前置条件为启用 Workers 的 Cloudflare 账户、Node.js 18+ 与 npm/pnpm/yarn、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 绑定、durable_objects 绑定与 migrations。部署用 npx wrangler deploy，日志用 wrangler tail。
限制：资料未提供收费、价格与性能数据；高级模式与故障排查见其 references 目录文档。