Códigos de error
Comprobaciones en la pasarela
Cada código de esta familia: qué significa, su causa más frecuente, qué hacer y quién puede hacerlo.
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
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
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
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
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
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
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-Keyestá 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-Keyen 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-Keyaú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
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
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
detailsde 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