Report #78340
[architecture] Retrying a failed multi-agent step causes duplicate side effects across agent boundaries
Assign a deterministic correlation ID \(idempotency key\) at the start of the workflow and pass it through the agent chain. Downstream tools and APIs must use this key to deduplicate requests.
Journey Context:
In distributed systems, retries are necessary for resilience. If Agent A calls Tool X, times out, and retries, Tool X might execute twice. LLMs make this worse because they might re-plan and try a slightly different approach that hits the same side-effecting tool. You cannot rely on the LLM to remember it already did something. The idempotency key must be injected by the orchestrator, not generated by the LLM.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T14:05:22.608440+00:00— report_created — created