скилл маруси что это

Скилл маруси что это

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

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

Список всех скиллов Маруси можно изучить в каталоге.

Создать скилл можно двумя способами:
1. Использовать конструктор Aimylogic, который позволяет собрать необходимый сценарий в визуальном редакторе и получить готовый webhook, который в свою очередь уже можно зарегистрировать в качестве скилла Маруси.
2. Написать код самостоятельно. Для этого изучите документацию. В ней подробно описан протокол, по которому взаимодействует Маруся с внешними навыками, как работать с TTS, как работать со звуками и изображениями. Код приложения может быть написан на любом удобном вам языке и размещен на любом сервере. Главное, чтобы Webhook был доступен из интернета и воспроизводил протокол Маруси из документации.

После того, как вы создадите скилл, вам необходимо его зарегистрировать и отправить на модерацию. Для этого выполните следующие действия:
1. Создайте приложение в разделе для разработчиков.
2. Выберите Скилл Маруси в типах приложения.
3. Добавьте название, которое будет совпадать с командой для активации скилла.
4. Введите в поле Webhook URL адрес сервера, по которому будет размещён навык, например https://example.com/test-webhook.
5. Нажмите на кнопку Создать скилл.

Вы попадёте в интерфейс администрирования скилла.

Все изменения полей скилла становятся доступны в Марусе примерно через 1-2 минуты

В день можно добавлять не более 3 скиллов, за 5 дней — не более 10.

Фразы для вызова должны быть специфичными и уникальными, чтобы мы могли использовать их для внешних скиллов. Например, фразу «Расскажи анекдот» мы добавить не сможем, так как она уже используется во внутренних скиллах Маруси. А вот фразу «Давай сделаем код-ревью» — пока можно использовать для внешнего скилла.

Обратите внимание: имя будет являться первой фразой-триггером для вызова скилла.
Длина фразы активации не может превышать 64 символа.

Источник

Написание навыка для голосового помощника «Маруся»

Всем привет, меня зовут Денис. Я хотел бы рассказать о своем опыте разработки навыка для голосового помощника «Маруся».

«Маруся» — голосовой помощник, разработанный в компании Mail.ru Group. Запущен 17 июня 2019 года в тестовом режиме.

Пункт 1: ознакомление с API Маруси

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

С полной схемой взаимодействия с Марусей можно ознакомиться в документации. Здесь я опишу основные моменты:

Фаза вызова скилла строится по следующей схеме:

Слово «Маруся» + любая из дефолтных фраз вызова скилла + фраза активации.

К дефолтным словам относятся: хочу, запусти, включи, открой + навык/скилл.
«Маруся, запусти навык шутка дня», «Маруся, включи скилл шутка дня».

Структура запроса

meta
object

информация об устройстве, с помощью которого пользователь общается с Марусей.

request
object

данные, полученные от пользователя.

session
object

version
string

версия протокола, текущая версия — 1.0.

Пункт 2: общение Маруси и сервера

Сервер и Маруся общаются посредством POST запросов. В данной статье не будет рассматриваться построение сервера, т.к. статей на данную тему предостаточно.

Я хотел бы рассмотреть как происходят вопросы и ответы между Марусей и клиентом.

А происходят они по следующей схеме:

1) Клиент запускает скилл.

2) Маруся отвечает фразой с сервера, соответствующей нажатой кнопке клиентом. Если это начало выполнения навыка Маруся отображает первую фразу.

3) Клиент нажимает на предложенный вариант (предложенных вариантов может быть несколько).

4) Переходим к пункту 2, пока клиент не захочет завершить сессию.

Чтобы завершить сессию, необходимо в ответе указать параметр end_session, выставленным в 1 (true). Пример:

Пункт 3: Тестирование приложения

Есть несколько вариантов тестирования приложения:

1) написав Марусе с личной страницы;
2) в отладчике скилов;
3) в приложении Маруси для Android или iOS

Источник

Как разговорить Марусю: FAQ по созданию скиллов для голосового ассистента

Голосовые помощники как технология возникли благодаря развитию целого созвездия других технологий. И одним из таких голосовых помощников стала Маруся, относительно недавно созданная в Mail.ru Group. В её основе лежат последние разработки компании в области распознавания речи, машинного обучения и быстрой обработки крупных массивов данных. Маруся — это диалоговая платформа. Она способна взаимодействовать с человеком не только звуком, но и посредством изображений или текста. Есть много ситуаций, в которых она ответит не голосом, а изображением, текстом или ссылкой.

Маруся дебютировала еще в прошлом году, а первое устройство с этим ассистентом появилось в апреле 2020. Компания развивает его, делает умнее и наполняет библиотеку скиллов. В частности, ассистент стал лучше понимать пользователя, улучшился TTS. Кроме того, Маруся научилась управлять умным домом. В июне 2020 года Mail.ru Group открыла возможность создавать свои собственные скиллы. С тех пор протокол сильно прокачался и возможности ассистента намного выросли, а для разработчиков появился отладчик, где можно протестировать созданные скиллы.

Содержание:

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

В основе работы Маруси лежит система «скиллов» или, по-русски, «навыков». Это крохотные диалоговые приложения, в которых прописаны реакции и действия голосового помощника в ответ на определённые голосовые запросы. Этакие микросервисы, если вы знакомы с этой программной архитектурой. Пользователи взаимодействуют со скиллами Маруси, которая может быть встроена в самые разные устройства и отдельные программы. Причём у устройств могут быть сенсорные экраны или только голосовые интерфейсы.

На сегодняшний день Марусю поддерживают:

2. Как сделать скилл полезным

Прежде чем начать создавать скилл, постарайтесь абстрагироваться от всех инструментов и процессов. Представьте, что пользователь разговаривает не с устройством, а просит выполнить свою задачу какого-нибудь специалиста. Задумайтесь: «Если бы вместо моего скилла был человек, идеально выполняющий эту задачу, как бы он общался с заказчиком?» Распишите по шагам, как будет проходить этот диалог, какой информацией будут обмениваться заказчик и исполнитель. Учитывайте, что диалог и сценарий использования может отличаться для Маруси в умной колонке и в приложении. В приложении вы можете часть информации вынести в визуальный интерфейс, а в умной колонке доступно только голосовое управление.

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

После оттачивания сценария нужно продумать интерфейс. Для проверки его удобства рекомендуем второй важный чек-лист — usability-эвристики Нильсена (на русском). По нему проверьте ключевой сценарий и все подзадачи и ответвления. Чек-лист покажет, доносите ли вы всеми необходимыми способами пользователю сигналы о том, что скилл сработал и как он сработал. А заодно поможет правильно обработать ошибки: не просто выдав уведомление, а с пояснением, что делать дальше.

А еще мы советуем использовать длинное тире (—) в диалогах с пользователем, а в качестве кавычек использовать только начертание, принятое в русской типографике — «ёлочки». И не забывайте, что Маруся обращается на «вы» в независимости от возраста пользователя.

3. Как создать скилл для Маруси

4. Как перенести скилл из других ассистентов

Если у вас уже есть скилл, созданный на платформе AImylogic, то для подключения его к Марусе достаточно выбрать канал Маруся в настройках и следовать инструкции. Более подробную информацию можно прочитать на странице платформы. При этом все разработчики, которые создают скиллы для Маруси с помощью Aimylogic, могут хостить эти скиллы бесплатно. Для этого есть специальный тариф — Skillmaster.

На что стоит обратить внимание при переносе скилла:

5. Как устроена среда отладки скиллов

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

Она позволяет не публикуя скилл опробовать его на любом клиенте Маруси. Для начала работы достаточно указать среде Webhook URL разрабатываемого скилла. При этом нет необходимости выкладывать его в сеть — разработчик может подключить к тестовой среде скилл, развёрнутый на своём компьютере, указав локальный адрес, например:

Подключенный к среде скилл можно тестировать в любом клиенте Маруси: на колонке «Капсула», в мобильном приложении, во ВКонтакте или во встроенном в среду эмуляторе. Разработчик может переопределять некоторые параметры клиента, передаваемые в скилл: временную зону, геолокацию, язык интерфейса, признак наличия дисплея — это удобно для тестирования сценариев работы скилла.

Тестовая среда воссоздаёт production-окружение Маруси, поэтому уже на ранних этапах реализации разработчик может убедиться, что скилл правильно интегрируется с платформой. Если он возвращает ошибку, отвечает долго, или ответ от скилла не соответствует протоколу, то среда выведет соответствующее сообщение. Также среда отображает лог JSON-сообщений между скиллом и платформой, что помогает искать ошибки в бизнес-логике работы скилла.

6. Как добавить скилл через ВКонтакте

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

Обратите внимание: имя является первой фразой-триггером для вызова скилла. Фразы должны быть специфичны и уникальны, чтобы мы могли использовать их для внешних скиллов. Например, фразу «Расскажи анекдот» добавить не сможем, т.к. она уже используется во внутренних скиллах Маруси. А вот «Давай сделаем кодревью» пока можно использовать. Длина фразы активации не может превышать 64 символа.

7. Как осуществляется модерация скиллов

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

Каких правил нужно придерживаться, чтобы ваш скилл для Маруси был успешно допущен к использованию:

8. Как добавлять изображения в Марусю

9. Как добавлять звуки в Марусю

Источник

Marusia Skill Lab

Создавайте скиллы для голосового помощника и получайте призы. Новый раунд — каждые 2 месяца. Вы разрабатываете — Маруся учится!

Marusia Skill Lab — чемпионат для разработчиков самого разного уровня подготовки. Создавать скиллы для Маруси не так уж и сложно, поэтому участвовать могут даже новички. Вы прокачаете свои навыки и получите за это призы. А Маруся — станет ещё умнее.

Чемпионат проходит каждые 2 месяца

в форме тематических раундов. Например, тема I раунда была — разработка обучающих скиллов для детей.

Регистрация и ожидание темы раунда

Объявление темы раунда

Обучающие скиллы для детей

Разработка и тестирование скиллов в песочнице

Публикация в каталоге скиллов Маруси

Результаты: авторы 3-х лучших скиллов получат призы

Новый раунд на другую тему

Критерии для оценки

Больше всего мы ценим оригинальность, поэтому главный приз получит скилл, которого ещё нигде нет!

+ умная колонка Капсула и промо вашего скилла

+ умная колонка Капсула Мини
и промо вашего скилла

+ 50 000 бонусных рублей на облачной платформе VK Cloud Solutions

Частые вопросы

Я автор скилла для другого голосового помощника. Можно ли участвовать с этим скиллом?

Да, вы можете участвовать.

Хочу участвовать сразу с несколькими скиллами. Это не запрещено?

Совсем нет. Более того, вы можете занять несколько призовых мест.

Я уже участвовал в предыдущем раунде чемпионата. Могу ли снова стать участником?

Конечно! Мы не ограничиваем вас в этом.

Мне ещё нет 18 и я не гражданин РФ. Можно участвовать?

К сожалению, нет. К участию допускаются только совершеннолетние граждане РФ.

У нас команда разработчиков. Примите коллективную заявку?

Да, если в вашей команде не больше трёх человек.

Как зарегистрировать команду?

1. Каждый участник команды регистрируется на платформе All Cups.
2. На support@cups.online нужно написать название команды и логины участников на сайте.
3. Загружать все материалы нужно от одного участника команды.

Где можно больше узнать о создании скиллов для Маруси?

Проводит ли VK другие чемпионаты?

Мы регулярно устраиваем собственные чемпионаты и совместно с партнерами. Следите за анонсами на сайте All Cups.

Источник