Three Agent Runs Passed. One Missing Handoff Broke the Workflow

说明与用途

在多代理客户支持工作流中，订单引用字段在代理之间的交接过程中丢失，导致隐式错误。通过添加显式会话元数据并使用 agent-inspect 进行追踪，发现并修复了该问题。

问题

A missing field (order reference) disappeared during handoff between agents, causing a failure that was not evident in individual agent runs but manifested in the overall workflow.

结果

Adding explicit correlation metadata and inspecting sessions with agent-inspect revealed that the order reference was omitted during handoff construction, allowing the issue to be fixed and preventing silent failures in multi-agent workflows.

工作流

• Extract refund request and order reference in triage agent
• Pass data to refund specialist via handoff
• Specialist checks for required fields; if missing, triggers escalation
• Escalation agent opens support ticket
• Use agent-inspect to group runs by sessionId and inspect handoffs
• Identify missing orderRef in specialist input
• Correct handoff payload construction
• Re-run workflow to confirm success

证据

The bug: orderRef disappears while building the handoff payload.

来源

agent-inspect refuses to manufacture a causal link from timestamps alone.

来源