# Contrôles à la passerelle

Chaque code de cette famille : ce qu’il veut dire, sa cause la plus fréquente, quoi faire et qui peut le faire.

[Tous les codes d’erreur](https://www.azothos.ai/fr/docs/errors)

### `policy_blocked`

- **Ce que ça veut dire**: Cet appel a été bloqué par une règle de votre espace de travail.
- **Cause la plus fréquente**: La règle « ‹règle› » n’autorise pas ce type d’appel.
- **Quoi faire**: Utilisez l’une des options conformes ci-dessous s’il y en a une, ou demandez au propriétaire de la règle une dérogation limitée dans le temps, avec une courte justification.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/regles?tab=rules)

### `sovereignty_blocked`

- **Ce que ça veut dire**: Cet appel a été bloqué par la politique de résidence des données.
- **Cause la plus fréquente**: Votre espace de travail n’autorise pas l’envoi de ces données à ‹fournisseur›, dont les serveurs sont hors de la zone permise.
- **Quoi faire**: Utilisez un modèle hébergé dans l’UE s’il en est proposé un ci-dessous, ou demandez à un administrateur de revoir la politique de résidence.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/regles?tab=jurisdictions)

### `jurisdiction_blocked`

- **Ce que ça veut dire**: Cet appel a été bloqué par le droit qui s’y applique.
- **Cause la plus fréquente**: La règle la plus stricte des droits qui couvrent cet appel — où sont les personnes concernées, où sont vos entités, où ‹fournisseur› exécute le modèle — ne l’autorise pas tel qu’envoyé.
- **Quoi faire**: Ouvrez la décision pour voir la règle et son raisonnement, ou demandez à un administrateur de déclarer un fournisseur conforme dans Règles › Juridictions.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/regles?tab=jurisdictions)

### `kill_switch_active`

- **Ce que ça veut dire**: Cet appel a été bloqué : l’arrêt d’urgence est activé.
- **Cause la plus fréquente**: Un propriétaire ou un administrateur a activé l’arrêt d’urgence pour cet espace de travail, ce mandat, cet agent ou ce fournisseur. Aucun appel n’est servi tant qu’il est actif.
- **Quoi faire**: Demandez à un propriétaire ou à un administrateur de l’espace de travail pourquoi, et quand il pourra être levé.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/settings?section=modules)

### `kill_switch_unavailable`

- **Ce que ça veut dire**: Cet appel a été bloqué : la vérification de l’arrêt d’urgence n’a pas pu s’exécuter.
- **Cause la plus fréquente**: Azoth bloque les appels quand il ne peut pas confirmer qu’aucun arrêt d’urgence n’est actif.
- **Quoi faire**: Réessayez dans un instant.
- **Qui peut le faire**: Azoth, ou l’opérateur de ce déploiement

### `data_exfiltration_blocked`

- **Ce que ça veut dire**: Cet appel a été bloqué : le message contient un contenu secret.
- **Cause la plus fréquente**: Une partie du message ressemble à un mot de passe, une clé ou un jeton, et un secret n’est jamais envoyé à un modèle d’IA.
- **Quoi faire**: Retirez le secret du message et renvoyez-le. Aucune dérogation n’est possible pour un secret.
- **Qui peut le faire**: Tout membre de l’espace de travail

### `prompt_injection_blocked`

- **Ce que ça veut dire**: Cet appel a été bloqué : le message se lit comme une tentative de contourner les instructions du modèle.
- **Cause la plus fréquente**: Cet appel est gouverné en mode Appliquer, et une partie du message demande au modèle d’ignorer ou de révéler ses instructions, ou de jouer un personnage sans règles (une injection de prompt). En mode Appliquer, un tel message n’est jamais envoyé au modèle.
- **Quoi faire**: Reformulez la demande sans viser les instructions du modèle. Si le message est légitime, un propriétaire ou un administrateur retrouve le refus, et le signal détecté, parmi les décisions scellées.
- **Qui peut le faire**: Tout membre de l’espace de travail

### `redaction_failed`

- **Ce que ça veut dire**: Cet appel a été bloqué : ses données personnelles n’ont pas pu être masquées.
- **Cause la plus fréquente**: Le message contient des données personnelles sensibles et leur masquage a échoué, donc rien n’a été envoyé.
- **Quoi faire**: Retirez les données personnelles du message, ou réessayez dans un instant.
- **Qui peut le faire**: Tout membre de l’espace de travail

### `governance_error`

- **Ce que ça veut dire**: Cet appel a été bloqué : les contrôles de gouvernance n’ont pas pu s’exécuter.
- **Cause la plus fréquente**: Azoth bloque un appel plutôt que de le servir sans contrôle.
- **Quoi faire**: Réessayez dans un instant. Si cela se répète, prévenez votre administrateur.
- **Qui peut le faire**: Azoth, ou l’opérateur de ce déploiement

### `loop_detected`

- **Ce que ça veut dire**: Cet appel a été bloqué : le même appel s’est répété en boucle.
- **Cause la plus fréquente**: Un agent a envoyé la même requête encore et encore, donc Azoth l’a mis en pause pour arrêter la dépense.
- **Quoi faire**: Vérifiez la logique de l’agent, puis réessayez.
- **Qui peut le faire**: La personne qui développe le code appelant

### `tenant_concurrency_limit`

- **Ce que ça veut dire**: Cet appel a été bloqué : trop d’appels sont en cours en même temps.
- **Cause la plus fréquente**: Votre espace de travail limite le nombre d’appels d’IA simultanés, et cette limite est atteinte.
- **Quoi faire**: Patientez un instant et réessayez.
- **Qui peut le faire**: La personne qui développe le code appelant

### `human_review_required`

- **Ce que ça veut dire**: Cet appel attend l’approbation d’une personne.
- **Cause la plus fréquente**: Une règle de votre espace de travail exige une approbation humaine avant ce type d’appel.
- **Quoi faire**: Il s’exécute dès qu’une autre personne l’approuve. Suivez-le avec le lien de suivi.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/regles?tab=approvals)

### `human_review_not_resumable`

- **Ce que ça veut dire**: Cet appel a été bloqué : il exige une approbation humaine et ne peut pas être mis en attente.
- **Cause la plus fréquente**: Une règle exige une approbation humaine, mais ce type d’appel ne peut pas l’attendre.
- **Quoi faire**: Envoyez-le par l’API de chat, qui sait attendre une approbation, ou demandez au propriétaire de la règle de la revoir.
- **Qui peut le faire**: La personne qui développe le code appelant

### `approval_expired`

- **Ce que ça veut dire**: Cet appel n’a pas été exécuté : son approbation a expiré.
- **Cause la plus fréquente**: Personne n’a approuvé l’appel avant l’expiration de sa demande d’approbation.
- **Quoi faire**: Renvoyez l’appel pour créer une nouvelle demande d’approbation.
- **Qui peut le faire**: Tout membre de l’espace de travail

### `ungrounded_answer`

- **Ce que ça veut dire**: Cette réponse n’a pas été renvoyée : ses sources n’en soutiennent pas assez.
- **Cause la plus fréquente**: Le mandat est à enjeu élevé, et trop peu d’affirmations de la réponse figurent dans les passages envoyés avec l’appel (estimation).
- **Quoi faire**: Envoyez les passages sur lesquels la réponse doit s’appuyer, reformulez la question, ou demandez à un administrateur de revoir le seuil du mandat.
- **Qui peut le faire**: La personne qui développe le code appelant

### `grounding_review_required`

- **Ce que ça veut dire**: Cette réponse attend qu’une personne la vérifie.
- **Cause la plus fréquente**: Le mandat est à enjeu élevé, et les passages envoyés avec l’appel soutiennent trop peu de la réponse (estimation).
- **Quoi faire**: Elle est renvoyée dès qu’une autre personne l’approuve. Récupérez-la avec le lien de libération.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail

### `grounding_requires_complete_answer`

- **Ce que ça veut dire**: Cet appel a été bloqué : sa réponse doit être vérifiée avant d’être envoyée.
- **Cause la plus fréquente**: Le mandat est à enjeu élevé, et une réponse en streaming ne peut pas être vérifiée contre ses sources avant de vous parvenir.
- **Quoi faire**: Renvoyez l’appel sans streaming.
- **Qui peut le faire**: La personne qui développe le code appelant

### `pending`

- **Ce que ça veut dire**: L’approbation qu’attend cette requête n’a pas encore été décidée : l’appel retenu n’a pas été exécuté, la réponse retenue n’est pas remise.
- **Cause la plus fréquente**: L’appel a été repris, ou la réponse demandée, avant qu’une personne ne l’approuve dans Règles › Approbations.
- **Quoi faire**: Cette approbation attend encore une décision. Réessayez une fois qu’une personne l’a approuvée dans Règles › Approbations.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/regles?tab=approvals)

### `rejected`

- **Ce que ça veut dire**: Une personne a rejeté l’approbation qu’attend cette requête : l’appel retenu ne sera jamais exécuté, la réponse retenue ne sera jamais remise.
- **Cause la plus fréquente**: La personne qui l’a examinée dans Règles › Approbations a jugé que l’appel, ou la réponse, ne devait pas sortir.
- **Quoi faire**: Cette approbation a été rejetée : l’appel retenu ne sera pas exécuté. Pour réessayer, modifiez l’appel — ou demandez la raison à la personne qui l’a examinée — puis renvoyez-le.
- **Qui peut le faire**: La personne qui développe le code appelant

### `already_executed`

- **Ce que ça veut dire**: L’appel retenu de cette approbation a déjà été exécuté : une approbation exécute son appel une seule fois.
- **Cause la plus fréquente**: Une seconde reprise de la même approbation — un nouvel essai après un délai dépassé, ou deux processus qui la reprennent en même temps.
- **Quoi faire**: Cet appel approuvé a déjà été exécuté : une approbation exécute son appel une seule fois, et sa réponse est allée à la première reprise. Pour l’exécuter de nouveau, renvoyez l’appel — il est gouverné à nouveau.
- **Qui peut le faire**: La personne qui développe le code appelant

### `already_released`

- **Ce que ça veut dire**: La réponse retenue de cette approbation a déjà été remise : elle est remise une seule fois, puis effacée.
- **Cause la plus fréquente**: Une seconde demande de la même réponse — un nouvel essai après un délai dépassé, ou deux processus qui la demandent en même temps.
- **Quoi faire**: Cette réponse retenue a déjà été remise : elle est remise une seule fois, puis effacée. Utilisez la réponse de la première demande, ou renvoyez l’appel.
- **Qui peut le faire**: La personne qui développe le code appelant

### `not_requester`

- **Ce que ça veut dire**: Seule la clé d’API qui a envoyé un appel retenu peut l’exécuter une fois qu’il est approuvé.
- **Cause la plus fréquente**: Une autre clé de l’espace — une clé renouvelée depuis, ou un autre service — a repris l’approbation.
- **Quoi faire**: Cette approbation appartient à la clé d’API qui a envoyé l’appel : reprenez-la avec cette clé.
- **Qui peut le faire**: La personne qui développe le code appelant

### `idempotency_key_invalid`

- **Ce que ça veut dire**: L’en-tête `Idempotency-Key` est vide, trop long, ou contient un caractère qu’il ne peut pas contenir.
- **Cause la plus fréquente**: Une clé de plus de 255 caractères, avec une espace, ou avec des caractères hors de l’ASCII visible.
- **Quoi faire**: L’en-tête Idempotency-Key doit compter de 1 à 255 caractères ASCII visibles, sans espace. Envoyez une valeur unique par appel, par exemple un UUID.
- **Qui peut le faire**: La personne qui développe le code appelant

### `idempotency_key_reused`

- **Ce que ça veut dire**: Un appel a déjà utilisé cette `Idempotency-Key` dans l’heure avec un autre corps : une clé désigne un seul appel.
- **Cause la plus fréquente**: Un client qui envoie une clé fixe, ou un nouvel essai dont le corps a changé — un nouvel horodatage, un autre message.
- **Quoi faire**: Cette Idempotency-Key a déjà servi avec un autre corps de requête. Utilisez une nouvelle clé pour un nouvel appel ; ne réutilisez une clé que pour réessayer exactement le même appel.
- **Qui peut le faire**: La personne qui développe le code appelant

### `idempotency_key_in_progress`

- **Ce que ça veut dire**: Le premier appel avec cette `Idempotency-Key` n’a pas encore répondu : il n’est jamais exécuté une seconde fois entre-temps.
- **Cause la plus fréquente**: Un nouvel essai envoyé avant la réponse du premier appel — un délai d’attente du client plus court que la réponse du modèle.
- **Quoi faire**: Un appel avec cette Idempotency-Key est encore en cours. Patientez un instant, puis réessayez avec la même clé pour recevoir sa réponse.
- **Qui peut le faire**: La personne qui développe le code appelant

### `idempotency_replay_unavailable`

- **Ce que ça veut dire**: Le premier appel avec cette `Idempotency-Key` a reçu sa réponse, mais elle n’a pas été conservée : un nouvel essai ne reçoit ni cette réponse ni un second appel au modèle.
- **Cause la plus fréquente**: La politique de données de l’espace ne conserve aucune réponse (par défaut), le cas d’usage garde son contenu chez le client (mode coffre), ou la réponse était trop volumineuse pour être conservée.
- **Quoi faire**: L’appel avec cette Idempotency-Key a reçu sa réponse, mais elle n’a pas pu être conservée pour un nouvel essai (la politique de données de l’espace, un cas d’usage en mode coffre, ou sa taille). Retrouvez-la dans Preuves › Décisions par sa trace ; envoyez une nouvelle clé pour exécuter l’appel de nouveau.
- **Qui peut le faire**: La personne qui développe le code appelant

### `approval_pending`

- **Ce que ça veut dire**: L’étape sur laquelle cette exécution d’agent s’est arrêtée attend encore une décision : rien n’a été exécuté.
- **Cause la plus fréquente**: L’exécution a été reprise avant qu’une personne n’approuve l’étape dans Règles › Approbations.
- **Quoi faire**: Cette étape de l’agent attend encore une décision. Reprenez l’exécution une fois qu’une personne l’a approuvée dans Règles › Approbations.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/regles?tab=approvals)

### `approval_rejected`

- **Ce que ça veut dire**: Une personne a rejeté l’étape sur laquelle cette exécution d’agent s’est arrêtée : l’étape ne sera pas exécutée, et l’exécution ne peut pas reprendre.
- **Cause la plus fréquente**: La personne qui a examiné l’étape dans Règles › Approbations a jugé que l’agent ne devait pas faire cette action.
- **Quoi faire**: Une personne a rejeté cette étape de l’agent : l’exécution ne reprendra pas. Pour réessayer, modifiez le plan — ou demandez la raison à la personne qui l’a examinée — puis relancez l’agent.
- **Qui peut le faire**: La personne qui développe le code appelant

### `approval_not_found`

- **Ce que ça veut dire**: Aucune demande d’approbation ne reste pour reprendre cette exécution d’agent.
- **Cause la plus fréquente**: La demande n’a jamais été déposée, son étape a déjà été reprise, ou l’exécution appartient à un autre espace.
- **Quoi faire**: Aucune demande d’approbation n’attend cette exécution d’agent. Vérifiez l’identifiant de l’exécution ; si elle a déjà été reprise, son résultat est celui de la première reprise.
- **Qui peut le faire**: La personne qui développe le code appelant

### `already_resumed`

- **Ce que ça veut dire**: L’étape approuvée de cette exécution a déjà été exécutée : une approbation exécute son étape une seule fois.
- **Cause la plus fréquente**: Une seconde reprise de la même exécution — un nouvel essai après un délai dépassé, ou deux processus qui la reprennent en même temps.
- **Quoi faire**: Cette exécution a déjà été reprise : une approbation exécute son étape une seule fois. Lisez le résultat de l’exécution au lieu de la reprendre de nouveau.
- **Qui peut le faire**: La personne qui développe le code appelant

### `execution_not_found`

- **Ce que ça veut dire**: Aucune exécution d’agent ne porte cet identifiant dans cet espace.
- **Cause la plus fréquente**: Un identifiant saisi à la main, pris dans un autre espace, ou envoyé avec une clé d’un autre espace.
- **Quoi faire**: Aucune exécution d’agent avec cet identifiant n’a été trouvée dans cet espace. Vérifiez l’identifiant, et la clé d’API avec laquelle vous la reprenez.
- **Qui peut le faire**: La personne qui développe le code appelant

### `not_awaiting_approval`

- **Ce que ça veut dire**: Cette exécution d’agent n’est pas arrêtée en attente d’une approbation : il n’y a rien à reprendre.
- **Cause la plus fréquente**: Elle est terminée, a échoué ou est encore en cours — ou elle a déjà été reprise.
- **Quoi faire**: Cette exécution n’attend pas d’approbation : il n’y a rien à reprendre. Lisez son statut avant de la reprendre.
- **Qui peut le faire**: La personne qui développe le code appelant

### `agent_plan_invalid`

- **Ce que ça veut dire**: Le plan établi par le planificateur de l’agent n’a pas passé ses contrôles : rien n’a été exécuté. Le champ `details` de la réponse liste ce qui a échoué.
- **Cause la plus fréquente**: Un objectif que le planificateur n’a pas su traduire en étapes permises à l’agent — un outil qu’il n’a pas, ou plus d’étapes que permis.
- **Quoi faire**: L’agent n’a pas pu traduire cet objectif en étapes qui lui sont permises. Reformulez l’objectif, ou donnez à l’agent les outils dont il a besoin, puis réessayez.
- **Qui peut le faire**: La personne qui développe le code appelant
