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

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

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

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

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

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

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

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

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

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

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

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

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

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

Внимание.

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

  • не получится проверить работу активационных имен;
  • флаг "end_session": true в ответе приведет к ошибке.

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

Модерация

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

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

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

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

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

Публикация

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

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