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

Маруся — голосовой ассистент от компании 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. Нажмите Сохранить.

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

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

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