Back to runbook library
troubleshooting
Debugging Agent Graph Deadlocks
Break and prevent execution loops or unreachable states in complex multi-step agent workflows.
Estimated time
20 min
Severity
high
Procedure
1
Inspect the execution trace
Find the last successful step transition and identify the nodes or conditions that repeated unexpectedly.
2
Review branch and retry rules
Check for circular transitions, missing terminal states, or retry settings that keep reenqueuing work.
3
Patch and replay with fixtures
Test the corrected graph using sandbox fixtures before re-enabling affected production automations.