JAICP

Голосовой помощник Маруся


Маруся — голосовой ассистент от компании Mail.ru. Маруся распознает естественный язык, имитирует живой диалог, дает ответы на вопросы пользователя и решает прикладные задачи.

Чтобы подключить Марусю как входящий канал:

  1. Создайте канал в JAICP.
  2. Зарегистрируйте скилл.
  3. Протестируйте бота.

Создание канала в JAICP

Перейдите в платформу JAICP, нажмите на панели управления Каналы > Создать канал. В разделе Голосовые ассистенты выберите Маруся.

Заполните поля:

  • Название — укажите название для канала или оставьте по умолчанию.
  • Токен — оставьте пустым.
  • Сервисный ключ доступа — оставьте пустым.
  • Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
  • Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).

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

Нажмите Создать. Дождитесь всплывающего окна с результатом деплоя.

Под названием созданного канала нажмите Получить вебхук. URL хука будет скопирован в буфер обмена. Он понадобится вам далее при регистрации скилла.

Регистрация скилла

Чтобы зарегистрировать скилл, откройте раздел для разработчиков ВКонтакте.

  1. Перейдите на вкладку Мои приложения.
  2. Нажмите Создать.
  3. В качестве Платформы выберите Скилл Маруси.
  4. Заполните Название. Оно будет использоваться для активации скилла.
  5. В поле Webhook URL вставьте вебхук, который вы скопировали при создании канала в JAICP.
  6. Нажмите Создать скилл. После модерации навык станет доступен для всех пользователей Маруси.

Ознакомьтесь с дополнительной информацией о публикации скилла в документации ВКонтакте.

Сервисный ключ доступа

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

  1. В разделе для разработчиков ВКонтакте напротив созданного скилла нажмите Редактировать.
  2. Перейдите в раздел Настройки > Общая информация о скилле.
  3. В строке Сервисный ключ доступа нажмите   .
  4. Скопируйте ключ.
  5. Перейдите в настройки канала Маруся на стороне JAICP.
  6. В поле Сервисный ключ доступа вставьте скопированный ключ.
  7. Нажмите Сохранить.

Теперь ваш бот сможет отсылать изображения, предусмотренные в сценарии.

Тестирование

Вы можете протестировать сценарий бота на устройстве с голосовым помощником Маруся. Для этого вызовите навык активационной фразой.