Códigos de error de IA (mpbx-ai)

Los genera la capa de proveedores de LLM y las rutas de configuración de IA bajo /api/v1/ai (W9-AI-01, W9-AI-03, W9-AI-11). Los mensajes nunca contienen una clave de API, un prompt ni el mensaje de error de un proveedor; como máximo indican el tipo de proveedor, el estado HTTP y el tipo de error del proveedor. Guía: proveedores y configuración de IA.

Código	HTTP	Significado	Qué hacer
MPBX-AI-FEATURE-DISABLED	403	La función está desactivada para la empresa o la cola (por omisión). No se llamó a ningún proveedor.	Actívela en Administración > IA.
MPBX-AI-NO-PROVIDER	500	La función está activada, pero no hay un proveedor habilitado con clave seleccionado.	Agregue un proveedor con clave y selecciónelo.
MPBX-AI-MODEL-UNKNOWN	400	El modelo no está en el catálogo para los proveedores de Claude, no es un nombre de modelo válido para un endpoint compatible con OpenAI, o el tipo de proveedor no tiene modelo predeterminado.	Elija un modelo del catálogo o indique uno.
MPBX-AI-PROVIDER-UNAVAILABLE	503	Todas las opciones (modelos de respaldo, proveedor de respaldo) agotaron el tiempo, no pudieron conectarse, respondieron 5xx o sobrecarga, o un flujo se interrumpió.	Reintente más tarde; agregue un proveedor de respaldo.
MPBX-AI-RATE-LIMITED	503	El proveedor rechazó la solicitud por su límite de tasa (429).	Aumente el límite con su proveedor o agregue un proveedor de respaldo.
MPBX-AI-AUTH-FAILED	500	El proveedor rechazó la clave (401 / 403).	Escriba una clave válida.
MPBX-AI-BAD-REQUEST	400	El proveedor rechazó la solicitud por estar mal formada, o no se puede enviar la clave o la URL.	Repórtelo; revise el nombre del modelo.
MPBX-AI-BAD-RESPONSE	503	No se pudo leer la respuesta del proveedor (no es JSON, una llamada de herramienta cuyos argumentos no son un objeto, un evento de más de 1 MiB o una respuesta de más de 4 MiB).	Verifique que el endpoint realmente hable el protocolo elegido.
MPBX-AI-ENDPOINT-BLOCKED	400	La URL base no es https público (dirección privada, de loopback o de enlace local, nombre interno, http sin cifrar, credenciales en la URL).	Use la dirección https pública del proveedor.
MPBX-AI-CATALOG-INVALID	-	El archivo de catálogo (MPBX_AI_CATALOG_FILE) está mal formado o es más antiguo que el integrado; se ignoró (se registra al iniciar).	Corrija el archivo o elimine la variable.
MPBX-AI-UNSUPPORTED-AUDIO	400	El proveedor de voz no acepta este formato de audio, codificación o disposición de canales (por ejemplo, mu-law para el endpoint REST de Azure, o una tasa de salida que no ofrece).	Transcodifique a PCM de 16 bits o elija un formato compatible.
MPBX-AI-NOT-FOUND	404	No existe ese proveedor de IA (o esa excepción de cola) en esta empresa; el proveedor de otra empresa es invisible.	Verifique el id.
MPBX-AI-FEATURE-UNKNOWN	404	Nombre de función desconocido en la ruta.	Use voice_agent, live_assist, call_summary, voicemail_summary, call_analysis o transcription.
MPBX-AI-TOO-MANY	409	La empresa ya tiene 10 proveedores de IA.	Elimine uno.
MPBX-AI-IN-USE	409	Reservado: un proveedor todavía seleccionado por una función (hoy la eliminación está permitida y la función queda sin proveedor).	-
MPBX-AI-AGENT-CONFIG-INVALID	400	La configuración del agente de voz no se puede usar (sin idioma o voz, un límite de turno fuera de 0.5-30 s, teclas de menú distintas de 0-9 * #), o la empresa exige el anuncio de consentimiento de IA y el agente no tiene ninguno. El agente no se inicia; la llamada continúa con el siguiente paso del flujo.	Corrija la configuración del agente.
MPBX-AI-AGENT-TIMEOUT	-	Se registra cuando el agente de voz no empezó a responder a un turno de quien llama dentro de su límite máximo (turn_timeout, 3 s por omisión); la llamada se transfirió a una persona (motivo de respaldo turn_timeout).	Revise la latencia de los proveedores; agregue un proveedor de respaldo.
MPBX-AI-AGENT-DISABLED	403	El agente de IA configurado está desactivado (su propio interruptor; el interruptor voice_agent de la empresa es MPBX-AI-FEATURE-DISABLED). El nodo ai_agent de un flujo de llamada toma su salida de error.	Active el agente en Administración > Agentes de IA.
MPBX-AI-ASSIST-SESSION-REQUIRED	403	La asistencia en vivo es para usuarios que iniciaron sesión (un agente en una llamada); una clave de API no tiene sesión.	Use una sesión iniciada.