IQ4
Установка базовых компонентов - Studio и Core
- Скачать локализованный дистрибутив бот-платформы. (Запросить у технической поддержки)
- Распаковать архив в каталог, где планируется разворачивание бот-платформы.
- Выполнить команду ./bp для установки и запуска.
- По умолчанию консоль администрирования будет доступна по адресу localhost:3000.
Установка дополнительных компонентов
Для корректной работы бот-платформы необходимо выполнить локальную установку двух дополнительных сервисов - сервиса Duckling и NLU (Языкового сервера).
Установка Duckling
Duckling используется для извлечения системных сущностей (время, электронная почта, валюта и т.д.). Этот сервис требует минимальных ресурсов. В Linux Duckling должен быть скомпилирован. Следовательно, вам нужно будет установить средства разработки программного обеспечения и выполнить сборку из исходного кода.
- Требуется среда Haskell, рекомендуется использовать stack:
sudo get -qO- https://get.haskellstack.org/ | sh
- Далее необходимо установить PCRE: sudo apt update затем
sudo apt install libpcre3 libpcre3-dev
- Затем скачать:
sudo git clone https://github.com/facebook/duckling.git
- Скомпилировать и запустить:
stack build
затемstack exec duckling-example-exe
- Требуется среда Haskell, рекомендуется использовать stack:
- После установки duckling, нжно будет отредактируйте файл data/global/config/nlu.json и установить для параметра ducklingURL значение, на котором вы запускаете Duckling, например, если он находится на том же сервере, что и бот-платформа (и если вы используете порт по умолчанию 8000), нужно будет прописать:
{
...
"ducklingURL": "http://localhost:8000"
}
- После установки duckling, нжно будет отредактируйте файл data/global/config/nlu.json и установить для параметра ducklingURL значение, на котором вы запускаете Duckling, например, если он находится на том же сервере, что и бот-платформа (и если вы используете порт по умолчанию 8000), нужно будет прописать:
Установка NLU (Языкового сервера)
Языковой сервер отвечает за разбор сообщений пользователей/клиентов и распознавание их намерений.
Для добавления языка в языковой сервер необходимо скачать и установить файлы модели и языковых векторов для нужного языка.
Языковой вектор - файл с набором слов-векторов. Слово-вектор формируется на основании обучения языкового сервера на примере большого количества предложений/текстов с использованием этого слова. Чем больше глубина обучения, тем точнее языковой сервер может определить намерение клиента, но и размер такого файла значительно увеличивается. Рекомендуется использовать файл языковых векторов с глубиной обучения до 300 предложений.
- Файлы для русского языка:
файл модели русского языка и
векторы для русского языка
- Файлы для русского языка:
- После скачивания файлов, запустите бот-платформу со следующими параметрами:
./bp lang --offline --dim 300 --langDir <some_path> (some_path - путь, где вы разместили языковые файлы). По умолчанию языковой сервер запускается на порту 3100.
- Запустите Бот-платформу:
./bp
- В файле
data/global/config/nlu.json
, заменитьlanguageSources.endpoint
наhttp://localhost:3100
- Перезагрузить Бот-платформу, открыть Страницу выбора языка, в панели администратора.
- Выбрать поддерживаемый язык - Русский.
- Перезагрузить языковой сервер с параметром "только для чтения":
./bp lang --readOnly
- После скачивания файлов, запустите бот-платформу со следующими параметрами:
Запуск NLU на отдельном сервере
Для запуска NLU на отдельном сервере, выполните рекомендации из пункта "Установка базовых компонентов - Studio и Core" и далее выполните запуск бот-платформы в соответствии с рекомендациями текущего раздела.
Настройка подключения к БД PostgreSQL
Для работы бот-платформы требуется база данных. По умолчанию используется встроенная база SQLlite, этой базы данных достаточно для тестирования.
Для использования на промышленной среде, рекомендуем использовать отдельную базу данных на PostgreSQL.
Для работы с базой PostgreSQL:
- Создайте новую базу данных перед запуском бот-платформы.
- После создания базы данных необходимо сформировать стандартную строку подключения PG в переменных среды DATABASE_URL. DATABASE_URL=postgres://login:password@your-db-host.com:5432/your-db-name
- Настройку можно добавить в файл .env, создав его в папке установки бот-платформы.
- Если вы хотите использовать строку подключения PostgresSQL по умолчанию, задайте ее следующим образом: DATABASE_URL=postgres
Подготовка к продуктиву
После выполнения всех указанных выше настроек убедитесь что в консоли https://bot.bank/admin/checklist соответствующие пункты отмечены галкой и выполните подключение чат-платформы в соответствии с инструкцией.