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

Внимание

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

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

Язык и описание

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

Язык

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

Название

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

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

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

Подзаголовок

Краткое описание навыка для списка навыков умного дома в приложении Дом с Алисой.

Описание

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

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

  • Заголовки:

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

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

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

Дополнительный язык

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

В качестве резервного языка будет использоваться первый язык из списка.

Регионы и страны

В каких странах поддерживает работу ваш навык.

Ограничение

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

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

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

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

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

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.

Тип доступа

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

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

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

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

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

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

Имя разработчика

Имя автора навыка.

Email разработчика

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

Официальный навык

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

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

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

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

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

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

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

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

Иконка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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