Cloudflare Agents — Stateful Agents on Durable Objects

简介

Cloudflare Agents 是一个已通过 GitHub 仓库验证的现代 AI / 开发者工具，来源 cloudflare/agents，当前星标快照 4,898，许可证 MIT。适合：需要按用户、房间、工作流或 session 保留一个持久 agent，并希望全球部署但不想管服务器的应用。兼容：Cloudflare Workers、Durable Objects、Wrangler、实时通道、定时任务、MCP 工具。装机时间：15 minutes。当你需要的是可重复落地路径，而不是一次性 shell 片段时，用它。

操作模式

适配检查

接入循环

1. 先在一次性分支或 sandbox 项目里跑。
2. 记录 before / after 输出，让 reviewer 看见实际影响。
3. 加最小的 CI 或本地检查，防止同类问题回归。
4. 在仓库文档里写清 owner、升级命令和回滚命令。

推荐用法

把每个持久对话或任务建模成一个拥有自身状态的 agent。外部副作用放进显式工具，确保重试和唤醒行为可预测。

风险边界

扩容测试前先设计存储边界。只有单 agent 状态足够小且有生命周期清理时，百万级 idle agents 才可行。

推广检查表

• 进入 CI 前固定包版本或 release 版本。
• 凭据放进环境变量或平台 secret store。
• 指定一个 owner 负责升级和 breaking change 分流。
• 文档里写 API 或安装路径前，重新核验 GitHub 仓库。

FAQ

Q: 能直接上生产吗？ A: 仓库已验证存在：https://github.com/cloudflare/agents，GitHub 星标 4,898。第一次上线仍建议控制试点，先验证安装、回滚和 CI 行为。

Q: 为什么不用普通脚本？ A: 价值在可重复：有命名包、文档化命令、源仓库和可被团队 review 的最小验证路径。

Q: 第一步应该量什么？ A: 先量装机时间是否接近 15 minutes，它改了多少文件或任务，以及 CI 命令是否能在本地抓到同类问题。