Agents SDK 聊天恢复增强：长对话先设检查点

这篇解决什么

长对话中断、Durable Object 重启或工具调用跨越恢复窗口时，用户最怕丢上下文或重复执行副作用操作。

适合谁

适合构建客服 Agent、研究助手、聊天机器人和长任务工作台的 Workers 开发者。

操作步骤

1. 把会话拆成用户输入、工具调用、流式输出和最终状态
2. 为每轮写入恢复 checkpoint
3. 把有副作用的工具调用加幂等键
4. 设置 routingRetry 处理临时路由失败
5. 演练 Durable Object 重启后的恢复
6. 把恢复失败样例输出到运维队列

可复制模板

会话 ID：
轮次：
checkpoint：
工具调用：
幂等键：
routingRetry：
恢复演练：

验收清单

• checkpoint 已落库
• 工具调用幂等
• 路由重试已配置
• 重启演练通过
• 失败样例可追踪

常见错误

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

30 分钟小样本

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

复用方式

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

资料依据

• Cloudflare Changelog / Agents SDK v0.12.4: chat recovery, routing retries, durable Think submissions, and Voice connection control / 2026-05-13

标签