Skip to content

xtr_ai.exception

Every error this library raises.

All of them derive from :class:AiError, so one except catches anything the integration can go wrong with. pydantic-ai's own errors — a model that failed, a run that was cancelled — are raised as pydantic-ai raises them.

AiError

Bases: Exception

Base class for every error raised by this library.

Catch this to handle anything the integration can go wrong with; catch a subclass to handle one cause. Each subclass carries what a caller needs as typed attributes and composes its own message from them.

InvalidConfigurationError

Bases: AiError, ValueError

A platform, agent or conversation store configuration that cannot be used.

Raised while the container builds, or when a class is built by hand with a value it cannot use. The message names the entry at fault.

PlatformUnavailableError

PlatformUnavailableError(platform: str, reason: str)

Bases: AiError

A platform that is not configured, or cannot be built.

Raised the first time a run needs the platform — never while the container builds — so the console runs without any key. The message names the platform and, where one is missing, the environment variable or the package extra; it never carries a secret's value.

Attributes:

  • platform (str) –

    The platform asked for.

  • reason (str) –

    Why it cannot be used.

Name the platform and why it cannot be used.