Dify工作流中30秒以上AI文档解析任务必须启用异步模式并配置轮询：需在工具节点勾选“启用异步执行”，后端提供/start（返回task_id与status:"processing"）和/result/{task_id}（支持轮询）两个接口，且域名协议一致；轮询参数设为间隔3秒、最大12次、单次超时8秒；返回status须为"completed"以确保兼容。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Dify工作流中触发一个需30秒以上完成的AI文档解析任务时，若未正确配置异步处理与轮询等待机制，工作流会卡在工具节点超时失败，无法进入后续分支判断或结果输出环节。
确认工具已声明为异步调用模式
进入Dify后台 → 工作流编辑页 → 点击对应自定义工具节点 → 在「高级设置」中勾选「启用异步执行」。该选项决定Dify是否将后续流程切换为轮询模式，【未勾选则全程按同步阻塞处理，哪怕后端返回task_id也无效】。
保存前检查右侧预览区是否显示“状态：异步”，否则配置未生效。
后端服务必须提供两个标准接口
方法一：启动任务接口（POST）
路径如 /v1/async/parse/start，响应体必须包含 task_id 和 status: "processing" 字段，且HTTP状态码为200。Dify仅凭这两个字段识别为有效异步入口。
方法二：状态查询接口（GET）
路径如 /v1/async/parse/result/{task_id}，必须能根据URL中的task_id返回当前状态。Dify默认每3秒轮询一次，最多尝试10次。
注意：两个接口的域名、协议、证书必须完全一致，跨域或跳转会导致轮询中断。
配置轮询行为参数
第一步：在工具节点的「请求参数」区域展开「轮询设置」
第二步：填写三项关键值：
① 轮询间隔（秒）：建议填 3（过短易被限流，过长拖慢整体流程）
② 最大重试次数：填 12（覆盖典型大模型推理+后处理的99%耗时场景）
③ 单次请求超时（秒）：填 8（必须小于轮询间隔，否则下次轮询会堆积）
这三者共同构成Dify客户端侧的等待策略，不依赖后端任何配置。若后端实际执行时间超过「间隔 × 次数」，Dify将主动终止并标记节点失败。
验证轮询是否真实触发
打开浏览器开发者工具 → 切换到Network标签 → 运行工作流 → 筛选XHR请求 → 查看是否持续出现形如 /result/abc123 的GET请求，且响应体含 "status": "processing"。
若只出现一次start请求，后续无轮询，则说明工具节点未启用异步模式，或后端返回格式不符合Dify解析规则。
处理completed以外的状态返回
当查询接口返回 status: "failed" 时，Dify自动中断当前工作流，并将 error 字段内容注入错误上下文供后续条件分支捕获。
返回 status: "succeeded" 是Dify官方文档使用的别名，等同于 "completed"，但部分旧版SDK仍要求严格匹配后者，【建议后端统一返回 completed，避免兼容性问题】。
