Cloudflare Skills Agents SDK后台处理Durable Workflows、队列重试与人机协同完整指南【免费下载链接】skillsSkills for teaching agents how to build on Cloudflare.项目地址: https://gitcode.com/gh_mirrors/skills14/skills本文带你快速掌握 Cloudflare Agents SDK 的后台处理能力如何为 AI 智能体Agent搭建持久化工作流、内置队列与自动重试机制并实现人机协同审批。skills 仓库GitHub 加速计划 / skills14 / skills中的 agents-sdk 技能包正是教 AI 编程助手构建这类应用的知识库。 项目概览什么是 Agents SDK 后台处理Agents SDK 是 Cloudflare 用于构建有状态 AI 智能体的开发框架每个 Agent 运行在 Durable Object 上自带持久化状态、定时调度、RPC 调用和 WebSocket 连接。但真正让 Agent 从聊天机器人升级为可靠后台服务的是三大机制机制一句话理解适用场景Durable Workflows多步骤任务断点续跑自动重试长流程任务订单处理、数据管道队列 重试内置 FIFO 队列 指数退避重试顺序执行的后台小任务人机协同HITL任务暂停等待人工批准后继续高风险操作、需要 MCP 输入完整能力清单与核心 API 速查表见 skills/agents-sdk/SKILL.md。 Durable Workflows不怕中断的长流程为什么需要持久化工作流普通异步函数一旦运行环境被回收任务就丢了。AgentWorkflow把任务拆成多个步骤Step每步结果自动持久化——即使实例重启也能从断点恢复并独立重试。从 Agent 启动工作流分工很清晰Agent 负责交互式通信与状态管理Workflow 负责后台多步执行。当任务满足以下任一条件时就该引入 Workflow需要持久化的多步执行中途可能等待数小时甚至数天需要独立的重试策略需要等待外部审批才能继续启动方式一行搞定this.runWorkflow(ProcessingWorkflow, params)。工作流完成后可通过生命周期回调接收进度、完成、错误和自定义事件并把结果同步回 Agent 状态。设计检查清单 ✅编写工作流时记住三条规则外部副作用放在持久步骤内如发邮件、扣款被重试的操作要幂等重复执行结果一致恢复后需要的数据通过步骤返回值传递⚠️ 注意进度上报和客户端广播在重试时可能重复客户端要做去重。详细设计指引见 references/workflows.md。⏱️ 队列与重试可靠的后台任务调度内置 FIFO 队列每个 Agent 自带一个先入先出队列调用this.queue(handler, payload)即可投递后台任务。队列按顺序处理适合改完 A 再改 B这类有依赖关系的任务。指数退避重试配合this.retry(fn, { maxAttempts: 5 })失败操作会按指数退避 随机抖动自动重试避免大量请求同时撞向恢复中的依赖服务。常见陷阱 ⚠️重试会阻塞后续队列项——长恢复等待应改用定时调度this.schedule(60, task, payload)重试延迟会让 Durable Object 保持活跃——重试预算要考虑执行成本与延迟没有内置死信队列——重试预算耗尽后队列项直接移除需要审计的应用请自己显式记录失败选择性重试判断函数只在this.retry()上可用序列化队列/调度选项中不支持完整要点见 references/queue-retries.md定时任务模式见 references/state-scheduling.md。 人机协同让 AI 在关键时刻停下来问人两层审批机制人机协同在 Agents SDK 中有两个作用层级聊天层聊天 Agent 执行工具前可要求批准needsApproval支持批准/拒绝响应、客户端工具与自定义拒绝消息后台层持久化工作流可暂停等待人工审批或向用户收集 MCP 输入elicitation超时处理别被卡住的流程拖垮审批请求会超时——务必在超时后先行处理再执行被门禁的动作。另外要区分审批响应与客户端工具输出返回自定义工具错误时检查是否需要显式继续对话。实践建议任务暂停等待批准时可借助服务端消息能力saveMessageswaitUntilStable主动向用户推送审批提醒细节见 references/server-driven-messages.md 与 references/human-in-the-loop.md。 如何选择工作流、纤程还是队列需求推荐方案长流程、多步骤、需自动重试Durable Workflows工作需扛住 Durable Object 驱逐持久化纤程runFiberstash检查点 onFiberRecovered恢复钩子顺序执行的小任务内置队列queue()长时间等待后再执行定时调度schedule/scheduleEvery 补充纤程Fiber的检查点stash是整体替换而非合并且恢复时不会还原原函数体——你需要在恢复钩子里根据检查点数据重新推导下一步。对于需要自动重试的长管道直接用 Workflows 更省心。详见 references/durable-execution.md。 关键文件导航技能总览与核心 API 速查skills/agents-sdk/SKILL.md工作流集成指南skills/agents-sdk/references/workflows.md持久化执行纤程skills/agents-sdk/references/durable-execution.md队列与重试skills/agents-sdk/references/queue-retries.md人机协同skills/agents-sdk/references/human-in-the-loop.md状态与调度skills/agents-sdk/references/state-scheduling.md项目安装与技能列表README.md✅ 总结Cloudflare Agents SDK 的后台处理体系可以概括为用 Workflows 跑长流程用队列 重试保证任务不丢用人机协同守住安全底线。掌握这三者你的 AI 智能体就能从能对话进化到能可靠地干活。建议从 skills/agents-sdk/SKILL.md 的能力清单出发按需加载对应的参考文档快速上手。【免费下载链接】skillsSkills for teaching agents how to build on Cloudflare.项目地址: https://gitcode.com/gh_mirrors/skills14/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Cloudflare Skills Agents SDK后台处理：Durable Workflows、队列重试与人机协同完整指南
Cloudflare Skills Agents SDK后台处理Durable Workflows、队列重试与人机协同完整指南【免费下载链接】skillsSkills for teaching agents how to build on Cloudflare.项目地址: https://gitcode.com/gh_mirrors/skills14/skills本文带你快速掌握 Cloudflare Agents SDK 的后台处理能力如何为 AI 智能体Agent搭建持久化工作流、内置队列与自动重试机制并实现人机协同审批。skills 仓库GitHub 加速计划 / skills14 / skills中的 agents-sdk 技能包正是教 AI 编程助手构建这类应用的知识库。 项目概览什么是 Agents SDK 后台处理Agents SDK 是 Cloudflare 用于构建有状态 AI 智能体的开发框架每个 Agent 运行在 Durable Object 上自带持久化状态、定时调度、RPC 调用和 WebSocket 连接。但真正让 Agent 从聊天机器人升级为可靠后台服务的是三大机制机制一句话理解适用场景Durable Workflows多步骤任务断点续跑自动重试长流程任务订单处理、数据管道队列 重试内置 FIFO 队列 指数退避重试顺序执行的后台小任务人机协同HITL任务暂停等待人工批准后继续高风险操作、需要 MCP 输入完整能力清单与核心 API 速查表见 skills/agents-sdk/SKILL.md。 Durable Workflows不怕中断的长流程为什么需要持久化工作流普通异步函数一旦运行环境被回收任务就丢了。AgentWorkflow把任务拆成多个步骤Step每步结果自动持久化——即使实例重启也能从断点恢复并独立重试。从 Agent 启动工作流分工很清晰Agent 负责交互式通信与状态管理Workflow 负责后台多步执行。当任务满足以下任一条件时就该引入 Workflow需要持久化的多步执行中途可能等待数小时甚至数天需要独立的重试策略需要等待外部审批才能继续启动方式一行搞定this.runWorkflow(ProcessingWorkflow, params)。工作流完成后可通过生命周期回调接收进度、完成、错误和自定义事件并把结果同步回 Agent 状态。设计检查清单 ✅编写工作流时记住三条规则外部副作用放在持久步骤内如发邮件、扣款被重试的操作要幂等重复执行结果一致恢复后需要的数据通过步骤返回值传递⚠️ 注意进度上报和客户端广播在重试时可能重复客户端要做去重。详细设计指引见 references/workflows.md。⏱️ 队列与重试可靠的后台任务调度内置 FIFO 队列每个 Agent 自带一个先入先出队列调用this.queue(handler, payload)即可投递后台任务。队列按顺序处理适合改完 A 再改 B这类有依赖关系的任务。指数退避重试配合this.retry(fn, { maxAttempts: 5 })失败操作会按指数退避 随机抖动自动重试避免大量请求同时撞向恢复中的依赖服务。常见陷阱 ⚠️重试会阻塞后续队列项——长恢复等待应改用定时调度this.schedule(60, task, payload)重试延迟会让 Durable Object 保持活跃——重试预算要考虑执行成本与延迟没有内置死信队列——重试预算耗尽后队列项直接移除需要审计的应用请自己显式记录失败选择性重试判断函数只在this.retry()上可用序列化队列/调度选项中不支持完整要点见 references/queue-retries.md定时任务模式见 references/state-scheduling.md。 人机协同让 AI 在关键时刻停下来问人两层审批机制人机协同在 Agents SDK 中有两个作用层级聊天层聊天 Agent 执行工具前可要求批准needsApproval支持批准/拒绝响应、客户端工具与自定义拒绝消息后台层持久化工作流可暂停等待人工审批或向用户收集 MCP 输入elicitation超时处理别被卡住的流程拖垮审批请求会超时——务必在超时后先行处理再执行被门禁的动作。另外要区分审批响应与客户端工具输出返回自定义工具错误时检查是否需要显式继续对话。实践建议任务暂停等待批准时可借助服务端消息能力saveMessageswaitUntilStable主动向用户推送审批提醒细节见 references/server-driven-messages.md 与 references/human-in-the-loop.md。 如何选择工作流、纤程还是队列需求推荐方案长流程、多步骤、需自动重试Durable Workflows工作需扛住 Durable Object 驱逐持久化纤程runFiberstash检查点 onFiberRecovered恢复钩子顺序执行的小任务内置队列queue()长时间等待后再执行定时调度schedule/scheduleEvery 补充纤程Fiber的检查点stash是整体替换而非合并且恢复时不会还原原函数体——你需要在恢复钩子里根据检查点数据重新推导下一步。对于需要自动重试的长管道直接用 Workflows 更省心。详见 references/durable-execution.md。 关键文件导航技能总览与核心 API 速查skills/agents-sdk/SKILL.md工作流集成指南skills/agents-sdk/references/workflows.md持久化执行纤程skills/agents-sdk/references/durable-execution.md队列与重试skills/agents-sdk/references/queue-retries.md人机协同skills/agents-sdk/references/human-in-the-loop.md状态与调度skills/agents-sdk/references/state-scheduling.md项目安装与技能列表README.md✅ 总结Cloudflare Agents SDK 的后台处理体系可以概括为用 Workflows 跑长流程用队列 重试保证任务不丢用人机协同守住安全底线。掌握这三者你的 AI 智能体就能从能对话进化到能可靠地干活。建议从 skills/agents-sdk/SKILL.md 的能力清单出发按需加载对应的参考文档快速上手。【免费下载链接】skillsSkills for teaching agents how to build on Cloudflare.项目地址: https://gitcode.com/gh_mirrors/skills14/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考