Публикация навыка

Чтобы опубликовать навык:

  1. Зарегистрируйте его в Консоли разработчика.
  2. Задайте настройки навыка:

  3. Проверьте, что навык отвечает корректно.
  4. Опубликуйте навык, когда он будет одобрен.

Основные настройки

Имя навыка

Название навыка в каталоге. С его помощью пользователи смогут запустить навык. Пример команды для активации: «Запусти навык [название]».

Название навыка должно:

  • Состоять не менее чем из 2 слов (рекомендуется использовать не более 4 слов). Предлоги, союзы и частицы не учитываются. Допускается название из 1 слова, если это уникальное название бренда. Ознакомьтесь с дополнительными требованиями к брендированным навыкам.
  • Быть уникальным.
  • Быть написанным на русском или английском языке.
  • Не ограничиваться общей категорией товаров, сервисов или контента (например, «пластиковые окна»).
  • Не содержать слов «Алиса», «Яндекс» или «Станция».
  • Быть развернутой/сокращенной формой активационного имени или быть именительным падежом его склонения.
  • Отвечать остальным формальным требованиям.

Если название навыка содержит выдуманное слово или незнакомый бренд, Алиса может не распознать его. Чтобы обучить Алису этому слову, потребуется 2-3 недели (после публикации навыка). Если для вашего слова возможны разные варианты написания или произнесения, добавьте несколько активационных имен. Так Алисе будет проще обучиться.

Если спустя 3 недели Алиса по-прежнему не будет распознавать ваш навык, следует придумать другое название. Пожалуйста, сообщите об этом в форме обратной связи. Укажите название навыка, который Алиса не научилась распознавать. Это поможет нам разобраться с проблемой и улучшить качество обучения Алисы.

Активационное имя

Дополнительная фраза, по которой можно запустить навык. Пример: «Запусти навык [активационное имя]».

Активационное имя может быть:
  • Сокращенной или развернутой формой названия навыка. Например, для названия «Стихотворения Пушкина» можно добавить активационное имя «стихи Пушкина».

  • Словоформой названия навыка. Например, для навыка «Цитадель. Часть первая» можно указать активационные фразы «Цитадель часть первая» и «Цитадель первая часть».

  • Дополнительным вариантом написания или произнесения названия. Например, чтобы навык «Изучаем Python» распознавался корректно, можно задать активационные имена: «изучаем пайтон» и «изучаем питон».

  • Аббревиатурой названия. Например, для навыка «Тинькофф» можно задать активационное имя «ТКС». Аббревиатура должна состоять из как минимум 3 букв русского алфавита. При указании аббревиатуры, вам необходимо предоставить ее расшифровку в названии или описании навыка.
Вы можете задать не более 3 дополнительных активационных имен.

Обратите внимание, чтобы навык прошел модерацию, активационные имена должны отвечать формальным требованиям.

Примеры запросов

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

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

Необходимо указать хотя бы один пример. Чем больше примеров — тем легче пользователям будет понять, как можно активировать и использовать навык.

Обязательно проверьте, что все приведенные примеры корректно распознаются Алисой в обычном разговоре. Если название навыка содержит выдуманное слово или незнакомый бренд, Алиса может не распознать его. Чтобы обучить Алису этому слову, потребуется 2-3 недели (после публикации навыка).

Если спустя 3 недели Алиса по-прежнему не будет распознавать ваш навык, следует придумать другое название. Пожалуйста, сообщите об этом в форме обратной связи. Укажите название навыка, который Алиса не научилась распознавать. Это поможет нам разобраться с проблемой и улучшить качество обучения Алисы.

Webhook URL

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

Примечание. Время ожидания ответа от навыка — 3 секунды. Если Диалоги не получат ответ в течение этого времени, сессия навыка завершится. Алиса сообщит пользователю, что навык не отвечает.

В адресе обязательно должен быть указан протокол, например https://example.com/alice-webhook/

Вы можете развернуть свой навык в Яндекс.Облаке.

Голос

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

Примечание.

Даже если вы выбрали голос Алисы, не стоит говорить от имени Алисы в навыке. Пользователь может начать использовать стандартные команды, которые ваш навык может не поддерживать.

Доступные поверхности

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

Список выбранных поверхностей учитывается при модерации:

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

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

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

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

Адрес сайта для навыка. Навык, для которого вы заполнили это поле, пройдет модерацию только если вы подтвердили права на указанный сайт в Яндекс.Вебмастере.

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

Категория
Группа, к которой правильнее всего отнести ваш навык. Навык может не пройти модерацию, если выбранная категория не соответствует его функциональности.
Описание
Описание функциональности навыка на русском языке, которое отображается в каталоге. Чтобы навык прошел модерацию, описание должно отвечать формальным требованиям.
Заметки для модератора

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

Основной сценарий работы модератор проверит на всех поверхностях, выбранных в блоке Доступные поверхности.

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

Изображение размером 224×224 пикселя, которое отображается в каталоге. Рекомендуется загружать картинки этого или большего размера. При необходимости изображение будет автоматически уменьшено.

Ограничения для иконок:

  • Поддерживаемые форматы — PNG и JPG.
  • В иконке может использоваться название или логотип только того бренда, который указан в названии, активационном имени и описании навыка.
  • Чтобы навык прошел модерацию, иконка должна отвечать формальным требованиям.

Тестирование

Вы можете быстро проверить ответы навыка на его странице в личном кабинете: укажите адрес сервера в поле Webhook URL и откройте вкладку Тестирование. Вы сможете отправлять запросы, видеть примерное отображение ответа Алисы, а также тело последнего запроса и ответа.

Внимание.

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

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

Модерация

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

Если у вас возникли вопросы к модерации, напишите нам с темой «Процесс модерации диалога Алисы».

Проверки на модерации

Модераторы проверяют, что:

  1. Описание навыка соответствует всем формальным требованиям.

  2. Поддержаны команды «Помощь» и «Что ты умеешь». В ответ на эти команды навык исчерпывающе объясняет, как им можно пользоваться:

    • Для игровых навыков помощь должна содержать правила игры.

    • Навыки с жестко ограниченным набором команд должны перечислять в помощи все доступные команды и их назначение.

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

  3. Функциональность навыка соответствует его описанию и инструкциям помощи.

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

Модерация брендированных навыков

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

  • Все упоминания бренда должны быть согласованы между собой: в названии навыка, в активационных именах, в описании и на иконке должен использоваться один и тот же бренд.
  • Если официальный сайт бренда попадает в первые 3 позиции при поиске по имени бренда, этот сайт должен быть указан в поле Сайт для верификации прав использования бренда.
  • Права на сайт, указанный как Сайт для верификации прав использования бренда должны быть подтверждены в Яндекс.Вебмастере.

Публикация

После того, как ваш навык одобрен модератором, вы сможете отправить его на публикацию кнопкой Опубликовать. Навык появится в каталоге через 5-10 минут.

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