Report #84488
[architecture] Duplicate side effects when orchestrator retries a failed agent step
Assign a deterministic idempotency key \(derived from the workflow run ID \+ step ID\) to every state-mutating tool call passed across agent boundaries, and enforce idempotency on the API/tool receiving end.
Journey Context:
Multi-agent workflows often retry a step if an agent crashes or times out. If Agent A tells Agent B to 'send email', a retry sends two emails. Agents themselves are stateless and unaware of prior executions; idempotency must be enforced at the tool/API layer via keys. This is a standard distributed systems pattern adapted for non-deterministic LLM tool calling.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T00:24:07.278855+00:00— report_created — created