Маруся

подсказка

Маруся — голосовой помощник от компании Mail.ru.

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

Как работает Маруся?

Маруся выполняет различные задачи с помощью скиллов (навыков), дополнительных функций голосового помощника. Например, скилл «Заказать пиццу» или «Включить музыку».

Когда клиент выбирает нужный скилл, голосовой помощник переключает его на диалог с этим навыком. Навык обрабатывает всю информацию, которая поступает от клиента, пока диалог не закончится.

Aimylogic позволяет вам создавать свои собственные скиллы для Маруси, которые станут доступны для всех, кто будет использовать помощника.

Как создать скилл?

Скилл — это чат-бот, для которого вы выбираете голосового помощника в качестве канала публикации.

Перейдите в Aimylogic, разработайте сценарий, а затем опубликуйте бота в канал.

подсказка

Подробнее о том, как создать бота и как разработать сценарий

Особенности канала

• Если вы используете блок Изображение в сценарии, то:

  • высота используемых изображений должна быть не менее 600 пикселей, а соотношение сторон — не более 2:1;
  • необходимо заполнить поле Сервисный ключ доступа в настройках канала.

• Если вы хотите вставлять аудиофайлы, чтобы использовать в речи Маруси дополнительные звуки и эффекты:

  1. Опубликуйте их через разметку TTS в соответствии с документацией ВКонтакте.
  2. В сценарии бота добавьте блок Текст и активируйте опцию Разметка синтеза речи.
  3. В поле для разметки синтеза речи укажите реплику для Маруси и вставьте в нужном месте реплики полученную ссылку на аудио.

Если не использовать разметку TTS, вернется следующая ошибка:

WARN — Reply type audio is not supported for Marusia channel.

Как опубликовать скилл?

Когда ваш чат-бот готов, перейдите в раздел Каналы → Голосовые ассистенты и выберите из списка канал Маруся.

Маруся появится в списке каналов, к которым подключен ваш бот.

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

Как зарегистрировать скилл?

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

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

подсказка

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

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

предупреждение

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

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

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

У меня остались вопросы

Если у вас остались вопросы или вы столкнулись со сложностями, свяжитесь с командой Mail.ru по адресу marusia-support@corp.mail.ru.