Приветствие в навыке

У вас есть время поговорить о навыках?

Краткое вступление для новичков: навыки Алисы - это расширения возможностей Алисы, которые регистрируются на платформе Диалоги. 

Навыки отличаются от "компьютерных" программ-расширений (плагинов, дополнений) тем, что:

• навыки не нужно устанавливать на устройство, они всегда готовы к запуску;
• в любой момент всем пользователям доступны все активные навыки;
• визуально изучить все доступные навыки можно в едином каталоге (при необходимости оттуда же их и запустить);
• платформа постоянно проверяет навыки на их доступность; недоступный навык деактивируется и исчезает из каталога;
• для публикации навыка (появления в каталоге и возможности его запуска) необходима предварительная модерация;
• вебхук навыка должен быть размещён на домене, имеющем SSL-fullchain-сертификат или в Функциях Облака;
• к навыку предъявляется ряд требований платформы (включая, к примеру, лимит времени на ответ навыка).

К числу таких требований относится приветствие, и это не простая формальность.

Приветствие покрывает несколько ключевых нужд пользователя:

1. коротко рассказать о возможностях навыка (онбординг);
2. дать понять пользователю, куда он попал в принципе (информирование о состоянии);
3. ввести пользователя в атмосферу навыка (особенно, если навык игровой или развлекательный);
4. дать пользователю понять, что вы о нём помните и заботитесь (в том числе, использовав его имя в приветствии, если ранее вы его сохранили).

Мне не нужно приветствие, мой навык беспрерывно используют

Первое и главное: не стоит переоценивать общеизвестность своего навыка ) 
Также одна из нередких ошибок в разработке — то, что очевидно вам, как создателю, неочевидно и непонятно широкой аудитории пользователей.

Для сравнения, вводная фраза Алисы перед запуском любого из навыков звучит не первый год (а суммарный запуск всех явно больше любого отдельно взятого). И тем не менее, эта фраза до сих пор остаётся. Как вы думаете, почему? Как минимум по 1 и 2 пунктам из предыдущей главы.

И не забывайте, что:

• ваш навык может запустить гость или другой член семьи на том же устройстве;
• никто не обязан — и не будет — зубрить возможности навыка;
• не все одинаково легко и быстро адаптируются к голосовому взаимодействию;
• это вы, как разработчик, должны проактивно предоставлять информацию, а не пользователь тратить своё время и думать, как её раздобыть;
• навык вообще может быть запущен случайно и человек может не знать не только о вашем навыке, но и о том, что он вообще какой-то там навык (?) запустил.

К сожалению, не все разработчики понимают важность вступительного информирования (и не всем программистам легко даётся перестроить своё мышление под разработку Voice UI в целом). И немногие задумываются, что приветствие может быть и интересным.

Как можно разнообразить и построить приветствие?

Если вы сделали приветствие в духе "Здрамвствуймте, я мполезный мнавык и могу мпомочь" - неудивительно, что оно не нравится ни вам, ни пользователю, и слушать его каждый раз — одно огорчение (но, скорее всего, и сам навык при таком подходе мог бы быть лучше, чем он получился).

Что же можно сделать, чтобы приветствие стало и полезным и интересным?

Для этого можно использовать:

• случайные варианты приветствия (см "промпт-листы");
• художественно оформленные тексты;
• красивые аудиоподложки, настраивающие на вход в навык (игровые, фантастические, медитативные, отбивки по принципу телешоу);
• обращения, дающие понять, что вы рады возвращению пользователя (можно озвучить его имя, или его прогресс в игре, или состояние заказа из предыдущей сессии) и вложили в навык заботу и профессиональное внимание.

Не помешает упомянуть про команду "Помощь" даже знакомому пользователю (особенно, если управление навыком может быть неочевидным, или содержит малозапоминающиеся побочные функции: смена сложности, возможность сравнить свой рейтинг с другими пользователями или сбросить прогресс, или прослушать список ранее завершённых заказов).
Случайно выводимые напоминания о каждой такой функции при очередном запуске — тоже неплохая идея для улучшения как приветствия, так и опыта пользователя в навыке.

В любом случае стоит хорошо поработать над краткостью и лёгкостью текста, ведь приветствие навыка — по сути его лицо (или крыльцо, или вешалка, это уже по вкусу).

Когда приветствие действительно не нужно

А как быть, если надо быстро запустить навык для выполнения единственного действия и тут же его закрыть?

Платформа Диалоги предусматривает два варианта запуска навыков общего типа:

• Запусти навык %НАЗВАНИЕ_НАВЫКА%
• Попроси навык %НАЗВАНИЕ_НАВЫКА% %КОМАНДА_НАВЫКУ%

Второй вариант нам и нужен (кстати, при этом способе запуска не будет и вступительного текста Алисы).

В действительности, скорее всего, ваша команда будет состоять из двух частей — %СДЕЛАЙ_ЧТО% %С_ЧЕМ_И_КАК%, но платформе это безразлично, она полностью отдаёт строку как есть, оставляя все возможности её обработки разработчику.

Классическим примером можно считать навык " Часы-кукушка": при фразе

• "Алиса, запусти навык Часы-кукушка" — озвучит приветствие и даст выполнить любую тестовую команду, а при
• "Алиса, попроси Часы-кукушка отбить час с голосом" — немедленно запустит сэмпл, произнесёт время и сразу же закроется. При этом "отбить" можно отнести к %СДЕЛАЙ_ЧТО%, а остальной хвост - — к %С_ЧЕМ_И_КАК%. Но это деление, конечно, условно и индивидуально.

Так же работали и самые первые навыки управления умными устройствами ("Алиса, попроси Альфреда включить вентилятор").

Чтобы закрыть навык сразу после выполнения действия не забудьте отправить 
{
  "response": {
  ...
  "end_session": true
   },
   ...
}

Приветствие, Что ты умеешь и Помощь - разве не одно и то же?

Конечно, нет. Приветствие и его особенности мы уже рассмотрели подробно, перейдём к отличиям и этих требуемых платформой команд:

Что ты умеешь?

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

Но будет странно, если в начале снова прозвучит "Привет, я навык такой-то!"

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

Помощь

Если пользователь просит помощи, ему точно не нужно ни приветствия, ни рассказа о крутых возможностях этого супернавыка.

Он нуждается в чётком перечислении доступных команд (возможно, и сухом информировании о статусе пользователя, если статус влияет на список доступных команд).

Если ваш навык ориентирован на далёкий от мира IT сегмент (например, пожилых людей), будет неплохо продублировать команды, которыми можно выйти из навыка, несмотря на то, что при запуске вашего навыка Алиса уже их озвучила.

Примеры

Первый заход в навык:

Плохо	Хорошо
Я навык, который знает очень много загадок про животных, птиц и рыб! Я буду спрашивать, а ты отвечать на мои интересные вопросы.	Привет! Я расскажу тебе, почему дельфины не рыбы, а арбуз - это ягода. Но для этого тебе тоже надо будет ответить на мои вопросы ;)
В первом случае навык хвастает своими абстрактными достижениями, которые мало интересны пользователю. Во втором случае — объяснили механику игры (ответ на вопрос и интересный факт в качестве приза); и привели для затравки интересные примеры.
Привет, я игра в пиратов. Задача игры — захватить больше ценных грузов и кораблей и переходить на новые уровни.	Хэй, юнга! Ты готов стать настоящим морским волком? Больше кораблей, больше золота, больше влияния на море!
В первом случае мы формально описали и без нас очевидные действия. Во втором — немедленно погрузили игрока в мир навыка, а ту же самую механику подали намного привлекательней.

Повторный заход в навык:

Плохо	Хорошо
Привет, я игра в пиратов. Задача игры...	С возвращением на борт, Сергей! Ты уже вырос от сопливого юнги до бывалого матроса, осталось добыть 500 монет — И ты уже канонир самого Дрейка!
В плохом приветствии мы не заметили, что игрок в нашем навыке повторно. В хорошем - не только отметили это, но и рассказали про его прогресс в игре.