Создание навыка

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

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

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

Название

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

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

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

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

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

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

  • Endpoint URL — адрес обработчика навыка. Обработчик обязательно должен работать по HTTPS, протокол должен быть указан в адресе, например https://example.com/smart-home/.
  • Функция Яндекс.Облака — идентификатор Функции в Яндекс.Облаке. Функция должна быть создана из-под учетной записи автора навыка. О том, как создать и подключить функцию для навыка Алисы, читайте в документации Яндекс.Облака.

    Обратите внимание: независимо от настройки таймаута для функции, Диалоги ожидают ответа в течение 3 секунд.

Тип доступа

Ограничение доступа к опубликованному навыку:

  • Публичный — после публикации навык попадет в каталог навыков и будет доступен всем пользователям Алисы.

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

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

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

Подзаголовок
Краткое описание навыка для списка навыков умного дома в приложении Яндекс.
Имя разработчика
Имя автора навыка.
E-mail разработчика
Адрес для связи с разработчиком навыка (по умолчанию используется Яндекс.Почта аккаунта, авторизованного в Диалогах).
Официальный навык

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

Сайт для верификации прав использования бренда

Адрес сайта для навыка. Будет отображаться на странице описания навыка в каталоге, в разделе «Связь с разработчиком».

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

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

Описание

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

Чтобы оформить описание, можно использовать некоторые возможности языка разметки Markdown:

  • Заголовки:

    # Первого уровня
    ## Второго уровня
    ### Третьего уровня
  • Цитаты:

    > Текст, на который стоит
    > обратить внимание.
  • Списки:

    * маркированный
    * список
    
    1. нумерованный
    2. список

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

Заметки для модератора

В этом поле нужно указать необходимую для тестирования информацию:

  • Тестовый аккаунт для проверки авторизации в навыке.
  • Если для работы навыка необходимы определенные устройства, опишите их, и команда Диалогов запросит эти устройства у вас при проверке.

Иконка

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

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

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