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

# errors • AI Agent SDK

> Structured exception hierarchy for PraisonAI SDK.

# errors

AI Agent

Structured exception hierarchy for PraisonAI SDK.

Provides uniform error semantics for consistent handling across:

* Multi-agent orchestration
* Tool execution
* LLM interactions
* Memory operations
* External integrations

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import errors
```

## Classes

> [card] [FailoverDecision](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/FailoverDecision.md)
>
> Discriminated struct for retry and failover decisions.

> [card] [IdleTimeoutBreaker](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/IdleTimeoutBreaker.md)
>
> Circuit breaker for consecutive idle-timeout failures.

> [card] [ErrorContextProtocol](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ErrorContextProtocol.md)
>
> Protocol for structured error context propagation.

> [card] [PraisonAIError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/PraisonAIError.md)
>
> Base error class with structured context for PraisonAI SDK.

> [card] [ToolExecutionError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ToolExecutionError.md)
>
> Tool execution failed.

> [card] [LLMError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/LLMError.md)
>
> LLM interaction failed.

> [card] [BudgetExceededError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/BudgetExceededError.md)
>
> Budget limits exceeded (tokens, time, etc).

> [card] [ValidationError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ValidationError.md)
>
> Input validation failed.

> [card] [NetworkError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/NetworkError.md)
>
> Network/external service error.

> [card] [HandoffError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/HandoffError.md)
>
> Agent handoff/delegation failed.

> [card] [PraisonAIConfigError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/PraisonAIConfigError.md)
>
> Configuration error (missing API keys, invalid settings, etc).

> [card] [HandoffCycleError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/HandoffCycleError.md)
>
> Circular handoff dependency detected.

> [card] [HandoffDepthError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/HandoffDepthError.md)
>
> Maximum handoff depth exceeded.

> [card] [HandoffTimeoutError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/HandoffTimeoutError.md)
>
> Handoff operation timed out.

> [card] [HandoffValidationError](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/HandoffValidationError.md)
>
> Raised when a typed handoff payload does not satisfy the declared schema.

### Constants

| Name | Value |
| - | - |
| `LEGACY_ERROR_CATEGORY_MAP` | `{'tool': 'unknown', 'llm': 'unknown', 'budget': 'billing', 'validation': 'format_error', 'network': 'unknown', 'handoff': 'unknown'}` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.