用途：指导在 Cloudflare 平台上使用 Agents SDK 构建有状态、实时的 AI 智能体与聊天机器人。强调 SDK 知识可能过时，建议优先检索官方来源：Agents SDK 文档（https://github.com/cloudflare/agents/tree/main/docs）、Cloudflare Agents 文档（https://developers.cloudflare.com/agents/）和 Workers 文档。
适用场景：构建 AI 智能体或聊天机器人；需要带状态、实时的 AI 交互；询问 Cloudflare Agents SDK；需要定时任务或后台 AI 工作；需要基于 WebSocket 的 AI 通信。
前提条件：启用 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。
核心能力：Agent 是基于 Durable Objects 的有状态持久化服务，跨请求和重连保持状态，通过 WebSocket 或 HTTP 通信，可调度任务与调用工具，按用户/会话独立实例横向扩展。生命周期包括 onConnect、onMessage、onClose、onStateUpdate、onStart 等钩子。使用 setState 持久化并向所有连接客户端同步状态；可用内嵌 SQLite（this.sql）做复杂查询。支持 schedule 延迟、指定日期及 cron 表达式执行定时任务，并可 getSchedules、cancelSchedule。聊天场景可继承 AIChatAgent，具备自动消息历史、可恢复流式传输和 saveMessages 持久化。客户端可用 React 的 useAgent 钩子或原生 WebSocket 连接 wss://my-agent.workers.dev/agents/MyAgent/session-id。
配置与部署：wrangler.toml 需设置 name、main、compatibility_date，并配置 [ai] 绑定、[durable_objects] 绑定及 [[migrations]]。部署用 npx wrangler deploy，日志用 wrangler tail。
限制：需具备 Cloudflare 账户与 Workers 环境；文中未提供具体收费、价格或性能数据；references 中工具调用、多智能体编排、RAG 等高级模式细节暂未提供。