# Comprobaciones en la pasarela

Cada código de esta familia: qué significa, su causa más frecuente, qué hacer y quién puede hacerlo.

[Todos los códigos de error](https://www.azothos.ai/es/docs/errors)

### `policy_blocked`

- **Qué significa**: Esta llamada fue bloqueada por una regla de su espacio de trabajo.
- **Causa más frecuente**: La regla «‹regla›» no permite este tipo de llamada.
- **Qué hacer**: Use una de las opciones conformes de abajo si existe, o pida al propietario de la regla una dispensa limitada en el tiempo, con una breve justificación.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/regles?tab=rules)

### `sovereignty_blocked`

- **Qué significa**: Esta llamada fue bloqueada por la política de residencia de datos.
- **Causa más frecuente**: Su espacio de trabajo no permite enviar estos datos a ‹proveedor›, cuyos servidores están fuera de la región permitida.
- **Qué hacer**: Use un modelo alojado en la UE si se propone uno abajo, o pida a un administrador que revise la política de residencia.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/regles?tab=jurisdictions)

### `jurisdiction_blocked`

- **Qué significa**: Esta llamada se bloqueó por el derecho que se le aplica.
- **Causa más frecuente**: La regla más estricta de los derechos que cubren esta llamada — dónde están las personas afectadas, dónde están sus entidades, dónde ejecuta ‹proveedor› el modelo — no la permite tal como se envió.
- **Qué hacer**: Abra la decisión para ver la regla y su razonamiento, o pida a un administrador que declare un proveedor conforme en Reglas › Jurisdicciones.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/regles?tab=jurisdictions)

### `kill_switch_active`

- **Qué significa**: Esta llamada fue bloqueada: la parada de emergencia está activada.
- **Causa más frecuente**: Un propietario o administrador activó la parada de emergencia para este espacio de trabajo, mandato, agente o proveedor. No se sirve ninguna llamada mientras esté activa.
- **Qué hacer**: Pregunte a un propietario o administrador del espacio de trabajo por qué, y cuándo se podrá levantar.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/settings?section=modules)

### `kill_switch_unavailable`

- **Qué significa**: Esta llamada fue bloqueada: no se pudo comprobar la parada de emergencia.
- **Causa más frecuente**: Azoth bloquea las llamadas cuando no puede confirmar que no haya ninguna parada de emergencia activa.
- **Qué hacer**: Inténtelo de nuevo en un momento.
- **Quién puede hacerlo**: Azoth, o el operador de este despliegue

### `data_exfiltration_blocked`

- **Qué significa**: Esta llamada fue bloqueada: el mensaje contiene contenido secreto.
- **Causa más frecuente**: Una parte del mensaje parece una contraseña, una clave o un token, y un secreto nunca se envía a un modelo de IA.
- **Qué hacer**: Quite el secreto del mensaje y envíelo de nuevo. No es posible ninguna dispensa para un secreto.
- **Quién puede hacerlo**: Cualquier miembro del espacio de trabajo

### `prompt_injection_blocked`

- **Qué significa**: Esta llamada fue bloqueada: el mensaje se lee como un intento de anular las instrucciones del modelo.
- **Causa más frecuente**: Esta llamada se gobierna en modo Aplicar, y parte del mensaje pide al modelo que ignore o revele sus instrucciones, o que interprete un personaje sin reglas (una inyección de prompt). En modo Aplicar, un mensaje así nunca se envía al modelo.
- **Qué hacer**: Reformule la petición sin dirigirse a las instrucciones del modelo. Si el mensaje es legítimo, un propietario o administrador encuentra el rechazo, y la señal detectada, entre las decisiones selladas.
- **Quién puede hacerlo**: Cualquier miembro del espacio de trabajo

### `redaction_failed`

- **Qué significa**: Esta llamada fue bloqueada: no se pudieron enmascarar sus datos personales.
- **Causa más frecuente**: El mensaje contiene datos personales sensibles y su enmascaramiento falló, así que no se envió nada.
- **Qué hacer**: Quite los datos personales del mensaje, o inténtelo de nuevo en un momento.
- **Quién puede hacerlo**: Cualquier miembro del espacio de trabajo

### `governance_error`

- **Qué significa**: Esta llamada fue bloqueada: no se pudieron ejecutar los controles de gobernanza.
- **Causa más frecuente**: Azoth bloquea una llamada en lugar de servirla sin control.
- **Qué hacer**: Inténtelo de nuevo en un momento. Si sigue ocurriendo, avise a su administrador.
- **Quién puede hacerlo**: Azoth, o el operador de este despliegue

### `loop_detected`

- **Qué significa**: Esta llamada fue bloqueada: la misma llamada se repitió en bucle.
- **Causa más frecuente**: Un agente envió la misma petición una y otra vez, así que Azoth lo pausó para detener el gasto.
- **Qué hacer**: Revise la lógica del agente y vuelva a intentarlo.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `tenant_concurrency_limit`

- **Qué significa**: Esta llamada fue bloqueada: hay demasiadas llamadas en curso a la vez.
- **Causa más frecuente**: Su espacio de trabajo tiene un límite de llamadas de IA simultáneas, y se ha alcanzado.
- **Qué hacer**: Espere un momento e inténtelo de nuevo.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `human_review_required`

- **Qué significa**: Esta llamada espera la aprobación de una persona.
- **Causa más frecuente**: Una regla de su espacio de trabajo exige una aprobación humana antes de este tipo de llamada.
- **Qué hacer**: Se ejecuta en cuanto otra persona la apruebe. Sígala con el enlace de seguimiento.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/regles?tab=approvals)

### `human_review_not_resumable`

- **Qué significa**: Esta llamada fue bloqueada: necesita una aprobación humana y no puede quedar en espera.
- **Causa más frecuente**: Una regla exige una aprobación humana, pero este tipo de llamada no puede esperarla.
- **Qué hacer**: Envíela por la API de chat, que puede esperar una aprobación, o pida al propietario de la regla que la revise.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `approval_expired`

- **Qué significa**: Esta llamada no se ejecutó: su aprobación caducó.
- **Causa más frecuente**: Nadie aprobó la llamada antes de que caducara su solicitud de aprobación.
- **Qué hacer**: Envíe la llamada de nuevo para crear una nueva solicitud de aprobación.
- **Quién puede hacerlo**: Cualquier miembro del espacio de trabajo

### `ungrounded_answer`

- **Qué significa**: Esta respuesta no se devolvió: sus fuentes no respaldan lo suficiente de ella.
- **Causa más frecuente**: El mandato es de alto riesgo, y muy pocas afirmaciones de la respuesta aparecen en los pasajes enviados con la llamada (una estimación).
- **Qué hacer**: Envíe los pasajes en los que debe basarse la respuesta, reformule la pregunta o pida a un administrador que revise el umbral del mandato.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `grounding_review_required`

- **Qué significa**: Esta respuesta espera a que una persona la revise.
- **Causa más frecuente**: El mandato es de alto riesgo, y los pasajes enviados con la llamada respaldan muy poco de la respuesta (una estimación).
- **Qué hacer**: Se devuelve en cuanto otra persona la apruebe. Recupérela con el enlace de liberación.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo

### `grounding_requires_complete_answer`

- **Qué significa**: Esta llamada fue bloqueada: su respuesta debe comprobarse antes de enviarse.
- **Causa más frecuente**: El mandato es de alto riesgo, y una respuesta en streaming no puede comprobarse con sus fuentes antes de llegarle.
- **Qué hacer**: Envíe la llamada de nuevo sin streaming.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `pending`

- **Qué significa**: La aprobación que espera esta solicitud aún no se ha decidido: la llamada retenida no se ha ejecutado y la respuesta retenida no se entrega.
- **Causa más frecuente**: Se reanudó la llamada, o se pidió la respuesta, antes de que una persona la aprobara en Reglas › Aprobaciones.
- **Qué hacer**: Esta aprobación aún espera una decisión. Vuelva a intentarlo cuando una persona la haya aprobado en Reglas › Aprobaciones.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/regles?tab=approvals)

### `rejected`

- **Qué significa**: Una persona rechazó la aprobación que espera esta solicitud: la llamada retenida nunca se ejecutará y la respuesta retenida nunca se entregará.
- **Causa más frecuente**: Quien la revisó en Reglas › Aprobaciones consideró que la llamada, o la respuesta, no debía salir.
- **Qué hacer**: Esta aprobación fue rechazada: la llamada retenida no se ejecutará. Para volver a intentarlo, modifique la llamada —o pregunte el motivo a quien la revisó— y envíela de nuevo.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `already_executed`

- **Qué significa**: La llamada retenida de esta aprobación ya se ejecutó: una aprobación ejecuta su llamada una sola vez.
- **Causa más frecuente**: Una segunda reanudación de la misma aprobación: un reintento tras agotarse el tiempo de espera, o dos procesos que la reanudan a la vez.
- **Qué hacer**: Esta llamada aprobada ya se ejecutó: una aprobación ejecuta su llamada una sola vez, y su respuesta fue a la primera reanudación. Para ejecutarla de nuevo, vuelva a enviar la llamada; se gobierna de nuevo.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `already_released`

- **Qué significa**: La respuesta retenida de esta aprobación ya se entregó: se entrega una sola vez y después se borra.
- **Causa más frecuente**: Una segunda petición de la misma respuesta: un reintento tras agotarse el tiempo de espera, o dos procesos que la piden a la vez.
- **Qué hacer**: Esta respuesta retenida ya se entregó: se entrega una sola vez y después se borra. Use la respuesta de la primera petición, o vuelva a enviar la llamada.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `not_requester`

- **Qué significa**: Solo la clave API que envió una llamada retenida puede ejecutarla una vez aprobada.
- **Causa más frecuente**: Otra clave del espacio de trabajo — una clave renovada desde entonces, u otro servicio — reanudó la aprobación.
- **Qué hacer**: Esta aprobación pertenece a la clave API que envió la llamada: reanúdela con esa clave.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `idempotency_key_invalid`

- **Qué significa**: La cabecera `Idempotency-Key` está vacía, es demasiado larga o contiene un carácter que no puede contener.
- **Causa más frecuente**: Una clave de más de 255 caracteres, con un espacio, o con caracteres fuera del ASCII visible.
- **Qué hacer**: La cabecera Idempotency-Key debe tener de 1 a 255 caracteres ASCII visibles, sin espacios. Envíe un valor único por llamada, por ejemplo un UUID.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `idempotency_key_reused`

- **Qué significa**: Una llamada ya usó esta `Idempotency-Key` en la última hora con otro cuerpo: una clave designa una sola llamada.
- **Causa más frecuente**: Un cliente que envía una clave fija, o un reintento cuyo cuerpo cambió — una nueva marca de tiempo, otro mensaje.
- **Qué hacer**: Esta Idempotency-Key ya se usó con otro cuerpo de solicitud. Use una clave nueva para una llamada nueva; reutilice una clave solo para reintentar exactamente la misma llamada.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `idempotency_key_in_progress`

- **Qué significa**: La primera llamada con esta `Idempotency-Key` aún no ha respondido: mientras tanto nunca se ejecuta una segunda vez.
- **Causa más frecuente**: Un reintento enviado antes de que respondiera la primera llamada — un tiempo de espera del cliente más corto que la respuesta del modelo.
- **Qué hacer**: Una llamada con esta Idempotency-Key sigue en curso. Espere un momento y reintente con la misma clave para recibir su respuesta.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `idempotency_replay_unavailable`

- **Qué significa**: La primera llamada con esta `Idempotency-Key` recibió su respuesta, pero no se conservó: un reintento no recibe ni esa respuesta ni una segunda llamada al modelo.
- **Causa más frecuente**: La política de datos del espacio de trabajo no conserva respuestas (por defecto), el caso de uso guarda su contenido en el cliente (modo bóveda), o la respuesta era demasiado grande para conservarla.
- **Qué hacer**: La llamada con esta Idempotency-Key recibió su respuesta, pero no se pudo conservar para un reintento (la política de datos del espacio de trabajo, un caso de uso en modo bóveda, o su tamaño). Encuéntrela en Pruebas › Decisiones por su traza; envíe una clave nueva para ejecutar la llamada de nuevo.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `approval_pending`

- **Qué significa**: El paso en el que se detuvo esta ejecución del agente aún espera una decisión: no se ejecutó nada.
- **Causa más frecuente**: Se reanudó la ejecución antes de que una persona aprobara el paso en Reglas › Aprobaciones.
- **Qué hacer**: Este paso del agente aún espera una decisión. Reanude la ejecución cuando una persona lo haya aprobado en Reglas › Aprobaciones.
- **Quién puede hacerlo**: Un propietario o administrador del espacio de trabajo · [Abrir la pantalla](https://www.azothos.ai/dashboard/regles?tab=approvals)

### `approval_rejected`

- **Qué significa**: Una persona rechazó el paso en el que se detuvo esta ejecución del agente: el paso no se ejecutará y la ejecución no puede reanudarse.
- **Causa más frecuente**: Quien revisó el paso en Reglas › Aprobaciones consideró que el agente no debía realizar esta acción.
- **Qué hacer**: Una persona rechazó este paso del agente: la ejecución no se reanudará. Para volver a intentarlo, modifique el plan —o pregunte el motivo a quien lo revisó— y ejecute de nuevo el agente.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `approval_not_found`

- **Qué significa**: No queda ninguna solicitud de aprobación con la que reanudar esta ejecución del agente.
- **Causa más frecuente**: La solicitud nunca se presentó, su paso ya se reanudó, o la ejecución pertenece a otro espacio de trabajo.
- **Qué hacer**: Ninguna solicitud de aprobación espera esta ejecución del agente. Compruebe el identificador de la ejecución; si ya se reanudó, su resultado es el de la primera reanudación.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `already_resumed`

- **Qué significa**: El paso aprobado de esta ejecución ya se ejecutó: una aprobación ejecuta su paso una sola vez.
- **Causa más frecuente**: Una segunda reanudación de la misma ejecución: un reintento tras agotarse el tiempo de espera, o dos procesos que la reanudan a la vez.
- **Qué hacer**: Esta ejecución ya se reanudó: una aprobación ejecuta su paso una sola vez. Lea el resultado de la ejecución en lugar de reanudarla de nuevo.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `execution_not_found`

- **Qué significa**: Ninguna ejecución de agente tiene este identificador en este espacio de trabajo.
- **Causa más frecuente**: Un identificador escrito a mano, tomado de otro espacio de trabajo, o enviado con una clave de otro espacio de trabajo.
- **Qué hacer**: No se encontró ninguna ejecución de agente con este identificador en este espacio de trabajo. Compruebe el identificador y la clave API con la que la reanuda.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `not_awaiting_approval`

- **Qué significa**: Esta ejecución del agente no está detenida a la espera de una aprobación: no hay nada que reanudar.
- **Causa más frecuente**: Terminó, falló o sigue en curso, o ya se reanudó.
- **Qué hacer**: Esta ejecución no espera ninguna aprobación: no hay nada que reanudar. Lea su estado antes de reanudarla.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada

### `agent_plan_invalid`

- **Qué significa**: El plan que hizo el planificador del agente no superó sus controles, así que no se ejecutó nada. El campo `details` de la respuesta enumera lo que falló.
- **Causa más frecuente**: Un objetivo que el planificador no pudo convertir en pasos permitidos al agente: una herramienta que no tiene, o más pasos de los permitidos.
- **Qué hacer**: El agente no pudo convertir este objetivo en pasos que le estén permitidos. Reformule el objetivo, o dé al agente las herramientas que necesita, y vuelva a intentarlo.
- **Quién puede hacerlo**: El desarrollador del código que hace la llamada
