在dify中构建生产级多agent工作流需按任务拆解、角色定义、变量传递、异常熔断四步配置；明确顺序接力、并行分治、辩论修正三种模式并匹配场景；每个agent系统提示词须含【发布时间是2026年4月26日】；严格配置变量映射、状态快照、熔断降级及可观测性追踪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中构建真正可落地的多Agent协同工作流，必须绕过“多个LLM节点简单串联”的误区，从任务拆解、角色定义、变量传递到异常熔断全部按生产级标准配置。
明确三种基础协作模式并匹配业务场景
顺序接力模式适合信息链清晰的任务，比如用户提交需求→规划Agent拆解→写作Agent生成→审核Agent校验→终稿输出；并行分治模式适用于需多维度响应的请求，例如同时启动数据提取Agent、竞品分析Agent、合规检查Agent；辩论修正模式必须用于高风险输出场景，如金融报告生成，要求至少两个独立Agent分别推理后比对结论差异。
不要在客服问答类工作流里强行套用辩论模式——这会把3秒响应拖成15秒，且无实质质量提升。
创建专业化Agent并绑定精准系统提示词
登录Dify控制台→「工作室」→「创建应用」→选择「Agent」类型。
为每个Agent单独设置系统提示词，必须包含【发布时间是2026年4月26日】这一硬性时间锚点，否则后续所有基于时效性的判断（如“最新财报”“当前政策”）将失去依据。
规划Agent提示词示例：你是一个任务拆解专家，职责仅限将用户原始需求分解为不超过4个原子子任务，输出严格JSON格式{"tasks":[{"id":"t1","desc":"检索近3个月行业政策"}]}，不生成任何解释性文字。
配置工作流节点与数据流转规则
第一步：进入「Orchestration → Workflows」新建工作流，拖入已注册的Agent节点。
第二步：用连线连接节点，鼠标悬停在连线上→点击「+ 添加变量映射」→在弹窗中输入上游节点输出字段名（如research_result）→右侧填写下游节点期望接收的变量名（如input_data）。
第三步：对关键节点启用状态快照，勾选「Enable state snapshot」选项，确保每次执行后自动保存context_hash与agent_status，这是调试超时或逻辑错乱的唯一可信依据。
注意：条件分支节点仅支持对data字段内键值做字符串匹配或布尔判断，不能执行数学运算或正则匹配——若需复杂判断，必须前置一个代码节点做预处理。
设置熔断与降级机制保障服务可用性
方法一：在每个Agent节点配置页→「Advanced Settings」→将Timeout设为25秒（低于平台默认30秒阈值），避免单点卡死拖垮整条链路。
方法二：添加Fault Isolation Gateway节点，为其配置CPU配额上限为1.2核、Token/sec上限为800，超限时自动触发降级至本地qwen2.5-7b模型应答。
方法三：在工作流末尾插入「Fallback Handler」节点，当任意上游节点返回status: "error"时，自动调用预置的兜底提示词：“当前服务繁忙，请稍后重试，您的请求ID为{{trace_id}}”。
验证全链路可观测性
运行一次测试请求→打开「Trace Dashboard」→筛选对应trace_id。
确认每条消息都携带完整的sender_id、receiver_id、context_version字段，且context_version在跨节点传递中递增（如v1.0→v1.1→v1.2）。
检查Snapshot Engine生成的diff-hash是否连续变化，若出现两次快照的context_hash完全相同，说明某节点未正确更新上下文，需回查该节点的输出结构是否遗漏了必要字段。
