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__
-{{Underconstruct}}
 == С чего начать? ==
@@ Строка 15: / Строка 12: @@
-Официальная страница "Школы Алисы" находится [//events.yandex.ru/events/webinars/alisa-school/ здесь]. Ниже список прямых ссылок на уроки (на момент редактирования):
+Бесплатный образовательный проект платформы Яндекс.Диалоги. Подробнее [[Школа_Алисы | здесь]]. Цель проекта - популяризация Навыков и обучение разработчиков.
-# [//youtube.com/watch?v=I_-MHxLc7kM Как понять, какой навык делать], Мика Голубовский.
-# [//youtube.com/watch?v=P0k4we5eYVE Как правильно начать навык: приветственная фраза], Мика Голубовский.
-# [//youtube.com/watch?v=U36FwFGeslw Как задать тон общения в навыке], Мика Голубовский.
-# [//youtube.com/watch?v=Ygf4Q85Myt0 Какую информацию добавить в приветственную фразу], Мика Голубовский.
-# [//youtube.com/watch?v=TZZczL3IEXs Как направлять пользователей в навыке через вопросы], Мика Голубовский.
-# [//youtube.com/watch?time_continue=1&v=Y7K6pjrb2w4 Как оформить логотип навыка], Анастасия Вишневская.
-# [//youtube.com/watch?v=YC7R0RCZ7gU Как выбрать правильный компонент при дизайне навыка], Анастасия Вишневская.
-# [//youtube.com/watch?v=ARPIBoxaFoY Как развернуть навык в Яндекс.Облаке], Алексей Замулла.
-# [//youtube.com/watch?v=FDQmAKYPif4 Как изменить поведение тестовых навыков в Яндекс.Облаке], Алексей Замулла.
-# [//youtube.com/watch?v=sO--SDgzIik Как правильно заполнять настройки навыка в интерфейсе Яндекс.Диалогов], Денис Насонов.
-# [//youtube.com/watch?v=i3sIZjpy9LU Как пройти модерацию навыка для Алисы?], Ольга Жаворонкова.
-# [//youtube.com/watch?v=vqrflCJFlfg Как создавать голосовой пользовательский интерфейс?], Дмитрий Чечёткин.
-# [//youtube.com/watch?v=kRSf_onO1Vg Как связать сценарий, контент и код для навыка в единое целое?], Дмитрий Чечёткин.
-# [//youtube.com/watch?v=wqtyFk1yYzw Как правильно работать с оценками и отзывами на навык?], Дмитрий Чечёткин.
-# [//youtube.com/watch?v=VsIlqk5PMiY Как создать навык без программирования?], Вера Александровская.
-# [//youtube.com/watch?v=EufqBJviFDc Как использовать конструктор для создания навыков Алисы Aimylogic], Дмитрий Чечёткин.
-# [//youtube.com/watch?v=KC_6z4uJPB0 Как обрабатывать логи в навыках?], Дарья Сердюк.
-=== Хабр ===
+=== Что ещё прочитать? ===
-* [//habr.com/ru/post/441978/ Функциональное тестирование навыков Яндекс Алисы на Node.js]
+На [[Что_ещё_прочитать_по_Навыкам | этой странице]] мы подобрали как быстрые ссылки на разделы официальной документации, так и интересные публикации сторонних авторов (не имеющих отношения ни к нашей вики, ни к Яндексу).
-* [//habr.com/ru/company/just_ai/blog/412557/ Как создать своего бота без навыков программирования и подключить его к Яндекс.Алисе]
-* [//habr.com/ru/post/434194/ Разработка навыков для Алисы. Опыт работы с голосовыми интерфейсами, советы начинающим]
@@ Строка 58: / Строка 35: @@
-* [//github.com/sameoldmadness/awesome-alice Awesome Alice]. Инструментарий с примерами на разных языках программирования.
+* [https://github.com/sameoldmadness/awesome-alice Awesome Alice] - инструментарий с примерами на разных языках программирования.
-* [//github.com/jeyroik/php-yandex-alisa-advanced yandex-alisa-advanced]. PHP-библиотека для создания Навыков.
+* [https://github.com/jeyroik/php-yandex-alisa-advanced yandex-alisa-advanced] - PHP-библиотека для создания Навыков.
-* [//github.com/vitalets/alice-tester Node.js библиотека для автоматического тестирования навыков Алисы]. Позволяет эмулировать сообщения пользователя в соответствии с протоколом и проверять ответы Навыка.
+* [https://github.com/seralexeev/alice-dotnet Пример простого скилла для платформы Яндекс.Диалоги на C#]
-* [//github.com/Alexcei88/AlisaSkill Пример Навыка Алисы]
+* [https://github.com/vitalets/alice-tester Node.js библиотека для автоматического тестирования навыков Алисы] - позволяет эмулировать сообщения пользователя в соответствии с протоколом и проверять ответы Навыка.
+* [https://github.com/Alexcei88/AlisaSkill Пример Навыка Алисы].
+* [https://github.com/azzzak/alice-101 Ещё один небольшой ликбез для желающих создавать навыки для Алисы].
-=== Каталог Навыков ===
+=== Каталог инструментальных Навыков ===
@@ Строка 70: / Строка 49: @@
 * [//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#Тестирование
-* [//imgadmin.foralice.ru/ Сервис администрирования изображений] (автор Антон Г. Федерольф).
+=== session:true ===
-[[Category:Яндекс.Диалоги]] [[Category:FAQ(ЧАВО)]]
+[[Category:FAQ(ЧАВО)]]
+[[Category:Диалоги]]

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