Dialogflow

Интеграция с Dialogflow позволяет вам использовать чат-бота в чате Carrot quest.

Настройка интеграции

 

Интеграция с Dialogflow позволяет вам использовать чат-бота в чате Carrot quest. Если вы не знакомы с интерфейсом Dialogflow, то можете посмотреть нашу инструкцию минимальной настройки бота с примерами запросов от пользователя.

Важно! Бот будет реагировать на все не разобранные диалоги (то есть, те у которых нет назначенного оператора), но не будет отвечать в диалогах, начатых с помощью автосообщений.

 

Для того, чтобы настроить интеграцию, зайдите в консоль Dialogflow и создайте новый агент (или используйте уже существующий, если вы уверены в нём).

Заполните имя, язык и временную зону по-умолчанию. При выборе языка учтите, что мы будем передавать в запросе настроенный у вас язык чата.

Перейдите в настройки агента и установите версию API V2.
Важно! При переключении уже существующего агента с V1 на V2 убедитесь, что все настройки совместимы с V2. Воспользуйтесь для этого гайдом по миграции от Google.

Нажмите на поле "Service Account", чтобы перейти в раздел для работы с Сервисными аккаунтами Google Cloud Platform.


Нажмите кнопку "+ Создать сервисный аккаунт".
Важно! Не используйте для интеграции аккаунт, указанный в поле "Service Account". Этот аккаунт используется Google.

Введите название сервисного аккаунта и, при необходимости, описание. Выберите "говорящее" название, чтобы в будущем можно было легко найти аккаунт, связанный с нашей интеграцией.

В качестве роли для этого аккаунта выберите "Клиент Dialogflow API".

Создайте JSON-ключ. Сохраните себе файл, предоставленный Google для скачивания, содержащий ключ.
Важно! Вы можете скачать файл с этим ключом только один раз. Для повторного скачивания вам придётся создать новый ключ.

Установите в настройках интеграции Carrot quest версию API V2 и загрузите файл, содержащий JSON-ключ. Вы всегда можете загрузить другой ключ при редактировании интеграции.

Укажите название интеграции и сохраните её.
 

Настройка бота в Dialogflow

 

После того, как вы настроили интеграцию Carrot quest и DialogFlow можно начинать обучать бота ответам.

Принцип его настройки очень прост: прописываются варианты фраз от пользователя и ответы бота на них. Каждый ответ бота добавляется через настройку Intents. Изначально у всех ботов есть два ответа по умолчанию:
Default Fallback Intent - используются в том случае, когда бот не понимает запроса (вы можете отключить этот набор ответов, чтобы бот отвечал только на запросы, которые узнал);
Default Welcome Intent - реакция бота на приветствие от пользователя.

Чтобы добавить свой первый вариант ответа, нажмите на Create Intent.

 

Здесь нам потребуются заполнить минимум три параметра:
Intent name - название (рекомендуем использовать латиницу, так как многие возможности Dialogflow не будут доступны, если называть Intents на кириллице),
Training phrases - варианты запросов от пользователя,
Responses - ответ бота.

Для примера добавим Intent по запросу о стоимости тарифа. В Training phrases прописываем варианты словосочетаний от пользователя. Рекомендуем не использовать одиночные слова, так как высока вероятность, что бот ответит не то, что нужно. Не переживайте, если не сможете с первого раза подобрать все возможные варианты запросов, добавить или удалить отсюда параметры вы сможете в любой момент.

Далее - прописываем ответ бота (он может быть единым для всех вариантов запросов пользователя из этого Intent) и сохраняем настройку.

Проверить, понимает ли бот запрос, можно прямо в настройках в Dialogflow. Справа есть тестовая панель. В поле Try it now введите запрос от пользователя, ниже, в поле Defaul Response, отобразится ответ бота.

Примеры Intents

Мы подготовили для вас несколько примеров использования бота, но рекомендуем в первую очередь заглянуть в свои сохраненные ответы для операторов чата (это будет отличной подсказкой для вас, с чего начать).

Важно! После импорта примеров не забудьте изменить ссылки на актуальные для вашего сайта.

Запросы по доставке и вариантах оплаты

Восстановление пароля

Запросы по подбору тарифа и его стоимости

Ссылки на ваши приложения для различных устройств

Как импортировать Intents

В разделе Intents нажмите на вызов меню рядом с кнопкой Create Intent и выберите Upload Intent.

Нажмите на Choose File и выберите файл JSON на своем компьютере.

После успешного импорта справа внизу появится уведомление. Теперь загруженный Intent доступен в общем списке для редактирования и тестов.

Пример общения пользователя с ботом

 

Работает на Carrot quest