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

Использовать навык Алисы можно, только если этот навык опубликован в каталоге. Чтобы опубликовать диалог, зарегистрируйте его в Консоли разработчика:

  1. Задайте настройки навыка:

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

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

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

Название

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

  • состоять не менее чем из 2 слов без учета предлогов (рекомендуется использовать не более 5 слов);
  • быть уникальным;
  • быть написанным на русском или английском языке;
  • не ограничиваться общей категорией товаров, сервисов или контента (например, «пластиковые окна»);
  • не содержать слов «Алиса», «Яндекс» или «Станция»;
  • отвечать остальным формальным требованиям.
Активационное имя

Фраза, по которой навык можно вызвать в разговоре с Алисой. Например, «игра в города»или «играть в города». Ограничения для активационных имен:

  • В качестве имени можно использовать либо фразу из как минимум 2 слов (без учета предлогов), либо уникальное название бренда.
  • Имя должно быть аббревиатурой или словоформой названия навыка, либо сокращенной или развернутой формой названия. Например, для названия «Космический квест» можно использовать имя «игра космический квест».
  • Проверьте, что Алиса правильно распознает придуманные вами активационные имена в обычном разговоре с Алисой.
  • Чтобы навык прошел модерацию, имена должны отвечать формальным требованиям.
Webhook URL

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

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

Голос

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

Доступные голоса (в скобках — название голоса на тестовом стенде Speechkit):

  • Оксана (Oksana) — голос по умолчанию в Яндекс.Навигаторе.
  • Джейн (Jane).
  • Захар (Робот Захар)
  • Эрмил (Ermilov)
  • Эркан Явас (Erkanyavas) — голос Яндекс.Новостей, оптимизированный для длинных текстов.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обязательно проверьте, что все приведенные примеры корректно распознаются Алисой в обычном разговоре. Если неправильно распознается, например, название вашего бренда, напишите нам с темой «Алиса не понимает мой бренд».

Иконка

Изображение размером 192×192 пикселя, которое отображается в каталоге (картинки большего размера будут автоматически отмасштабированы). Ограничения для иконок:

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

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

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

Внимание.

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

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

Модерация

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

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

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

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

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

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

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

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

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

  3. На непредусмотренные команды навык отвечает той же инструкцией, что и на команду «Помощь». Например, «Я не понимаю эту команду. Но могу добавить событие в календарь или настроить напоминание.»

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

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

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

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

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

Публикация

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

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