Three Agent Runs Passed. One Missing Handoff Broke the Workflow

Описание и применение

В многокомпонентном процессе поддержки клиентского запроса потеряно поле orderRef при передаче между агентами, что привело к неявной ошибке. Добавление явных метаданных сессии и использование 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.

Источник