用途:Cloudflare Agents SDK 用于在 Cloudflare Workers 与 Durable Objects 上构建有状态、可自主运行的 AI 智能体。每个智能体实例都是全局唯一的有状态微服务器,可运行数秒至数小时,并支持扩展到大量独立实例。
主要能力:通过 WebSocket 与 Server-Sent Events 实时通信;使用内置 SQLite 数据库持久化状态(每智能体上限 1GB);按延迟、指定日期或 cron 表达式调度任务;触发异步 Cloudflare Workflows;借助 Browser Rendering API 与 Puppeteer 浏览网页;结合 Vectorize 向量数据库与 Workers AI 嵌入实现 RAG;构建实现 Model Context Protocol 的 MCP 服务器;支持人工审核与批准的 human-in-the-loop 模式。核心是继承 Agent 类,使用 this.setState 更新状态、this.sql 访问 SQL、this.env 读取绑定、this.name 获取实例名。
使用方式:可用模板创建项目:npm create cloudflare@latest my-agent -- --template=cloudflare/agents-starter --ts --git --deploy false;或在现有 Worker 中执行 npm install agents 后创建 Agent 类。需在 wrangler.jsonc 中配置 Durable Objects 绑定(name 与 class_name 必须一致)、migrations(首次迁移用 new_sqlite_classes 启用 SQLite,且标签不可复用),可选配置 ai、vectorize、browser、workflows、d1、r2 等绑定,再执行 npx wrangler@latest deploy。
适用场景:需要实时交互、状态持久化、定时任务、网页浏览、RAG 或 MCP 服务器的 AI 智能体。
限制:状态须可 JSON 序列化,不能含函数或循环引用;每个智能体数据库上限 1GB。资料未提供收费、价格及更多平台支持信息。