用途:Cloudflare Agents SDK 是构建运行在 Cloudflare Workers + Durable Objects 上的 AI 自主智能体的基础设施层。每个智能体实例是全局唯一、有状态的微服务器,可运行数秒至数小时,并支持全球扩展至数百万实例。
主要能力:通过 WebSocket 与 Server-Sent Events 实时通信;内置 SQLite 状态持久化(每智能体最高 1GB);用延迟、指定日期或 cron 表达式调度任务;触发异步 Cloudflare Workflows;借助 Browser Rendering API + Puppeteer 浏览网页;用 Vectorize 与 Workers AI embeddings 实现 RAG;构建实现 Model Context Protocol 的 MCP 服务器;支持人工介入的审核与批准流程;通过 routeAgentRequest() 实现多智能体协作。
使用方式:可用模板创建项目:npm create cloudflare@latest my-agent -- --template=cloudflare/agents-starter --ts --git --deploy false;或在现有 Worker 中执行 npm install agents,再定义并导出继承 Agent 的类。wrangler.jsonc 中需配置 durable_objects.bindings,name 与 class_name 必须完全一致,并在首个迁移 tag(如 v1)的 new_sqlite_classes 中声明该类,否则无法启用 SQLite 存储;迁移 tag 不可复用。部署命令:npx wrangler@latest deploy。
适用场景:需要 WebSocket 双向通信、Durable Objects 有状态实例、多智能体协调、定时任务、人工审批或长时运行后台流程时使用。若只需基础聊天与 SSE 单向流式、无持久状态,建议直接用 Vercel AI SDK,代码更少、无需 Durable Objects 与迁移。
限制:Agents SDK 不提供 AI 推理、流式响应解析或模型供应商集成,需自行搭配 AI SDK(推荐)或 Workers AI;后者返回原始 SSE,需手动解析。资料未提供具体收费与价格信息。