Часто встречающиеся вопросы

Бот не отвечает на сообщение, которое явно должно быть понятно.

Проверьте отчёт о непонятых фразах — возможно, формулировка не входит ни в один из примеров намерения или вариантов вопроса в QnA. Добавьте эту формулировку как новый пример и дождитесь переобучения.

После изменения сценария что-то перестало работать так, как раньше.

Запустите сохранённые тестовые сценарии («Автотесты» → «Запустить все») — расхождение покажет, в каком именно диалоге и на каком шаге появилась разница. Подробнее — в разделе «Тестирование сценариев».

Я случайно всё испортил(а) в сценарии.

Если перед изменением была создана ревизия бота — откатитесь к ней через меню бота в списке («Откатить к ревизии»). Если ревизии не было — именно поэтому рекомендуется создавать её перед крупными изменениями, см. «Создание и управление ботами».

У бота рядом с названием значок предупреждения про язык.

Для одного из указанных у бота языков не установлена языковая модель на сервере — обратитесь к администратору платформы (раздел «Языки» в админ-панели). Если на странице «Языки» написано «Языковой сервер недоступен», сервер не запущен или не отвечает: обучение и распознавание намерений не работают, пока администратор его не запустит.

Обучение дошло до конца, а потом снова появилась кнопка «Обучить».

Обучение закончилось ошибкой. Нажмите «Обучить» ещё раз: если снова ошибка, откроется окно «Результат обучения» с причинами и советами. Если окно не появилось, посмотрите плашки состояния сервисов в верхней панели Studio: красная «Языки» или «NLU» значит, что служба остановилась (часто из-за нехватки памяти на сервере). См. «Если обучение не удалось».

Эмулятор открывается белым окном или не отвечает.

Посмотрите плашку «Сокеты» в верхней панели Studio. Жёлтая означает, что WebSocket заблокирован обратным прокси и платформа работает через обычные запросы: всё должно работать, но медленнее. Красная означает, что соединения с сервером нет: проверьте сеть и прокси и обновите страницу. Администратору: настройка прокси описана в руководстве инженера.

Всплыло сообщение «Сервер не ответил за 20 с» или «Нет связи с сервером».

Запрос не дошёл до сервера или сервер не успел ответить: он перезапускается, перегружен, либо пропала сеть. Подождите минуту и повторите действие. Посмотрите плашки состояния сервисов в верхней панели: красная «Сервер» значит, что платформа недоступна, жёлтая, что она только что запустилась. Если ошибка повторяется, закройте лишние вкладки платформы (каждая держит соединение с сервером) и сообщите администратору, указав время.

Красная шестерня справа внизу и подсказка «Конфигурация платформы изменена».

Файл конфигурации iqbot.config.json изменили после запуска сервера. Нажмите на шестерню: окно покажет, какие параметры изменились, и предложит перезагрузить сервер. Пока сервер не перезагружен, изменения не действуют.

QnA не отвечает, пока бот ждёт ответ в процессе (например, после вопроса о номере карты).

Так и задумано по умолчанию: пока процесс ждёт реплику, все сообщения идут ему. Если клиенты часто задают справочные вопросы посреди сценария, включите в настройках бота переключатель «Отвечать на вопросы из базы знаний, пока процесс ждёт ответа»: бот ответит из базы и останется на том же звене. См. «Настройки бота».

Как написать условие перехода по кнопке или намерению без кода?

В окне перехода выберите «Если нажата кнопка» (элемент с кнопками и кнопка) или «Если распознано намерение» (намерение и порог уверенности). Код пишется только для нестандартных условий, см. «Как построить сценарий диалога».

Можно ли использовать пробелы в названиях звеньев, процессов и намерений?

Да. Ограничение, требовавшее заменять пробелы на дефисы, снято — подробнее в разделе «Типы звеньев».

Чем звено ИИ-агента отличается от обычного звена с содержимым?

Обычное звено говорит заранее заданный текст или показывает меню с вариантами. Звено ИИ-агента отправляет запрос GPT-модели и показывает пользователю сгенерированный ответ — используйте его там, где заранее перечислить все формулировки вопроса нереалистично. Подробнее — в разделе «ИИ-агент на основе GPT».

QnA не срабатывает на вопрос пользователя, хотя формулировка похожа на заданную.

Проверьте, что в боте настроено распознавание языка (NLU) для нужного языка — без него QnA не сопоставляет свободный текст пользователя с формулировками вопросов. См. «База вопросов-ответов (QnA)».

Я забыл пароль или потерял телефон с приложением-аутентификатором.

Пароль: ссылка «Забыли пароль?» на странице входа (если администратор настроил почту) или временный пароль от администратора. Приложение-аутентификатор: войдите по одному из кодов восстановления, которые показывались при подключении, или попросите администратора сбросить второй фактор. См. «Вход в систему».

Кто и когда менял бота?

В админ-панели в меню бота выберите «История изменений»: там ревизии с авторами и комментариями, сравнение ревизии с текущим состоянием и журнал изменений файлов с именами пользователей. В Studio рядом с названием бота видны инициалы коллег, которые открыли его сейчас.