Перейти к основному содержимому

Яндекс Алиса

Алиса — это голосовой помощник от компании Яндекс, который умеет поддерживать диалог с пользователем и выполнять различные действия в приложении или на устройстве, где запущена Алиса.

Алиса работает в мобильном приложении Яндекс.Поиск на Android и iOS, в Яндекс.Навигаторе, в десктопной версии Яндекс.Браузера для Windows, а также на голосовой аудио-колонке Яндекс.Станция.

Сторонние разработчики могут создавать для Алисы дополнительные функции — навыки. Эти навыки доступны пользователям на всех платформах, где работает Алиса.

Как работают навыки​

Для Aimylogic навык Алисы — это чат-бот с определенным сценарием.

подсказка
Полный список навыков Алисы

Чтобы воспользоваться навыком, пользователь должен активировать его одной из специальных фраз. Вы указываете эти фразы в Яндекс.Диалогах, когда создаете навык. После этого Алиса переключает пользователя на диалог с навыком, и все запросы пользователя отправляются к нему.

Запустить навык в приложении с Алисой или на умном устройстве можно следующими способами:

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

Активационное имя — это фраза, по которой активируется навык. По умолчанию активационное имя совпадает с именем навыка.

Запуск без команды возможен подобными фразами:

  • Запусти навык активационное имя
  • Запусти чат с активационное имя.
  • Сыграем в активационное имя.
  • Давай поиграем в активационное имя.

Пример запуска без команды: Запусти чат с Just AI.

Запуск с командой возможен подобными фразами:

  • Скажи активационное имя команда
  • Узнай у активационное имя команда
  • Попроси активационное имя команда
  • Спроси у активационное имя команда

Пример запуска с командой: Узнай у Just AI, когда пройдет Conversation.

Чтобы выйти из навыка, пользователю нужно произнести одну из фраз:

  • Алиса, вернись.
  • Алиса, хватит.
  • Стоп.
  • Закончить.
  • Выйти.

Навык автоматически прекратит работу, если:

  • Бот пришлет ответ, не соответствующий формату.
  • Бот будет отвечать дольше 4.5 секунд. В этом случае бот отправит пользователю сообщение о том, что навык не отвечает.
подсказка
Подробнее о запуске навыков

Создайте навык для Алисы​

  1. Продумайте, как должен работать ваш навык. Чем подробнее вы продумаете логику работы навыка, тем проще вам будет его создать.
  2. Создайте сценарий, по которому будет работать бот для навыка Алисы. ! > Яндекс предъявляет ряд требований к навыкам, которые нужно учитывать при создании сценария.
  3. Подключите бота к каналу Алиса.
  4. Получите вебхук канала.
  5. Создайте навык в консоли разработчика Яндекс.
  6. Опубликуйте навык.

Добавьте канал Алиса​

  1. В сценарии для Алисы перейдите на вкладку Каналы.

  2. В секции Голосовые ассистенты выберите Алиса. Откроется окно настроек канала.

  3. Нажмите Получить OAuth-токен. Вы будете перенаправлены на страницу авторизации в Яндекс.

    Подключение канала Алиса

  4. Авторизуйтесь по Яндекс ID. После авторизации вы будете перенаправлены на страницу с OAuth-токеном.

  5. Скопируйте токен и вставьте его в поле OAuth-токен в настройках канала в Aimylogic.

  6. При желании отредактируйте название канала.

  7. Нажмите Подключить.

Получите вебхук канала​

Чтобы создать ваш навык в Яндекс.Диалогах, вам потребуется вебхук канала на стороне Aimylogic. На этот вебхук Алиса будет отправлять запросы пользователя после того, как навык будет активирован.

Нажмите Получить webhook рядом с подключенным каналом, чтобы скопировать вебхук в буфер обмена.

Создайте навык в консоли разработчика​

Чтобы ваш навык начал работать в Алисе, его нужно создать в Яндекс.Диалогах.

  1. Зайдите на страницу Яндекс.Диалоги и нажмите Создать Диалог.
  2. Выберите Навык в Алисе в качестве типа диалога.
  3. Укажите имя для навыка. ! > Если вы создаете публичный навык, убедитесь, что навыка с таким названием нет в официальном списке навыков.
  4. В секции Backend выберите опцию Webhook URL и вставьте вебхук.
  5. Нажмите Сохранить.

Протестируйте навык​

Вы можете протестировать работу вашего навыка для Алисы в интерфейсе Яндекс.Диалогов. Для этого перейдите на вкладку Тестирование и отправьте сообщение боту.

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

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

Опубликуйте навык​

Пока вы не опубликуете навык, он будет недоступен пользователям Алисы. Чтобы опубликовать его, в настройках навыка:

  • добавьте примеры активационных фраз;
  • выберите категорию;
  • добавьте описание навыка;
  • загрузите иконку.
подсказка
Подробнее о публикации навыка

Когда вы добавите всю необходимую информацию о навыке, отправьте его на модерацию. Обычно Яндекс проводит модерацию в течение трех дней.

Если ваш навык не прошел модерацию, исправьте замечания и отправьте его на модерацию снова.

После прохождения модерации зайдите в настройки навыка в Яндекс.Диалогах и нажмите Опубликовать.