Запуск и выход из навыка

  1. Запуск навыка
  2. Учтите при настройке навыка
  3. Выход из навыка

Когда пользователь запускает навык, Алиса передает слово навыку до тех пор, пока он не будет деактивирован.

Запуск навыка

Разговор с навыком всегда начинает сам пользователь — навык может только отвечать на запросы. Есть два способа начать разговор:

  • Просто запустить — пользователь просит Алису запустить навык, навык запускается и приветствует пользователя.
  • Запустить с командой — пользователь сразу говорит, в каком навыке и что надо сделать.

Для каждого способа свои волшебные фразы, которые активируют навык:

  • «запусти навык [активационное имя]»;
  • «запусти чат с [активационное имя]»;
  • «давай поиграем в [активационное имя]»;
  • «сыграем в [активационное имя]».

Например, «Алиса, поиграем в города».

Все возможные команды смотрите в консоли: откройте навык → вкладка Настройки → раздел Публикация в каталоге → поле Примеры запросов.

Примечание. Навыки умного дома не требуют активационной фразы — они работают как встроенные сценарии Алисы. Например, «Алиса, включи свет на кухне».

Учтите при настройке навыка

  • Добавляйте все возможные активационные имена. Например, для названия «S7» можно добавить активационные имена: «эс севен», «эс семь» и «авиакомпания сибирь». Так Алисе будет проще изучить название навыка и она быстрее научится распознавать его.
  • Добавляйте активационные имена в правильных склонениях. Например, для навыка «Крокодил» можно добавить активационное имя «крокодила», и использовать его во фразе «давай поиграем в крокодила».
  • Активационная фраза закрепляется за навыком в момент публикации даже для приватных навыков, и с этого момента не может быть занята другими навыками.
  • В некоторых приложениях, например в приложении Яндекс, для каждого нового навыка Алиса открывает отдельную вкладку, между которыми может переключаться пользователь.

Выход из навыка

Когда разговор подошел к логическому концу, передайте в ответе флаг "end_session": true.

Пользователь в любой момент может сам попросить Алису выйти из навыка, с помощью фраз: «Алиса, вернись», «Алиса, хватит», «Закончить» или «Выйти».

Если что-то пошло не так, диалог прекратится автоматически:

  • Навык прислал ответ, который не соответствует формату.
  • Навык не успел ответить за 3 секунды.