Это готовый к использованию шаблон проекта навыка голосового ассистента Яндекс Алиса. Написан с использованием фреймворка JAICF на языке Kotlin.
Вы можете развернуть этот навык в облаке Heroku в один клик, а затем продолжить разработку и отладку на своем ПК.
- Нажмите на кнопку ниже
Вебхук будет автоматически развернут в облаке Heroku, и вы получите рабочий сервер, который далее сможете обновлять (см ниже).
При установке укажите ваш OAuth токен.
- После развертывания вебхука нажмите на кнопку View и скопируйте URL. Это и есть ваш вебхук.
- Создайте новый навык для Алисы в Яндекс Диалогах.
- Укажите название навыка и URL вебхука, который вы скопировали (остальные поля необязательны).
- Перейдите на вкладку Тестирование - навык будет запущен автоматически.
- Установите Heroku CLI.
- Выполните следующие команды в терминале
heroku login
heroku git:clone -a <название вашего приложения на Heroku>
cd <название вашего приложения на Heroku>
git remote add origin https://github.com/just-ai/alice-jaicf-template
git pull origin master
- Создайте новый проект в IntelliJ IDEA из исходных кодов (Project from Existing Sources), выберите Gradle из списка.
Чтобы запустить вебхук локально, запустите Webhook.kt.
Сервер запускается на порту 8080.
Чтобы разрабатывать навык, вам нужно получить публичный URL, который затем прописать в настройках вашего навыка в Яндекс Диалогах.
Для этого можно установить ngrok, а затем выполнить команду ngrok http 8080 в терминале.
Таким образом все запросы от Алисы будут приходить на ваш локальный ПК, и вы сможете отлаживать сценарий навыка.
Изучите документацияю JAICF, чтобы понимать, как разрабатывать навык для Алисы
Как только вы готовы обновить сервер, выполните следующие команды в терминале:
git add .
git commit -am "описание ваших изменений"
git push
Heroku автоматически соберет и обновит ваш сервер.
Если у вас возникли вопросы или проблемы, вы можете задать их в Slack сообществе фреймворка JAICF или создать новый Issue в этом репозитории.