Cloudflare Agents 是什么？5.8K 星的边缘 Agent 平台，npm 周下载逼近 200 万（基础篇）
导语
前面做横向 Agent 平台横评时说过，大多数平台逃不出两条路：要么自己找台服务器部署，要么深度绑某朵云。Cloudflare 走的是第三条：Agent 直接跑在边缘网络上，每个 Agent 是一个独立实例，闲置自动休眠，来请求毫秒级唤醒。仓库 cloudflare/agents 2025 年 1 月才建，我 2026 年 10 月 12 日实测 GitHub API：5,812 星、771 fork、MIT 协议，最新一次 push 就是当天凌晨；npm 上 agents 包最新 0.28.0 版 10 月 9 日刚发，最近一周（10 月 4 日到 10 日）下载 1,970,469 次。星数不算炸裂，周下载近 200 万，这个反差本身就是它的真实状态：用的人比 star 的人多得多。
项目介绍
官方文档把三样东西分得很清楚：Workflow 是线性、确定性的执行路径；Copilot 是辅助人类的增强型 AI；Agent 是非线性、非确定性、能自己决定调哪个工具的执行体。Cloudflare Agents 不卖模型也不卖编排画布，它卖的是「有状态的执行环境」，本质是 Durable Object 的一层封装：每个 Agent 实例有独立状态、独立 SQLite 存储、独立生命周期，闲置休眠不计费，被请求、被定时任务或被 WebSocket 消息唤醒。
能力清单一口气列全（README 表格里就是这么排的）：
- 状态自动同步：setState 之后所有连着的前端实时收到，断线重连状态还在；
- @callable() 类型安全 RPC：Agent 方法前端像调本地函数一样调；
- 调度：一次性、周期、cron 三种；
- MCP 双向：既能当 MCP 服务端暴露工具，也能当客户端连外部 MCP 服务（HTTP/SSE/RPC 都行），和十个平台那篇 MCP 实测里的纯聊天壳完全两码事；
- Workflows：多步长任务，带人工审批（human-in-the-loop），卡点等你点头才继续；
- Code Mode：不让模型一次一个地调工具，改成让模型直接写一段 TypeScript 批量调用，代码跑在隔离 Worker 和虚拟文件系统里；
- 语音、邮件、浏览器 Agent、x402 支付都有官方包；
- 模型层：Workers AI 直连，第三方模型统一走 AI Gateway 代理，API 密钥不进你的 Worker，自带缓存、日志和 fallback 链，但模型 provider 本身还是 Beta。
上手
有 Cloudflare 账号就能开工，模板一条命令：
npm create cloudflare@latest -- --template cloudflare/agents-starter
已有项目则直接 npm install agents。核心代码就二十行：
import { Agent, routeAgentRequest, callable } from "agents";
export class CounterAgent extends Agent<Env, { count: number }> {
initialState = { count: 0 };
@callable()
increment() {
this.setState({ count: this.state.count + 1 });
return this.state.count;
}
}
export default {
async fetch(request: Request, env: Env) {
return (await routeAgentRequest(request, env)) ?? new Response("Not found", { status: 404 });
},
};
wrangler.jsonc 里给 Agent 类挂上 Durable Object 绑定和一条 new_sqlite_classes migration，注意免费计划只支持 SQLite 后端的 Durable Object，好在 Agents SDK 默认就是这么建的。wrangler deploy 部署完，前端一行 useAgent({ agent: "CounterAgent", onStateUpdate }) 就拿到实时状态，React 之外官方也有原生 JS 的 AgentClient。想接自己的 MCP 工具或换模型，官方文档 developers.cloudflare.com/agents 下的 MCP 和 Models 两章照抄即可。
实话
一、免费档是真能白嫖。Durable Objects 免费档每天 10 万次请求、13,000 GB-s 计算时长，个人小 Agent 绰绰有余；付费档每月含 100 万请求，超出 $0.15/百万。但有个坑：RPC 每次方法调用都算一次计费请求，高频小调用的场景下额度磨得飞快，写前端轮询的人尤其要留神。
二、锁定是全方位的。Agent 类、路由、状态同步、调度全绑在 Cloudflare 私有运行时上，迁走等于重写，跟 Dify、n8n 那种自托管路线是两个世界。想私有化部署的企业在这里没有选项，这是定位取舍不是缺陷。
三、迭代速度快到当背景噪音。0.27.0 版 10 月 7 日发、0.28.0 版 10 月 9 日发，两天一版；AI chat 模块刚被官方自己废弃、改推 @cloudflare/think，模型 provider 和 Pi harness 都还挂着 Beta 标。个人玩随便升，上生产必须锁版本，升级前先读 changelog。
四、心智门槛在「没有常驻进程」。Agent 是事件驱动加休眠的，长任务要么用内置 Workflows 拆步骤保状态，要么自己想清楚超时边界，这和 E2B 那种「租台沙箱电脑随便造」的模型不同，这里跑的是逻辑不是任意环境。习惯了常驻服务器的人第一周最容易在这里翻车。
五、适合谁：前后端已经放 Cloudflare 的人，以及做多实例 C 端 Agent 的人，每个用户一个 Agent 实例这种「一用户一进程」的奢侈品架构，在按请求计费的边缘模型下居然成了省钱方案。这是它最反直觉、也最吸引人的地方。
