Why did my agent run fail?
Understand why an agent run ended in an error, where to look for the cause, and the quickest ways to get it running again.
Last updated July 14, 2026
When an agent run doesn't finish the way you expected, Praxivara keeps a full record so you can see exactly what happened. Most failures come down to a few common causes, and nearly all of them are quick to fix.
Start in your agent's Errors tab. Every failed run is logged there with a plain-language reason, and its full step-by-step trace lives in Activity.
Common reasons a run fails
- A disconnected integration. If the agent needs Gmail, Slack, a CRM, or another tool that lost its connection, the step can't run. This is the most frequent cause.
- Not enough credits. Runs stop when your workspace balance reaches zero.
- A missing secret or file. If a skill expects an API key, password, or reference file that isn't set, the step can't complete.
- A trigger fired with unexpected data. An incoming email or webhook that doesn't match what the agent was built to handle can send it off course.
- An external service was down or slow. A connected tool timed out or returned an error of its own.
How to diagnose it
Go to your agent's Errors tab and select the run. You'll see the reason and which step stopped.
Activity shows each tool call, its inputs, and the response. The last successful step tells you where things broke.
Reconnect the integration, top up credits, or add the missing secret or file, depending on what the trace shows.
Use the agent's Test option, or wait for the next scheduled or triggered run, and check that it lands in Deliveries.
When the build itself is the problem
If a run fails the same way every time, the issue may be in how the agent is set up rather than a one-off glitch. Open the AI builder and describe what went wrong in plain language. It can adjust the Blueprint, tighten a Skill's instructions, or add a Tool the workflow was missing. Your earlier versions are kept in version history, so you can always compare or roll back.