FAQ по Навыкам для авторов: различия между версиями

Текущая версия от 08:26, 23 ноября 2020

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

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

Школа Алисы

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

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

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

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

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

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

GitHub

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

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

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

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

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

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

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

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

Пробуйте:

session:true

@@ Строка 1: / Строка 1: @@
 {{metadesc|{{PAGENAME}} | Помощь и частые вопросы по разработке и тестированию Навыков }}
 __NOEDITSECTION__
+__TOC__
+== С чего начать? ==
-== Разработка Навыков ==
+Рано или поздно каждый задумывается о создании собственного Навыка (мини-викторины, небольшого домашнего розыгрыша, управления умным домом или большого открытого для всех справочника), этот раздел содержит ссылки на обучающие и общие информационные материалы как раз для такого случая.
-=== Инструменты ===
+=== Школа Алисы ===
-* [//github.com/sameoldmadness/awesome-alice GitHub - инструментарий с примерами на разных языках программирования]
-* [//github.com/jeyroik/php-yandex-alisa-advanced GitHub - php-библиотека для создания Навыков]
-* [//github.com/vitalets/alice-tester GitHub - Node.js библиотека для автоматического тестирования навыков Алисы. Позволяет эмулировать сообщения пользователя в соответствии с протоколом и проверять ответы навыка]
-* [//github.com/Alexcei88/AlisaSkill GitHub - AlisaSkill]
+Бесплатный образовательный проект платформы Яндекс.Диалоги. Подробнее [[Школа_Алисы | здесь]]. Цель проекта - популяризация Навыков и обучение разработчиков.
-=== Почитать ===
+=== Что ещё прочитать? ===
-==== Хабр ====
+На [[Что_ещё_прочитать_по_Навыкам | этой странице]] мы подобрали как быстрые ссылки на разделы официальной документации, так и интересные публикации сторонних авторов (не имеющих отношения ни к нашей вики, ни к Яндексу).
-* [//habr.com/ru/post/441978/ Функциональное тестирование навыков Яндекс Алисы на Node.js]
-* [//habr.com/ru/company/just_ai/blog/412557/ Как создать своего бота без навыков программирования и подключить его к Яндекс.Алисе]
-* [//habr.com/ru/post/434194/ Разработка навыков для Алисы. Опыт работы с голосовыми интерфейсами, советы начинающим]
-== Тестирование неопубликованных навыков ==
+== Библиотеки, инструменты ==
-Несколько Навыков для тестирования Навыков (в каталоге Навыков))):
+В этом разделе собрано то, что ускоряет и облегчает разработку Навыка, особенно новичкам. Это:
-* [//dialogs.yandex.ru/store/skills/63939d40-testiruem-lyubimyj-golo Тестируем любимый голос].<br> Позволяет протестировать голоса и произношение текста.
+* библиотеки - готовые наборы функций, где реализованы типовые действия Навыка.
+* конструкторы - сервисы, позволяющие собрать Навык даже без навыков программирования.
+* инструменты - проверяют и отлаживают работу Навыков и даже сервисов Яндекса (например, для настройки голоса).
+* примеры кода - позволяют быстро разобраться на примере готовых Навыков-примеров.
+=== GitHub ===
+* [https://github.com/sameoldmadness/awesome-alice Awesome Alice] - инструментарий с примерами на разных языках программирования.
+* [https://github.com/jeyroik/php-yandex-alisa-advanced yandex-alisa-advanced] - PHP-библиотека для создания Навыков.
+* [https://github.com/seralexeev/alice-dotnet Пример простого скилла для платформы Яндекс.Диалоги на C#]
+* [https://github.com/vitalets/alice-tester Node.js библиотека для автоматического тестирования навыков Алисы] - позволяет эмулировать сообщения пользователя в соответствии с протоколом и проверять ответы Навыка.
+* [https://github.com/Alexcei88/AlisaSkill Пример Навыка Алисы].
+* [https://github.com/azzzak/alice-101 Ещё один небольшой ликбез для желающих создавать навыки для Алисы].
+=== Каталог инструментальных Навыков ===
+* [//dialogs.yandex.ru/store/skills/63939d40-testiruem-lyubimyj-golo Тестируем любимый голос].<br> Инструмент для тестирования голоса и произношения текста.
 * [//dialogs.yandex.ru/store/skills/42f51951-test-proksi Тест-прокси].<br> Помогает тестировать другие навыки, еще не опубликованные. Укажи webhook URL своего навыка и придумай секретное слово для доступа к нему. После этого все запросы будут пересылаться на указанный url. Ответ будет передаваться обратно Алисе.
 * [//dialogs.yandex.ru/store/skills/4d57ef0e-redirekt-ot-antona Редирект от Антона].<br> Помогает тестировать другие навыки, еще не опубликованные. Укажи webhook URL своего навыка. После этого все запросы будут пересылаться на указанный url. Ответ будет передаваться обратно Алисе.
+* [https://alice-dev.vitalets.xyz/ alice-dev.vitalets.xyz].<br> Сервис для отладки и тестирования навыков на устройстве без публикации в каталоге. Работает через веб-интерфейс. Позволяет редактировать ответы навыка прямо на странице или проксировать запросы на локальный порт. Для проверки используется навык "Инструменты разработчика".
+== Другие сервисы ==
+* [//imgadmin.foralice.ru/ Сервис администрирования изображений Навыков] (автор Антон Г. Федерольф).
+* [//github.com/vitalets/alice-cloud-proxy Готовая облачная функция для развертывания своего прокси-навыка для Алисы]
+* [//https://station.aimylogic.com/ Симулятор Яндекс.Станции от Aimylogic в браузере, позволяющий протестировать навык с голосом до его публикации]
+* [//https://cloud.yandex.ru/services/speechkit Тестовый стенд 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#Тестирование
-== Модерация навыков ==
+=== session:true ===
-* [//youtu.be/i3sIZjpy9LU Как пройти модерацию]
-* [//imgadmin.foralice.ru/ Сервис модерации изображений]
-[[Category:Яндекс.Диалоги]] [[Category:FAQ(ЧАВО)]]
+[[Category:FAQ(ЧАВО)]]
+[[Category:Диалоги]]

Arkrusinov (обсуждение | вклад)