Praison AI

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
from praisonaiagents import errors

Classes

FailoverDecision

Discriminated struct for retry and failover decisions.

 IdleTimeoutBreaker

Circuit breaker for consecutive idle-timeout failures.

 ErrorContextProtocol

Protocol for structured error context propagation.

 PraisonAIError

Base error class with structured context for PraisonAI SDK.

 ToolExecutionError

Tool execution failed.

 LLMError

LLM interaction failed.

 BudgetExceededError

Budget limits exceeded (tokens, time, etc).

 ValidationError

Input validation failed.

 NetworkError

Network/external service error.

 HandoffError

Agent handoff/delegation failed.

 PraisonAIConfigError

Configuration error (missing API keys, invalid settings, etc).

 HandoffCycleError

Circular handoff dependency detected.

 HandoffDepthError

Maximum handoff depth exceeded.

 HandoffTimeoutError

Handoff operation timed out.

 HandoffValidationError

Raised when a typed handoff payload does not satisfy the declared schema.

Constants

NameValue
LEGACY_ERROR_CATEGORY_MAP{'tool': 'unknown', 'llm': 'unknown', 'budget': 'billing', 'validation': 'format_error', 'network': 'unknown', 'handoff': 'unknown'}