Коды ошибок ИИ (mpbx-ai)

Возвращаются уровнем провайдеров LLM и маршрутами настроек ИИ под /api/v1/ai (W9-AI-01, W9-AI-03, W9-AI-11). Сообщения никогда не содержат ключ API, текст запроса или текст ошибки провайдера: в них указываются не более чем вид провайдера, HTTP-статус и тип ошибки провайдера. Руководство: провайдеры ИИ и настройки.

Код	HTTP	Значение	Что делать
MPBX-AI-FEATURE-DISABLED	403	Функция выключена для компании или очереди (по умолчанию). Провайдер не вызывался.	Включите её в разделе Администрирование > ИИ.
MPBX-AI-NO-PROVIDER	500	Функция включена, но не выбран ни один включённый провайдер с ключом.	Добавьте провайдера с ключом и выберите его.
MPBX-AI-MODEL-UNKNOWN	400	Модели нет в каталоге для провайдеров Claude, она не является допустимым именем модели для конечной точки, совместимой с OpenAI, либо для этого вида провайдера не задана модель по умолчанию.	Выберите модель из каталога или укажите её имя.
MPBX-AI-PROVIDER-UNAVAILABLE	503	Все кандидаты (резервные модели, резервный провайдер) завершились по тайм-ауту, не были доступны, ответили 5xx или перегрузкой, либо потоковый ответ прервался.	Повторите попытку позже; добавьте резервного провайдера.
MPBX-AI-RATE-LIMITED	503	Провайдер отказал из-за ограничения частоты запросов (429).	Увеличьте лимит у провайдера или добавьте резервного провайдера.
MPBX-AI-AUTH-FAILED	500	Провайдер отклонил ключ (401 / 403).	Введите действующий ключ.
MPBX-AI-BAD-REQUEST	400	Провайдер отклонил запрос как некорректный, либо ключ или URL нельзя отправить.	Сообщите об ошибке; проверьте имя модели.
MPBX-AI-BAD-RESPONSE	503	Ответ провайдера не удалось прочитать (не JSON, вызов инструмента, аргументы которого не являются объектом, событие больше 1 МиБ, ответ больше 4 МиБ).	Проверьте, что конечная точка действительно работает по выбранному протоколу.
MPBX-AI-ENDPOINT-BLOCKED	400	Базовый URL не является публичным https (частный, loopback- или link-local адрес, внутреннее имя, http без шифрования, учётные данные в URL).	Используйте публичный адрес провайдера с https.
MPBX-AI-CATALOG-INVALID	-	Файл каталога (MPBX_AI_CATALOG_FILE) некорректен или старше встроенного; он был проигнорирован (записано в журнал при запуске).	Исправьте файл или удалите переменную.
MPBX-AI-UNSUPPORTED-AUDIO	400	Провайдер речи не принимает этот формат аудио, кодировку или схему каналов (например, mu-law для REST-конечной точки Azure или частоту дискретизации, которую он не предлагает).	Перекодируйте в 16-битный PCM или выберите поддерживаемый формат.
MPBX-AI-NOT-FOUND	404	В этой компании нет такого провайдера ИИ (или переопределения для очереди); провайдер другой компании не виден.	Проверьте идентификатор.
MPBX-AI-FEATURE-UNKNOWN	404	Неизвестное имя функции в пути.	Используйте voice_agent, live_assist, call_summary, voicemail_summary, call_analysis или transcription.
MPBX-AI-TOO-MANY	409	В компании уже 10 провайдеров ИИ.	Удалите один из них.
MPBX-AI-IN-USE	409	Зарезервировано: провайдер, всё ещё выбранный функцией (сейчас удаление разрешено, и функция остаётся без провайдера).	-
MPBX-AI-AGENT-CONFIG-INVALID	400	Конфигурация голосового агента не может быть использована (не заданы язык или голос, лимит хода вне диапазона 0.5–30 с, клавиши меню, отличные от 0–9 * #), либо компания требует объявления о согласии на использование ИИ, а у агента его нет. Агент не запускается; вызов продолжается со следующего шага сценария.	Исправьте конфигурацию агента.
MPBX-AI-AGENT-TIMEOUT	-	Записывается, когда голосовой агент не начал отвечать на ход звонящего в пределах своего жёсткого лимита (turn_timeout, по умолчанию 3 с); звонящий переведён на живого оператора (причина резервного перевода turn_timeout).	Проверьте задержку провайдеров; добавьте резервного провайдера.
MPBX-AI-AGENT-DISABLED	403	Настроенный ИИ-агент выключен (собственным переключателем; переключатель voice_agent компании — это MPBX-AI-FEATURE-DISABLED). Узел ai_agent сценария вызова переходит по выходу с ошибкой.	Включите агента в разделе Администрирование > ИИ-агенты.
MPBX-AI-ASSIST-SESSION-REQUIRED	403	Live assist предназначен для вошедших пользователей (оператор в вызове); у ключа API нет сессии.	Используйте вход в систему под своей учётной записью.