Коды ошибок Assistant SDK

Обновлено 22 ноября 2023

Ниже перечислены сообщения об ошибках, которые могут возникнуть во время работы с ассистентом.

Даже виртуальные ассистенты учатся на ошибках. Скоро меня починят, и мы продолжим наше общение

Код ошибки	Описание
-1	VPS_ON_MAINTENANCEVPS Находится в режиме технического обслуживания
-2	VPS_CLIENT_ON_SENDING_ERROR Не удалось отправить сообщение клиенту: клиент выполнил запрос и прервал сессию до получения ответа
-4	VPS_CLIENT_ON_MAX_REQUEST_SYSTEM_MESSAGE_SIZE_REACHED Клиент прислал слишком большое системное сообщение или общий объем содержимого присланных системных сообщений в рамках одного msgId превышает заданное значение
-5	VPS_CLIENT_ON_REQUEST_TEXT_MAX_SIZE_REACHED Клиент прислал слишком большое текстовое сообщение или суммарный объем содержимого всех присланных текстовых сообщений в рамках одного msgId
-6	VPS_CLIENT_ON_REQUEST_TRANSCRIBED_TEXT_MAX_SIZE_REACHED Слишком большой распознанный текст
-7	VPS_CLIENT_ON_RECEIVING_VOICE_MIXED_WITH_TEXT Клиент прислал текстовоe сообщение и голосовое сообщение в рамках одного msgId
-8	VPS_CLIENT_ON_RECEIVING_UNSUPPORTED_VERSION В сообщении указана несуществующая/неподдерживаемая версия протокола
-10	VPS_CLIENT_UNEXPECTED_MESSAGE Клиент прислал неизвестный contentCase или messageName
-11	VPS_CLIENT_ON_RECEIVING_UNSUPPORTED_LOCALE Клиент прислал в настройках код региональных параметров, который не поддерживается сервисом
-13	VPS_CLIENT_ON_RECEIVING_TEXT_TYPE_CHANGED Изменена разметка текста в рамках одного messageId
-21	VPS_CLIENT_ON_RECEIVING_TEXT_BLANK Клиент прислал пустое текстовое сообщение
-22	VPS_CLIENT_ON_RECEIVING_PROTO_CONTENT_EMPTY Клиент прислал proto-сообщение с пустым полем content
-23	VPS_CLIENT_ON_RECEIVING_USER_ID_BLANK Клиент прислал proto-сообщение с пустым полем user_id
-26	VPS_CLIENT_ON_RECEIVING_TOKEN_BLANK Клиент прислал proto-сообщение с пустым полем token
-27	VPS_CLIENT_ON_RECEIVING_LAST_TWICE Клиент прислал proto-сообщение с last = 1 несколько раз в рамках одного msgId
-28	VPS_CLIENT_ON_RECEIVING_LAST_INVALID Клиент прислал proto-сообщение с last = 1, затем с last = -1 в рамках одного msgId
-29	VPS_CLIENT_ON_RECEIVING_DEVICE_BLANK Клиент прислал первым сообщение не deviceProto
-33	VPS_CLIENT_ON_RECEIVING_SYSTEM_MESSAGE_BLANK Клиент прислал пустое systemMessage
-36	VPS_CLIENT_ON_RECEIVING_CLIENT_HOST_INVALID Хост клиента не соответствует списку server.client-hosts-whitelist
-37	VPS_CLIENT_ON_RECEIVING_USER_CHANNEL_BLANK Клиент прислал proto-сообщение с пустым полем user_channel
-39	VPS_CLIENT_ON_RECEIVING_USER_CHANNEL_INVALID Клиент прислал proto-сообщение с user_channel, который не указан в app.channels-whitelist
-41	VPS_CLIENT_ON_RECEIVING_SYSTEM_MESSAGE_WITH_RESERVED_KEY system_message содержит зарезервированные ключевые слова, такие как token и т. д.
-42	VPS_CLIENT_ON_RECEIVING_TTS_ENGINE_INVALID Клиент прислал settingsProto с неизвестным tts_engine
-43	VPS_CLIENT_ON_RECEIVING_ASR_ENGINE_INVALID Клиент прислал settingsProto с неизвестным stt_engine
-44	VPS_CLIENT_ON_RECEIVING_ECHO_OVERRIDE_DISALLOWED Клиент прислал settingsProto с echo = false
-45	VPS_CLIENT_ON_RECEIVING_AUTH_UNSUCCESSFUL Клиент прислал proto-сообщение, в котором значение поля token не прошло проверку в auth-connector канала клиента
-46	VPS_CLIENT_ON_RECEIVING_TOKEN_CHANGED Клиент прислал proto-сообщение с новым значением поля token в рамках одной сессии
-47	VPS_CLIENT_JWE_TOKEN_EXPIRED Срок действия JWE-токена истек
-48	VPS_CLIENT_ON_RECEIVING_UNKNOWN_AUTH_CONNECTOR Клиент прислал settingsProto с неизвестным auth_connector
-49	VPS_CLIENT_ON_RECEIVING_BYTES_BLANK Клиент прислал пустой message.bytes.data
-50	VPS_CLIENT_ON_RECEIVING_INITIAL_SETTINGS_BLANK Блок initial settings обязателен для заполнения в первом сообщении от клиента (в случае, если версия протокола 3 и выше)
-51	VPS_CLIENT_ON_RECEIVING_INITIAL_SETTINGS_TWICE Клиент отправил блок initial settings дважды, однако его необходимо отправить только в первом сообщении (в случае, если версия протокола 3 и выше)
-53	VPS_CLIENT_ON_RECEIVING_DUBBING_OVERRIDE_DISALLOWED Клиент прислал settingsProto с dubbing = true
-54	AUTH_UNEXPECTED_ERROR Неожиданная ошибки аутентификации
-56	AUTH_RESPONSE_TIMEOUT Таймаут при вызове сервиса аутентификации (ЕСА или иная)
-57	AUTH_CONNECTION_ERROR Ошибка подключения к сервису аутентификации, например, из-за невалидного сертификата, URL и т. д.
-58	AUTH_INTERNAL_SERVER_ERROR HTTP-ошибка со стороны сервиса аутентификации
-59	AUTH_CONNECTION_TIMEOUT Нет соединения с auth-движком
-61	VPS_CLIENT_ON_RECEIVING_SURFACE_INVALID Клиент прислал в proto-сообщении поле message.device.surface со значением, которое отсутствует в конфиге или выключен enabled: false
-63	VPS_CLIENT_ON_RECEIVING_SURFACE_MISSING Поле surface не заполнено
-65	VPS_CLIENT_ON_RECEIVING_RESTRICTED_AUTH_CONNECTOR Смена типа аутентификации
-66	VPS_CLIENT_ON_RECEIVING_RESTRICTED_TTS_ENGINE Смена TTS-движка
-67	AUTH_ESA_CLIENT_ID_MISMATCH Возвращенный от ESA clientId не соответствует clientId, который задан для этого канала или поверхности в конфигурации сервиса
-68	VPS_CLIENT_TOO_MANY_NAMELESS_SYSTEM_MESSAGES Превышено количество системных сообщений без имени, полученных в одном запросе
-69	VPS_CLIENT_TIMEOUT_WAITING_FOR_COMPLETE_REQUEST Превышен таймаут на получение частей запроса

Виртуальные ассистенты тоже иногда ломаются. Предлагаю немного подождать, пока меня починят

Код ошибки	Описание
-1000	NLP_CONNECTION_ERROR Попытка соединения с KIS/NLP в рамках запроса клиента завершилась ошибкой
-1001	NLP_INTERNAL_SERVER_ERROR Взаимодействие с KIS/NLP закончилась внутренней ошибкой сервера на стороне KIS/NLP (HTTP CODES: 500, 503)
-1002	NLP_RESPONSE_TIMEOUT Взаимодействие с KIS/NLP прервалось по таймауту ожидания ответа от KIS/NLP
-1003	NLP_REQUEST_SERIALIZATION_ERROR Не получилось корректно собрать JSON для KIS/NLP из полученных данных от клиента/ASR/Smartbio/SDP
-1004	NLP_PAYLOAD_WITH_MALFORMED_JSON_ERROR Невалидный JSON в ответе от NLP/KIS
-1005	NLP_RESPONSE_BLANK От KIS/NLP пришло пустое поле payload
-1006	NLP_REQUEST_VALIDATION_ERROR От KIS/NLP пришел HTTP-код ответа 400 BAD_REQUEST
-1007	NLP_UNEXPECTED_RESPONSE_CODE_ERROR От KIS/NLP пришел неизвестный HTTP-код ответа (отличный от 200, 400, 500, 502, 504. Обычно это означает ошибку файрвола (SOWA)
-1008	NLP_TOO_MANY_REQUESTS_ERROR Слишком много сообщений от одного userId или sub. Nginx между VPS и KIS/NLP возвращает HTTP-код ответа 429.
-1009	NLP_RETURNED_UNKNOWN_OR_RESTRICTED_TTS_CONFIG В ответе платформы содержатся неизвестные или запрещенные настройки синтеза голоса
-1010	NLP_RESPONSE_WITH_MALFORMED_JSON В ответе платформы содержатся невалидные JSON

Очень хочу продолжить наше общение, но какая-то ошибка не дает мне это сделать. Скоро все починят

Код ошибки	Описание
-2000	ASR_CONNECTION_ERROR Попытка соединения с ASR в рамках сессии клиента завершилась ошибкой
-2001	ASR_INTERNAL_SERVER_ERROR Взаимодействие с ASR в рамках сессии клиента завершилась внутренней ошибкой сервера на стороне ASR
-2002	ASR_NO_FINAL_RESPONSE Вызов ASR завершился без ошибки, но без финального ответа
-2005	ASR_RESPONSE_TIMEOUT Получение данных от ASR прервалось из-за превышения временного интервала между событиями получения частей ответа от ASR. Например, ASR слал ответы с большими интервалами, чем таймаут ожидания на стороне VPS
-2006	ASR_RESPONSE_EMPTY Взаимодействие с ASR дало пустой результат: поля text/normalizedText не содержат данных
-2007	ASR_RESPONSE_INVALID Полученный от ASR массив байтов не десериализуется в целевой proto-массив
-2008	TTS_CONNECTION_ERROR Попытка соединения с TTS в рамках сессии клиента завершилась ошибкой
-2009	TTS_COMMUNICATION_ERROR Взаимодействие с TTS в рамках сессии клиента закончилась неожиданной ошибкой, обработка которой отдельным статусом не предусмотрена
-2010	TTS_HTTP_ERROR Взаимодействие с TTS в рамках сессии клиента закончилось HTTP-ошибкой (например, 400, 500, 503 и т. д.)
-2014	TTS_RESPONSE_EMPTY Взаимодействие с STT дало пустой результат: пакеты с голосовыми данными не были получены
-3000	NLP_RESPONSE_VALIDATION_ERROR NLP передал в KIS невалидные данные — KIS уведомляет VPS об этом
-3001	NLP_RESPONSE_TIMEOUT Взаимодействие с ЕИС/KIS завершилось, так как истекло время ожидания ответа от Dialog policy

Никто не застрахован от ошибок, даже виртуальные ассистенты. Обещаю вернуться, как только меня починят

Код ошибки	Описание
-4100	SMART_BIO_CONNECTION_ERROR Попытка соединения с SMART_BIO в рамках сессии клиента завершилась ошибкой. Не отправляется клиенту, только логируется
-4102	SMART_BIO_ON_RECEIVING_WSS_BROKE_OFF При получении сообщений произошли ошибки (например, порвалось соединение во время получения). Не отправляется клиенту, только логируется
-4103	SMART_BIO_PROCESSED_MESSAGE_ERROR Ошибка при разборе сообщения от SMART_BIO. Не отправляется клиенту, только логируется

Возникли какие-то неполадки, но мы уже работаем над их устранением

Код ошибки	Описание
-4300	GET_HISTORY_DISABLED Выключена интеграция с сервисом подгрузки истории
-4301	GET_HISTORY_ERROR_NO_SUB Для подгрузки истории необходим sub, который получается в момент аутентификации. Если у канала/поверхности аутентификация выключена — история чата недоступна
-4302	GET_HISTORY_ERROR Ошибка при получении истории чата
-100009	ALREADY_ANSWERED VPS отвечает этим статусом на все сообщения в рамках messageId, на которые VPS уже отправил ответ клиенту (если клиент пришлет пакет по истечении интервала времени: app.delay-on-send-already-answered-status)
-100011	WEBSOCKET_SESSION_IDLE_TIMEOUT Если в рамках сессии в указанное в конфигурации время ничего не происходит (нет движения пакетов как по контракту VPS, так и сетевому ping/pong), сессия закрывается. Статус отбрасывается в prometheus и не отправляется клиенту
-100013	REQUEST_INVALIDATED Ошибка возникает при обработке логики споттера, когда от DEVICE SELECTOR приходит ответ не целевое устройство или когда валидация споттера завершилась ошибкой
-100014	REQUEST_LIMIT_REACHED Сработала защита от DDoS-атак