> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors and troubleshooting

> Diagnose Python agent failures, invalid tool data, and interrupted runs.

A failed result retains the active step, retry count, request ID, native response ID, provider metadata, and available gateway details.

Check that:

* `PHASEO_API_KEY` is available to the process
* tool IDs are unique
* approval decisions use exact call IDs
* paused state is saved before another request continues it
* validators do not perform side effects
* cancellation reaches network or storage work inside tools

Use lifecycle events for application telemetry and DevTools for local run inspection.

## Related

* [Lifecycle hooks](./agent-sdk-lifecycle-hooks)
* [DevTools](./agent-sdk-devtools)