Cloudflare Agents 0.12.4：长对话要配置恢复和路由重试

摘要

Agents SDK 0.12.4 改进聊天恢复、状态同步、Think durable submissions 和 routingRetry，适合长运行 AI 会话。

栏目: Agent
发布时间: 2026-05-25
来源: Cloudflare Changelog / Agents SDK v0.12.4 / 2026-05-13 https://developers.cloudflare.com/changelog/post/2026-05-13-agents-sdk-v0124/

这篇解决什么

长对话和工具调用会遇到刷新页面、WebSocket 断开、Durable Object 重启和路由失败。生产系统要把恢复当成默认路径。

Cloudflare Agents 0.12.4：长对话要配置恢复和路由重试流程图

适合谁

适合在 Cloudflare Workers 上构建客服 Agent、研究助理、审批机器人和工具调用系统的团队。

操作步骤

1. 确认升级到包含恢复改进的 Agents SDK
2. 决定客户端断开时是否取消服务端 turn
3. 为 getAgentByName 配置 routingRetry
4. 把长运行提交做成 durable submission
5. 记录恢复后的消息和 reasoning 状态
6. 用刷新、断网和 DO 重启做演练

可复制模板

Agent：
SDK 版本：
cancelOnClientAbort：
routingRetry：
持久提交：
恢复演练：
失败恢复动作：

Cloudflare Agents 0.12.4：长对话要配置恢复和路由重试检查清单

验收清单

SDK 已升级
断开策略明确
路由重试配置
长任务持久化
恢复演练通过

常见错误

只收藏产品更新，没有把它改成当天能执行的工作卡。
只看发布标题，没有确认账号权限、适用版本、成本和数据边界。
把 AI 自动化结果直接当结论，没有保留人工复核和失败恢复动作。
外部链接散落在聊天记录里，后续复查时找不到来源和日期。

30 分钟小样本

先选一个真实但低风险的任务。前 5 分钟写清输入材料和目标产物；中间 15 分钟按本文步骤执行一次；最后 10 分钟记录输出、人工修改量、失败点和下一次复用条件。小样本通过后，再扩展到团队模板或固定 SOP。

Cloudflare Agents 0.12.4：长对话要配置恢复和路由重试输出示意

复用方式

第一次执行时，把它当成个人操作卡；第二次执行时，把成功步骤整理成团队模板；第三次执行时，再判断是否值得升级成固定 SOP、工具页或培训材料。每次复查都要看官方页面是否改版、权限或价格是否变化、原来的示例是否还能跑通。

资料依据

Cloudflare Changelog / Agents SDK v0.12.4 / 2026-05-13