enterprise_ai.errors
Source : sdks/python/src/enterprise_ai/errors.py. Retour à l'index de la référence du SDK Python.
Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.
Classe EaiError
Erreur de base du SDK. code est le code machine stable renvoyé par l'API.
Exception
Attributs :
| Nom | Type | Requis | Description |
|---|---|---|---|
code | oui | Code machine stable de l'erreur, par exemple policy_denied. | |
details | oui | Détails structurés de l'erreur, secrets masqués (un dictionnaire, vide s'il n'y en a pas). | |
locale | oui | Langue résolue du message, par exemple en. | |
message | oui | Message lisible dans la langue choisie. | |
messages | oui | Message par langue tel qu'envoyé par l'API (message_i18n), vide s'il est absent. | |
request_id | oui | Identifiant de la requête en échec, ou None. | |
status | oui | Statut HTTP de la réponse, ou None si l'erreur est locale. |
Constructeur EaiError
EaiError(message: str | None = None, code: str | None = None, status: int | None = None, details: dict[str, Any] | None = None, request_id: str | None = None, locale: str | None = None, messages: dict[str, str] | None = None) -> None
Crée l'erreur ; sans message, celui-ci est cherché à partir de code dans la langue choisie, à défaut le code est utilisé.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
message | str | None | None | non | Message lisible ; par défaut le texte traduit de code. |
code | str | None | None | non | Code machine stable de l'erreur, par exemple policy_denied ; par défaut le default_code de la classe. |
status | int | None | None | non | Statut HTTP de la réponse, ou None si l'erreur est locale. |
details | dict[str, Any] | None | None | non | Détails structurés de l'erreur ; les secrets sont masqués avant d'être conservés. |
request_id | str | None | None | non | Identifiant de la requête en échec, affiché dans str(error). |
locale | str | None | None | non | Langue du message, par exemple fr ; déduite de l'environnement si elle n'est pas fournie. |
messages | dict[str, str] | None | None | non | Message par langue issu de message_i18n, par exemple {"en": "...", "fr": "..."}. |
Classe AuthError
Identifiants absents, invalides ou insuffisants (HTTP 401, ou 403 sans décision de politique).
EaiError
Classe PolicyDenied
Une décision de politique a refusé l'action. details contient en général reasons et decision_id.
EaiError
Classe QuotaExceeded
Un quota ou un budget serait dépassé (HTTP 429 avec le code quota_exceeded ou un code de budget).
EaiError
Classe EffortNotSupported
L'effort de raisonnement demandé n'est pas pris en charge par le modèle et aucun profil compatible ne s'applique.
EaiError
Classe ContextOverflow
Le contexte assemblé ne tient pas dans la fenêtre du modèle une fois les réserves déduites.
EaiError
Classe ApprovalRequired
L'action nécessite une approbation humaine. details.approval_id identifie la demande en attente.
EaiError
Classe NotFound
La ressource n'existe pas ou n'est pas visible pour le tenant appelant.
EaiError
Classe ValidationError
Un champ invalide d'une requête.
EaiError
Classe ConflictError
L'état de la ressource est en conflit avec la requête (HTTP 409).
EaiError
Classe RateLimited
Trop de requêtes (HTTP 429) une fois toutes les nouvelles tentatives épuisées.
EaiError
Classe ServerError
Le plan de contrôle a échoué (HTTP 5xx) une fois toutes les nouvelles tentatives épuisées.
EaiError
Classe TransportError
Le réseau a échoué avant la réception de toute réponse HTTP.
EaiError
Classe BudgetExhausted
Un budget local de l'agent (étapes, appels d'outils, jetons ou coût) est épuisé.
EaiError
Classe AgentStopped
Le coupe-circuit a arrêté l'agent (agent suspendu, tué ou exécution annulée).
EaiError
Classe EgressDenied
Un appel sortant vers une URL fournie par le tenant a été refusé par la garde de sortie (HTTP 403).
EaiError
Attributs :
| Nom | Type | Requis | Description |
|---|---|---|---|
reason | str | None | oui | Raison de l'action. Inscrite dans le journal d'audit avec l'acteur et l'heure. |
Classe PromptInjectionBlocked
Le prompt ou le contenu non fiable a été bloqué par le filtre d'injection de prompt (HTTP 403, mode block).
EaiError
Classe PayloadTooLarge
Le corps de la requête dépasse la limite du serveur (HTTP 413).
EaiError
Classe AuthzUnconfirmed
Une réponse d'autorisation ne portait aucune décision explicite d'OPA ou d'OpenFGA : le SDK ne suppose jamais une autorisation.
EaiError
Fonctions
error_from_payload
error_from_payload(status: int, payload: Any, locale: str | None = None, request_id: str | None = None) -> EaiError
Construit l'erreur typée pour un statut HTTP et un corps décodé (enveloppe ou non).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
status | int | oui | Statut HTTP de la réponse ; détermine la classe si le code d'erreur est inconnu (5xx donne ServerError). | |
payload | Any | oui | Corps d'erreur décodé, normalement {"error": {code, message, message_i18n, details, request_id}} ; toute autre valeur est acceptée. | |
locale | str | None | None | non | Langue du message ; choisit l'entrée correspondante de message_i18n si elle existe. |
request_id | str | None | None | non | Identifiant de requête utilisé si l'enveloppe n'en porte pas, en général l'en-tête x-request-id. |
Retour : EaiError. Une EaiError : erreur de base du SDK. code est le code machine stable renvoyé par l'API.