Cloudflare Durable execution：长任务 Agent 先用 Fiber 做恢复点

这篇解决什么

长任务 Agent 可能在外部 API 慢、任务排队或 Durable Object 被回收时中断。没有恢复点，就只能重跑整段工作。

适合谁

适合构建研究任务、批量处理、后台生成、审批流和长时间工具调用的 Workers 开发者。

操作步骤

1. 把长任务拆成可恢复阶段
2. 为每个阶段定义 checkpoint 数据
3. 用 startFiber 接收后台任务并返回任务 ID
4. 所有外部调用加幂等键
5. 提供 status、cancel 和 cleanup 操作
6. 在 wrangler dev 和生产环境分别演练恢复

可复制模板

任务名：
阶段：
checkpoint：
幂等键：
状态查询：
取消动作：
恢复演练：

验收清单

• 阶段可恢复
• checkpoint 完整
• 外部调用幂等
• 可查询可取消
• 恢复演练通过

常见错误

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

30 分钟小样本

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

复用方式

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

资料依据

• Cloudflare Agents Docs / Durable execution / 2026-05

标签