Создание и настройки

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

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

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

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

Название

Название навыка, которое появится в каталоге.

Требования к названию:

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

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

Внимание.

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

В 3 секунды входят:

  • установка сетевого соединения;
  • время доставки запроса до сервера навыка;
  • собственное время работы навыка;
  • время доставки ответа до серверов Алисы.
Внимание. Длина ответа не должна превышать 5000 символов, длина OAuth-токена и refresh-токена — 2048 символов. Время жизни токенов (свойство expires_in) должно быть числом от 1 до 4 294 967 296.

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

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

  • Функция Yandex.Cloud — идентификатор функции в Yandex.Cloud. Функцию должен быть создать автор навыка. О том, как создать и подключить функцию для навыка Алисы, читайте в документации Yandex.Cloud.

Тип доступа

Доступ к опубликованному навыку бывает:

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

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

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

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

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

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

Указание на то, что это официальный навык бренда, а разработчик — производитель устройств или его официальный представитель.

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

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

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

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

Описание

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

В описании доступны возможности языка разметки Markdown:

  • Заголовки:

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

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

    * маркированный
    * список
    
    1. нумерованный
    2. список
Заметки для модератора

Укажите информацию для тестирования:

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

Изображение, которое появится в каталоге.

Требования к иконкам:

  • Формат — PNG или JPG.
  • Размер — 224 × 224 пикселя или больше. При необходимости изображение автоматически уменьшится.
  • В иконке может использоваться название или логотип бренда, который указан в названии и описании навыка.

Поддерживаемые устройства

ID или название товара

Перейдите на вкладку Устройства. Начните вводить название устройства и выберите его из выпадающего списка либо введите ID устройства из ссылки на Яндекс Маркете.

Пример ID устройства из ссылки
  • Ссылка на Яндекс Маркете:

    https://market.yandex.ru/product--xiaomi-mi-led-smart-bulb/634589866

  • ID устройства: 634589866

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

Часто задаваемые вопросы

Почему навык не отвечает пользователю?

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

Можно ли перенести навык с одного аккаунта на другой?

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

Чтобы не переносить брендированные навыки с личных аккаунтов сотрудников, создавайте такие навыки с корпоративных аккаунтов.

Какие этапы обработки запроса входят в ограничение три секунды?

В три секунды входят:

  1. Установка сетевого соединения.
  2. Отправка запроса по сети с сервера Диалогов на сервер навыка.
  3. Формирование ответа.
  4. Отправка ответа по сети с сервера навыка на сервер Диалогов.

Служба поддержки