FAQ по Навыкам для авторов

С чего начать?

Рано или поздно каждый задумывается о создании собственного Навыка (мини-викторины, небольшого домашнего розыгрыша, управления умным домом или большого открытого для всех справочника), этот раздел содержит ссылки на обучающие и общие информационные материалы как раз для такого случая.

Школа Алисы

Бесплатный образовательный проект платформы Яндекс.Диалоги. Подробнее здесь. Цель проекта - популяризация Навыков и обучение разработчиков.

Что ещё прочитать?

На этой странице мы подобрали как быстрые ссылки на разделы официальной документации, так и интересные публикации сторонних авторов (не имеющих отношения ни к нашей вики, ни к Яндексу).

Библиотеки, инструменты

В этом разделе собрано то, что ускоряет и облегчает разработку Навыка, особенно новичкам. Это:

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

GitHub

• Awesome Alice - инструментарий с примерами на разных языках программирования.
• yandex-alisa-advanced - PHP-библиотека для создания Навыков.
• Node.js библиотека для автоматического тестирования навыков Алисы - позволяет эмулировать сообщения пользователя в соответствии с протоколом и проверять ответы Навыка.
• Пример Навыка Алисы.
• Ещё один небольшой ликбез для желающих создавать навыки для Алисы.

Каталог инструментальных Навыков

• Тестируем любимый голос.
  Инструмент для тестирования голоса и произношения текста.
• Тест-прокси.
  Помогает тестировать другие навыки, еще не опубликованные. Укажи webhook URL своего навыка и придумай секретное слово для доступа к нему. После этого все запросы будут пересылаться на указанный url. Ответ будет передаваться обратно Алисе.
• Редирект от Антона.
  Помогает тестировать другие навыки, еще не опубликованные. Укажи webhook URL своего навыка. После этого все запросы будут пересылаться на указанный url. Ответ будет передаваться обратно Алисе.
• alice-dev.vitalets.xyz.
  Сервис для отладки и тестирования навыков на устройстве без публикации в каталоге. Работает через веб-интерфейс. Позволяет редактировать ответы навыка прямо на странице или проксировать запросы на локальный порт. Для проверки используется навык "Инструменты разработчика".

Другие сервисы

• Сервис администрирования изображений Навыков (автор Антон Г. Федерольф).
• Готовая облачная функция для развертывания своего прокси-навыка для Алисы
• Симулятор Яндекс.Станции от Aimylogic в браузере, позволяющий протестировать навык с голосом до его публикации
• Тестовый стенд Speechkit в Яндекс.Облаке, позволяющий протестировать распознавание и синтез речи в браузере

Известные ответы и проблемы

Можно ли передавать состояние между разными сессиями?

Да. расшарить состояние между разными сессиями на разных устройствах одного пользователя можно через пользовательский стейт: https://yandex.ru/dev/dialogs/alice/doc/session-persistence.html#store-between-sessions

Можно ли протестировать навык в рамках локальной сети?

Пробуйте:

• https://github.com/popstas/yandex-dialogs-client
• https://github.com/sameoldmadness/awesome-alice#Тестирование