用途:指导在 Cloudflare 平台上使用 Agents SDK 构建有状态、实时的 AI 智能体或聊天机器人,适用于需要持久状态、WebSocket 通信、定时任务或后台 AI 工作的场景。
主要能力:智能体基于 Durable Objects 运行在边缘,可跨请求与重连保持状态,通过 WebSocket 或 HTTP 通信,支持定时任务、工具调用与水平扩展(每个用户或会话独立实例)。提供状态读写(setState 持久化并同步到所有客户端)、内嵌 SQLite 存储、schedule 定时(延迟秒数、指定日期、cron 表达式)及 AIChatAgent 聊天智能体(自动历史、可恢复流式)。
使用方式:前置条件为启用 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。需配置 wrangler 的 ai 绑定、durable_objects 绑定与 migrations。客户端可用 React 的 useAgent 钩子或原生 WebSocket 连接 wss://my-agent.workers.dev/agents/MyAgent/session-id。部署用 npx wrangler deploy,日志用 wrangler tail。
限制:资料强调 Agents SDK 知识可能过时,任何构建任务应优先检索官方文档(Agents SDK docs、Cloudflare Agents docs、Workers docs)。具体收费、价格与效果暂未提供。