编排器排障

常见问题

• 为什么这次 turn 没走到 AI 节点
• 为什么工具调用被跳过或拦截
• 为什么同一个 Agent 在线上和评测里表现不同
• 为什么最终回答没有使用预期的模型角色

排查顺序

1. 确认 session 当前状态
2. 确认 orchestrator_key 与 agent 类型
3. 查看本次运行是否带了 model_routing_config、mcp_runtime_config、response_grounding_config
4. 再看 RAG provenance、MCP 审计和模型调用阶段

经验规则

• 顶层图简单不代表链路简单，很多问题发生在 ai_node 内部阶段
• 同一输入契约会被多场景复用，因此要区分“运行时 bug”和“调用场景差异”