天工ai（kimi）需先在dify配置v1系列模型api密钥并测试连接成功，再创建规划、检索、审核三个角色分明的agent，通过可视化工作流编排协同逻辑，并映射关键变量，最后经调试或curl验证端到端链路跑通。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让AI完成一个包含意图识别、知识检索、内容生成与合规校验的端到端任务，但单个Agent响应不准、容易遗漏步骤、出错后无法定位——这时必须用多Agent协同，而天工AI（Kimi）作为国产高性能大模型，正适合担当其中关键角色。
确认天工AI接入Dify的前提条件
登录Dify控制台，进入「设置」→「模型提供方」，检查是否已添加天工AI（Kimi）API密钥。若未配置，需先前往https://www.kimi.ai/settings/apikeys申请SK密钥，并在Dify中填写API Base URL为https://api.moonshot.cn/v1、模型名称填moonshot-v1-32k或moonshot-v1-128k。
【必须使用v1系列模型，旧版moonshot-v1-8k不支持function calling，会导致工具调用失败】
保存后点击「测试连接」，返回HTTP 200即表示接入成功。这一步不做，后续所有Agent都无法调用天工AI执行推理。
创建三个角色分明的Agent节点
进入「工作室」→「创建应用」→「Agent」，依次新建：
① 规划Agent：名称设为「Task Planner」，模型选「moonshot-v1-32k」，System Prompt写：“你是一个严谨的任务拆解专家。收到用户请求后，必须输出JSON格式的结构化子任务列表，每个子任务含type（intent_parse/kb_retrieve/content_gen/compliance_check）、desc、required_tools三项字段。禁止自由发挥。”
② 检索Agent：名称设为「KB Retriever」，模型同样选「moonshot-v1-32k」，启用「知识库检索」工具，绑定你已上传的PDF/Word文档知识库。注意：该Agent的User Prompt里必须包含变量{{planner_output}}，否则无法接收上游拆解结果。
③ 审核Agent：名称设为「Compliance Checker」，模型选「moonshot-v1-128k」（长上下文更利于全文校验），System Prompt强调：“逐句比对生成内容与知识库原文，标记所有事实性错误、政策违规点、模糊表述，输出带行号的修订建议。不许总结，只列问题。”
用可视化画布编排协同流程
点击「工作流」→「新建工作流」→「空白画布」，拖入Start节点，连接至Task Planner Agent → 添加IF分支节点 → 设置条件为planner_output.type == "intent_parse" → 分支1走KB Retriever → 分支2走Content Gen（可另建，此处略）→ KB Retriever输出接Compliance Checker输入。
关键操作：在KB Retriever与Compliance Checker之间的连线旁，点击齿轮图标 → 开启「变量映射」→ 将retrieved_docs映射为kb_context，将user_query映射为original_request。漏掉这步，审核Agent将看不到检索依据，直接胡说。
最后点击右上角「发布」，系统自动生成唯一Endpoint URL，这就是你的多Agent协同服务入口。
验证协同链路是否真正跑通
方法一：在画布右上角点击「调试」→ 输入测试文本“请根据《2026年数据安全合规白皮书》第4.2条，解释用户授权范围变更的操作路径”，观察各节点状态灯是否依次变绿，且Compliance Checker输出中出现类似“第4.2条原文为‘…’，当前生成内容中‘默认勾选’表述与原文‘须明示勾选’冲突”的精准反馈。
方法二：用curl调用已发布的Endpoint：
curl -X POST 'http://localhost:80/v1/chat-messages' \
-H 'Authorization: Bearer YOUR_DIFY_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"inputs": {}, "query": "请根据《2026年数据安全合规白皮书》第4.2条，解释用户授权范围变更的操作路径", "response_mode": "blocking"}'
看到返回JSON中包含"agent_responses"数组，且每个元素含"agent_name"与"output"字段，说明天工AI驱动的多Agent协同已就绪。
