Errors

Agent error types.

All provider-specific exceptions are normalized to these types.

exception agent.errors.AgentError(message, *, raw=None)[source]

Bases: Exception

Base exception for all Agent errors.

Parameters:
exception agent.errors.AuthenticationError(message, *, raw=None)[source]

Bases: AgentError

Raised when API authentication fails.

Parameters:
exception agent.errors.ProviderError(message, *, provider=None, status_code=None, raw=None)[source]

Bases: AgentError

Raised when the provider returns an error.

Parameters:
exception agent.errors.RateLimitError(message, *, provider=None, retry_after=None, raw=None)[source]

Bases: ProviderError

Raised when rate limited by the provider.

Parameters:
exception agent.errors.RequestTimeoutError(message, *, timeout=None, raw=None)[source]

Bases: AgentError

Raised when a request times out.

Parameters:
agent.errors.TimeoutError

alias of RequestTimeoutError

exception agent.errors.ToolExecutionError(message, *, tool_name=None, raw=None)[source]

Bases: AgentError

Raised when a tool fails to execute.

Parameters:
exception agent.errors.SchemaValidationError(message, *, schema=None, output=None, raw=None)[source]

Bases: AgentError

Raised when structured output fails validation.

Parameters:
exception agent.errors.UnsupportedFeatureError(message, *, feature=None, provider=None, raw=None)[source]

Bases: AgentError

Raised when a requested feature is not supported by the provider.

Parameters:
exception agent.errors.RoutingError(message, *, errors=None, raw=None)[source]

Bases: AgentError

Raised when routing fails across all configured agents.

Parameters: