SmartApp Framework — это фреймворк, который позволяет создавать смартапы с поддержкой виртуальных ассистентов Салют.
Project description
SmartApp Framework
SmartApp Framework - это Python-фреймворк, который позволяет создавать смартапы для виртуальных ассистентов Салют.
Оглавление
Конфигурация
Фреймворк и смартапы
Смартап - это приложение для виртуального ассистента Салют. С помощью смартапов пользователи могут вызвать такси, узнать погоду, управлять устройствами умного дома, записаться в салон красоты и совершить прочие действия, которые можно доверить ассистенту.
Виртуальный ассистент понимает текущие намерения пользователя и для каждой его реплики подбирает соответствующий запрос на выполнение (интент). Поведение смартапа для различных интентов описывается с помощью сценариев. Интенты и сценарии связываются через смартапы, написанные на SmartApp Framework.
Инструменты фреймворка
Фреймворк содержит следующие инструменты:
- инструменты для создания сценариев;
- решения для автоматического тестирования;
- демо-приложение для просмотра примеров реализации;
- готовые механизмы для слот-филлинга и извлечения сущностей из текста.
Рекомендованные требования
- Linux, Mac OS или Windows (необходима установка Conda).
- 512 МБ свободной памяти.
- Python 3.6.8 - 3.9.6.
Настройка фреймворка
Обновление фреймворка
Для перехода на новую версию фреймворка выполните в терминале следующие команды:
python3 -m pip uninstall -y smart-app-framework
python3 -m pip install git+https://github.com/sberdevices/smart_app_framework@main
При переходе на версию фреймворка >=1.0.7.rc4 со старым смартапом необходимо в директории смартапа из файла static/.text_normalizer_resources/static_workdata.json
удалить строки 'Ё на Е'.
Установка фреймворка
Для установки фреймворка выполните в терминале следующую команду:
python3 -m pip install git+https://github.com/sberdevices/smart_app_framework@main
Создание проекта
Для создания проекта выполните в терминале следующую команду:
python3 -m smart_kit create_app <YOUR_APP_NAME>
После этого в текущей директории появится каталог с проектом. Он уже содержит в себе всё необходимое для запуска минимального приложения, включая базовый сценарий hello_scenario. Описание сценариев и форм можно найти в <YOUR_APP_NAME>/static/references/.
Тестирование онлайн
Для тестирования онлайн вам понадобится мобильное приложение Сбер Салют или собственное устройство, на котором будет запускаться смартап. Для такого тестирования:
- Запустите в терминале dev сервер:
python3 manage.py run_app
- Передайте в интернет порт. Для этого потребуется внешний IP-адрес. Если у вас его нет, воспользуйтесь специальными сервисами (например, Ngrok).
- Зарегистрируйтесь в кабинете разработчика - SmartApp Studio.
- Создайте в SmartApp Studio свой смартап.
- Перейдите в настройки смартапа и укажите в поле "Настройки вебхука" адрес вашего сервера. Сохраните изменения.
- Запустите свой смартап с помощью фразы "Запусти <имя приложения>".
В терминале должны появиться записи о входящем сообщении, а ассистент ответит приветствием согласно сценарию hello_scenario.
Тестирование офлайн
Ниже представлен пример команды для терминала при тестировании офлайн и пример ответа, который выводится на экране:
localhost:~$ python <YOUR_APP_NAME>/manage.py local_testing
Текущий сценарий: hello_scenario
Привет! Введите help или ? для вызова списка команд.
> set intent run_app // смена интента на другой. По умолчанию имя сценария совпадает с именем интента
intent = run_app
> Привет
pronounceText: Как тебя зовут?
Документация
Вы можете ознакомиться с подробной документацией по работе со SmartApp Framework в справочнике разработчика.
Обратная связь
C вопросами и предложениями пишите нам по адресу developer@sberdevices.ru или вступайте в наш Telegram канал - SmartMarket Community.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for smart_app_framework-1.0.7rc11.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | cffd0883aca48c694828136aba68156b9cd8e51c43fcfc31f2582153ac3e343b |
|
MD5 | b4a8736cc722a8021879a70073e8f838 |
|
BLAKE2b-256 | e12db3b251d1bba73bfd45922f61d4e5e694aac49d6c3120a0f63d65dba3fce3 |
Hashes for smart_app_framework-1.0.7rc11-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a23a055e3f3c5334f3adb3231c9e184d75eadb3800188c61fbeea24c21e7d964 |
|
MD5 | 9bd527d7ef6187c2d24f098e88463acb |
|
BLAKE2b-256 | 25029473207c723493c1e81f2b60991e34243447791f47d76fd9710a4ee8b495 |