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 ¶
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:
Name the platform and why it cannot be used.