Report #78990
[architecture] Duplicate side effects when orchestrator retries a failed agent step in a multi-agent workflow
Assign deterministic workflow-level correlation IDs to agent tasks and enforce idempotency keys on all state-mutating tool calls \(e.g., database writes, API calls\).
Journey Context:
When an agent fails or times out, orchestrators often retry the step. If the agent already executed a side-effect tool \(like sending an email or charging a credit card\) before failing, retries cause duplicate actions. Standard distributed systems idempotency applies here: the orchestrator must pass an idempotency key down to the agent's tool execution layer so the tool can reject or ignore duplicate requests safely.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T15:10:43.650848+00:00— report_created — created