这篇文章适合想把 Cloudflare Agents SDK 0.14.0 直接接进项目的人：新版把 Browser Run、Codemode、Think 子代理和更稳的恢复链放到同一条运行路径里，能少写很多自定义编排。
- 01先读摘要，判断是否与你的场景相关。
- 02再看来源，保留继续查证的路径。
- 03最后看步骤、风险和可复用动作。
摘要：这篇文章适合想把 Cloudflare Agents SDK 0.14.0 直接接进项目的人：新版把 Browser Run、Codemode、Think 子代理和更稳的恢复链放到同一条运行路径里，能少写很多自定义编排。
适用场景
如果你的任务需要真实浏览器、需要把流程拆成多个角色，或者需要在 deploy、eviction、连接抖动之后继续跑下去，这版 Agents SDK 值得先看。它不是给一次性问答用的，而是给需要持续运行的 agent 工作流用的。
不适合的场景也很明确：只是调一个模型接口、补一个简单工具调用、没有状态和交接需求的任务，继续用更轻的 API 就够了，不必把编排层上得太重。
准备材料
- 一份能跑 Cloudflare Workers 的项目。
- 一个需要页面交互或多步骤执行的真实任务。
- 能接受审查和回退的运行边界。
- Cloudflare 官方 release note 和 Agents 文档。
Browser Run 该放在哪里
Browser Run 适合页面渲染后才出现的信息，比如 JavaScript 生成的 DOM、截图、console、网络请求状态。它比“先 fetch，再猜页面长什么样”稳得多，但也更贵，所以只在页面内容必须进入真实浏览器时用。
一个实用判断是：如果你在做内容审核、页面验证、前端调试或表单交互，Browser Run 往往是第一选择；如果纯文本接口已经够用，就别把问题升级成浏览器自动化。
Codemode 和 Think 子代理怎么分工
Codemode 更像是让 agent 围绕外部系统写 TypeScript，适合把系统动作做成可复用工具。Think 子代理则更适合拆解复杂任务，把“主控”和“专职执行者”分开，避免一个角色既做决策又做杂活。
最稳的结构通常是：主 agent 负责判断和收口，专职 agent 负责浏览器、检索或清洗数据。这样失败时你能知道是哪个环节出问题，而不是整条链路都混成一个黑箱。
可复制的落地顺序
- 先用 Browser Run 接住必须看真实页面的部分。
- 再把会触发风险的动作放进审批边界。
- 最后把长任务拆成主控 + 子代理，让每个角色只做一件事。
常见坑
最常见的问题是，把所有任务都塞给一个 agent，结果出错后很难复盘。另一种坑是，把能用 HTTP 解决的事硬塞进浏览器，成本会上得很快。还有一种是忽略恢复链，等 deploy 或连接短暂中断后才发现任务状态没法续上。
排错路径
先确认任务是否真的需要浏览器；再看是不是可以把交互拆成更小的可复用工具；最后检查恢复链和观测是否完整。如果一个步骤失败但没有明确的状态边界，先补边界，再补自动化。
可复制模板
模板可以很简单：主 agent 负责接单、判断、收口；Browser Run 负责真实页面；Think 子代理负责长任务；Codemode 负责把常用动作固化成 TypeScript 工具。
更新日期与维护建议
更新日期：2026-06-17。后续维护时，只要 Cloudflare 再发 release note，就重新检查 Browser Run、handoff、恢复链和工具调用边界，不要只看版本号本身。