Коды ошибок 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-атак |