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

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

Конфигурация

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

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

    Ограничения для активационных имен:

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

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

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

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

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

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

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

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

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

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

Внимание.

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

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

Модерация

Модераторы проверяют общую уместность навыка для Алисы и его соответствие всем формальным требованиям. Результат модерации будет отображен в личном кабинете в течение 3 дней.

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

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

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

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

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

Публикация

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

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