Навыки Алисы

В качестве redirect_uri необходимо использовать адрес:

https://social.yandex.net/broker/redirect

Сервер авторизации должен перенаправлять OAuth-приложение на этот URI, передавая необходимые авторизационные данные. Подробнее о redirect_uri см. в спецификации к OAuth 2.0.

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

Далее отдельный section, который конрефится целиком

Активационное имя может быть:

  • Сокращенным или развернутым вариантом названия навыка. Например, для названия «Стихотворения Пушкина» добавьте активационное имя «стихи Пушкина».

  • Разными формами названия навыка. Например, для навыка «Цитадель. Часть первая» — активационные фразы «Цитадель часть первая» и «Цитадель первая часть».

  • Вариантом, как пользователи пишут или произносят название. Например, чтобы навык «Изучаем Python» распознавался корректно, добавьте активационные имена «изучаем пайтон» и «изучаем питон».

  • Аббревиатурой названия. Например, для навыка «Тинькофф» — ТКС. Аббревиатура должна состоять минимум из трех букв русского алфавита. Если указываете аббревиатуру, расшифруйте ее в названии или описании навыка.

    Недопустимо использование общеизвестной аббревиатуры, при условии ее иной расшифровки и применения в деятельности относительно другого класса товаров и услуг (например, «МТС» для машинно-тракторной станции, «МГУ» для Московской гильдии уфологов и т. д.).

Текст

Если название навыка содержит выдуманное слово или незнакомый бренд, Алиса может не распознать его. Чтобы обучить Алису этому слову, потребуется 2–3 недели (после публикации навыка). Если слово произносят или пишут по-разному, добавьте несколько активационных имен. Так Алисе будет проще обучиться.

Если название навыка содержит выдуманное слово или незнакомый бренд, Алиса может не распознать его. Чтобы обучить ее этому слову, потребуется 2–3 недели (после публикации навыка).

Если спустя 3 недели Алиса по-прежнему не распознаёт ваш навык, придумайте другое название. Заполните форму обратной связи и укажите название навыка, который Алиса не научилась распознавать. Это поможет нам разобраться с проблемой и улучшить качество обучения Алисы.

Округляется по модулю в меньшую сторону Сессия завершается, когда:

  • пользователь запрашивает выход из навыка;
  • навык явно завершает работу ("end_session": true);
  • от пользователя долго не поступает команд (тайм-аут зависит от поверхности, минимум несколько минут).

Ограничения

Важно

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

Время ответа — это время от начала отправки запроса в навык сервером Алисы до полного получения ответа от навыка. В 4,5 секунды входят:

  • установка сетевого соединения;
  • время доставки запроса до сервера навыка;
  • собственное время работы навыка;
  • время доставки ответа до серверов Алисы.

Важно

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

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

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

  • установка сетевого соединения;
  • время доставки запроса до сервера навыка;
  • собственное время работы навыка;
  • время доставки ответа до серверов Алисы.

Обратите внимание, не допускается использование общеизвестной аббревиатуры, даже при условии иной расшифровки или ее применения в деятельности относительно другого класса товаров и услуг (например, «МТС» для машинно-тракторной станции, «МГУ» для Московской гильдии уфологов и т. д.).

Повторные запросы на обновление токенов

Если вы используете refresh-токены, следует иметь в виду — сервер авторизации должен отправить Диалогам обновленный токен в течение 5 секунд. Когда срок действия OAuth-токена истечет, Диалоги отправят запрос на получение нового токена. Если сервер авторизации не ответит в течение 5 секунд, Диалоги отправят повторный запрос. Если через 5 секунд Диалоги снова не получат ответ, связка аккаунтов будет разорвана. Пользователю потребуется повторно связывать аккаунты.

Названия

«PhonOn»

«PhonOnTV»

«PhonOnBalance»

Backend

Backend

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

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

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

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

  • установка сетевого соединения;
  • время доставки запроса до сервера навыка;
  • собственное время работы навыка;
  • время доставки ответа до серверов Алисы.

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

Напишите нам, какой инструкции вам не хватает в документации. Если у вас есть готовый пример, приложите его. Так вы поможете другим пользователям Диалогов и сделаете Алису еще лучше.