Troubleshooting Workflows
A symptom → cause → fix catalog for the most common workflow mistakes — empty outputs, broken mappings, agent loops, and draft confusion.
Almost every "broken" workflow falls into one of the patterns below. Before anything else, run the workflow in the Test panel and find the first failing or surprising node in the trace — its error, input, and the output of the node just upstream identify the pattern in seconds.
Empty or wrong outputs
Wiring and canvas mistakes
Versions, drafts, and deployments
Retrieval and agents
Still stuck?
Validation errors at Save time appear as a red banner in the offending node's inspector naming the invalid fields, and nodes with problems are outlined in red on the canvas. If a run misbehaves only in production, pull the run's trace from the App's Traces tab — it reads identically to a test trace. See Monitoring, history and traces.