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}} |Помощь по разработке и тестированию Навыков }}
+{{metadesc|{{PAGENAME}} | Помощь и частые вопросы по разработке и тестированию Навыков }}
+__NOEDITSECTION__
+__TOC__
-== Разработка навыков ==
+== С чего начать? ==
-* https://github.com/sameoldmadness/awesome-alice - инструментарий с примерами на разных языках программирования<br>
-== Тестирование неопубликованных навыков ==
+Рано или поздно каждый задумывается о создании собственного Навыка (мини-викторины, небольшого домашнего розыгрыша, управления умным домом или большого открытого для всех справочника), этот раздел содержит ссылки на обучающие и общие информационные материалы как раз для такого случая.
-Вот несколько инструментов, которые облегчат тестирование навыков:
-* https://dialogs.yandex.ru/store/skills/63939d40-testiruem-lyubimyj-golo <br>
-* https://dialogs.yandex.ru/store/skills/42f51951-test-proksi <br>
-* https://dialogs.yandex.ru/store/skills/4d57ef0e-redirekt-ot-antona <br>
-== Модерация навыков ==
+=== Школа Алисы ===
-* https://youtu.be/i3sIZjpy9LU - рассказ о том, как пройти модерацию<br>
-* https://imgadmin.foralice.ru/ - сервис модерации изображений<br>
-[[Category:Яндекс.Диалоги]] [[Category:FAQ(ЧАВО)]]
+Бесплатный образовательный проект платформы Яндекс.Диалоги. Подробнее [[Школа_Алисы | здесь]]. Цель проекта - популяризация Навыков и обучение разработчиков.
+=== Что ещё прочитать? ===
+На [[Что_ещё_прочитать_по_Навыкам | этой странице]] мы подобрали как быстрые ссылки на разделы официальной документации, так и интересные публикации сторонних авторов (не имеющих отношения ни к нашей вики, ни к Яндексу).
+== Библиотеки, инструменты ==
+В этом разделе собрано то, что ускоряет и облегчает разработку Навыка, особенно новичкам. Это:
+* библиотеки - готовые наборы функций, где реализованы типовые действия Навыка.
+* конструкторы - сервисы, позволяющие собрать Навык даже без навыков программирования.
+* инструменты - проверяют и отлаживают работу Навыков и даже сервисов Яндекса (например, для настройки голоса).
+* примеры кода - позволяют быстро разобраться на примере готовых Навыков-примеров.
+=== 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 ===
+[[Category:FAQ(ЧАВО)]]
+[[Category:Диалоги]]

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