Настройки публикации
Основные настройки
Имя навыка
Название навыка в каталоге. Имя используют, чтобы запустить навык. Пример команды для активации: «Запусти навык [название]».
Требования к имени:
- Длина — от двух слов (рекомендуется не больше четырех). Предлоги, союзы, частицы и междометия не учитываются. Допускается имя из одного слова, если это уникальное название бренда. К брендированным навыкам предъявляются дополнительные требования.
- Имя уникально.
- Написано на русском или английском языке.
- Не ограничивается общей категорией товаров, сервисов или контента (например, «пластиковые окна»).
- Не содержит слова «Алиса», «Яндекс» или «Станция».
- Отвечает остальным формальным требованиям.
Если название навыка содержит выдуманное слово или незнакомый бренд, Алиса может не распознать его. Чтобы обучить Алису этому слову, потребуется 2–3 недели (после публикации навыка). Если слово произносят или пишут по-разному, добавьте несколько активационных имен. Так Алисе будет проще обучиться.
Если спустя 3 недели Алиса по-прежнему не распознаёт ваш навык, придумайте другое название. Заполните форму обратной связи и укажите название навыка, который Алиса не научилась распознавать. Это поможет нам разобраться с проблемой и улучшить качество обучения Алисы.
Активационные имена
Дополнительные фразы, которыми можно запустить навык. Пример: «Запусти навык [активационное имя]».
Активационное имя может быть:
-
Сокращенным или развернутым вариантом названия навыка. Например, для названия «Стихотворения Пушкина» добавьте активационное имя «стихи Пушкина».
-
Разными формами названия навыка. Например, для навыка «Цитадель. Часть первая» — активационные фразы «Цитадель часть первая» и «Цитадель первая часть».
-
Вариантом, как пользователи пишут или произносят название. Например, чтобы навык «Изучаем Python» распознавался корректно, добавьте активационные имена «изучаем пайтон» и «изучаем питон».
-
Аббревиатурой названия. Например, для навыка «Тинькофф» — ТКС. Аббревиатура должна состоять минимум из трех букв русского алфавита. Если указываете аббревиатуру, расшифруйте ее в названии или описании навыка.
Можно задать три дополнительных активационных имени.
Чтобы навык прошел модерацию, активационные имена должны отвечать формальным требованиям.
Backend
Параметры обработчика, который будет принимать от пользователя запрос через Яндекс Диалоги и отвечать на него.
Доступные варианты:
-
Webhook URL — адрес обработчика навыка. Обработчик должен работать по HTTPS, протокол укажите в адресе
https://example.com/alice-webhook/.Для корректной работы навыка настройте цепочку SSL-сертификатов на веб-сервере или сервисе провайдера:
-
Сгенерируйте сертификат, используя одну из программ для получения сертификатов (Let's Encrypt, SSL For Free, CAcert и др.).
-
Скопируйте файлы сертификатов в нужную папку.
-
Укажите вашему веб-серверу пути к этим файлам.
Внимание
Платформа принимает только fullchain-сертификаты. При попытке верифицироваться с самоподписанным сертификатом вы получите сообщение «Endpoint URL: Некорректный SSL-сертификат».
Чтобы проверить валидность сертификата, используйте онлайн-сервисы SSL Labs, SSL Shopper, Wormly, ImmuniWeb. Однако не забывайте, что онлайн-способы генерации и проверки сертификатов не должны применяться для чувствительных данных, чтобы ваши приватные ключи не попали к сторонним сервисам.
-
-
Функция Yandex Cloud — идентификатор функции в Yandex Cloud. Функция должна быть создана с аккаунта автора навыка. О том, как создать и подключить функцию для навыка Алисы, читайте в документации Yandex Cloud.
Если Диалоги не получат ответ от навыка за 4,5 секунды, его сессия завершится. Алиса сообщит пользователю, что навык не отвечает. В 4,5 секунды входят:
- установка сетевого соединения;
- время доставки запроса до сервера навыка;
- собственное время работы навыка;
- время доставки ответа до серверов Алисы.
Длина ответа ограничена 5000 символами, длина OAuth-токена и refresh-токена — 2048 символами. Время жизни токенов (свойство expires_in) должно быть целым числом от 1 до 4 294 967 296.
Голос
Голос, который нужно использовать для озвучивания навыка. Все доступные голоса описаны в разделе Голоса навыков.
Даже если вы выбрали голос Алисы, не говорите в навыке от ее имени. Если пользователь запутается — он начнет называть стандартные команды для Алисы, которые ваш навык может не поддерживать.
Тип доступа
Ограничение доступа к опубликованному навыку:
-
Публичный — после публикации навык попадет в каталог навыков и будет доступен всем пользователям Алисы.
-
Приватный — после публикации навык доступен только вам (на всех поверхностях, где вы авторизованы под аккаунтом, которому принадлежит навык).
Приватный навык проходит автомодерацию перед публикацией. После этого вы можете выдавать индивидуальный доступ к нему. Подробнее о приватном доступе читайте в разделе Управление доступом.
Доступные поверхности
Если ваш навык бесполезен на поверхностях, которые не могут показывать картинки, выберите опцию Нужно устройство с экраном. Навык можно будет запустить только на таких устройствах. Консоль покажет список доступных платформ.
Выбранные поверхности учитывают при модерации:
-
Если вы ограничили платформы, модераторы проверят работу навыка только на тех поверхностях, на которых он должен запускаться.
-
Если окажется, что навык зависит от ограничения, которое вы не указали, модератор может отклонить публикацию. Например, цель навыка — сформировать ссылку для подтверждения заказа на сайте, а вы не выбрали Нужно устройство с экраном. На голосовых поверхностях навыком будет очень сложно пользоваться.
Публикация в каталоге
Сайт для верификации прав использования бренда
Примеры запросов
Примеры активационных команд, которые будут отображаться на странице навыка в каталоге.
В примере укажите команду, активационное имя, можете добавить опциональный запрос. Подробнее об активации навыков см. раздел Запуск и выход.
Необходимо дать хотя бы один пример. Чем больше примеров, тем легче пользователям будет понять, как можно активировать и использовать навык.
Обязательно проверьте, что все приведенные примеры Алиса корректно распознаёт в обычном разговоре.
Имя разработчика
Имя автора навыка, которое следует отображать в каталоге.
Email разработчика
Электронная почта для прямой связи с автором навыка.
Сайт для верификации прав использования бренда
Адрес сайта для навыка. Навык, для которого вы заполнили это поле, пройдет модерацию, только если вы подтвердили права на сайт в Яндекс Вебмастере.
Права на сайт проверяет Вебмастер, чтобы навык с вашим брендом могли опубликовать только вы. Без этой проверки кто угодно мог бы использовать ваш бренд и официальный сайт для своего навыка.
Категория
Группа, к которой правильнее всего отнести ваш навык в зависимости от темы, функций, аудитории, контента. Навык может не пройти модерацию, если выбранная категория не соответствует его функциональности.
Описание
Описание функциональности навыка на русском языке, которое отображается в каталоге. Чтобы навык прошел модерацию, описание должно отвечать формальным требованиям.
Заметки для модератора
Опишите основной сценарий работы навыка или укажите данные для авторизации, если она необходима.
Основной сценарий работы модератор проверит на всех поверхностях, выбранных в блоке Доступные поверхности.
Возрастные ограничения
Отметьте эту опцию, если ответы вашего навыка могут содержать контент для взрослых.
Иконка
Изображение размером 224 × 224 пикселя, которое пользователи видят в каталоге. Рекомендуется загружать картинки этого или большего размера. Если нужно, изображение будет автоматически уменьшено.
Ограничения:
- Формат — PNG или JPG.
- Отвечает формальным требованиям.
- Можно использовать название или логотип только того бренда, который указан в названии, активационном имени и описании навыка.
Редакторские поля
На вкладке Редакторские поля вы можете присвоить навыку бейджи или теги, с помощью которых навык можно будет найти в каталоге.
- Чтобы выбрать бейдж или тег, кликните на предложенный вариант.
- Чтобы добавить новый тег, введите его название и нажмите кнопку Добавить.
После внесения изменений нажмите кнопку Сохранить и отправьте черновик на модерацию.
Тестирование
Быстро проверить ответы навыка можно на его странице в консоли разработчика: укажите адрес сервера в поле Webhook URL и откройте вкладку Тестирование. Вы сможете отправлять запросы, видеть примерное отображение ответа Алисы, тело последнего запроса и ответа.
При тестировании в личном кабинете навык считается постоянно активированным, поэтому так не получится проверить работу активационных имен.
Не забудьте особенно тщательно проверить примеры запросов, которые вы привели в конфигурации навыка или в его описании. Когда вы удостоверитесь, что навык отвечает правильно, отправьте его на проверку кнопкой На модерацию.
Подробнее о тестировании навыка.
Полезные видео
Часто задаваемые вопросы
Скорее всего, ваш сервис отвечает на запрос Диалогов дольше 4,5 секунды. В таком случае ответ не будет доставлен. Алиса сообщит пользователю, что навык не отвечает, и сессия завершится.
В 4,5 секунды входят:
- установка сетевого соединения;
- время доставки запроса до сервера навыка;
- собственное время работы навыка;
- время доставки ответа до серверов Алисы.
Если вы хотите обучить Алису названию своего бренда, направьте запрос в поддержку через форму обратной связи. Выберите пункт Алиса не понимает мой бренд и следуйте инструкции.
Если Алиса не распознаёт бренд спустя две недели после отправки запроса, попробуйте изменить активационные имена. Воспользуйтесь рекомендациями и проверьте распознавание в обычном разговоре с Алисой.
Для названий брендированных навыков можно использовать одно слово, если это уникальное название бренда. Чтобы подтвердить права на бренд, укажите адрес сайта в настройках навыка.
Во всем остальном брендированные навыки должны соответствовать общим требованиям.