Troubleshooting
What a failure means and what to do about it — including the ones that are working as intended.
4 articles
- A run or an item failed — what the reason meansEvery failure carries a class, and the class tells you whether retrying is sensible, pointless, or the very thing that would cost you money.
- The output is empty, or not what I asked forNine times in ten it is a placeholder that did not resolve, an image the step never received, or a prompt the model read more literally than you meant.
- Nothing happened — no run, no notificationMost silences are a guard doing its job: a schedule armed for its next slot, a payload that matched nothing, a mute you forgot about.
- A tool server or connection is not workingReconnect, check the allowlist, and remember that a tool reporting an error is treated as a real failure rather than something to retry blindly.