Перейти к содержанию

Установка

Установка

WiseBot разворачивается в системах виртуализации с использованием платформы Docker.

Дополнительно для полноценной работы WiseBot потребуется установка n8n, MinIO и Chatwoot.

Содержание инструкции:

Требования

Компонент Минимальные требования
Операционная система Ubuntu Focal 20.04 (LTS) 64-bit и выше
Docker Версия 20.10+
Docker Compose Версия 2.21+
Аппаратные требования • CPU: 1 ядро
• RAM: 2 GB

Быстрая установка

1. Установка Docker

📚 Документация Docker

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh

2. Развертывание WiseBot

Шаг 1: Установка
# Создание и переход в рабочую директорию
mkdir wisebot && cd wisebot

# Загрузка конфигурационных файлов
curl -O https://git.digtlab.ru/wisebot.studio/wisebot/-/raw/main/docker-compose.yml
curl -O https://git.digtlab.ru/wisebot.studio/wisebot/-/raw/main/.env
Шаг 2: Настройка окружения

Отредактируйте файл .env для настройки базовых параметров:

# Пример настройки домена и порта
ROOT_URL=http://your-domain.ru
PORT=8080

Примечание

Полный список настраиваемых параметров смотрите в разделе Конфигурация (.env)

Шаг 3: Запуск системы
# Запуск всех сервисов в фоновом режиме
docker compose up --pull=always -d

# Проверка статуса контейнеров
docker compose ps
Шаг 4: Создание учетной записи администратора

После запуска системы выполните следующие действия:

  1. Откройте браузер и перейдите по адресу: http://localhost:3000
  2. Создайте учетную запись администратора
  3. После успешного создания учетной записи вы получите доступ к демо-проекту, который ограничен 20 интентами
Шаг 5: Активация лицензии

Для создания нового проекта с неограниченным числом интентов выполните следующие шаги:

  1. Перейдите в раздел Проекты: http://localhost:3000/admin/projects
  2. Нажмите кнопку Добавить проект

  3. Заполните поля:

    • Название проекта
    • Пространство имен (например, wb-support)
    • Лицензионный ключ
    • Язык проекта

  4. Нажмите Применить

Остановка сервисов

docker compose down

Конфигурация (.env)

Категория Переменная Описание
HTTP ROOT_URL URL приложения (по умолчанию: http://wisebot-app:3000)
PORT Порт приложения (по умолчанию: 3000)
Проект BF_PROJECT_ID ID проекта (по умолчанию: demo)
Почта MAIL_USERNAME Имя пользователя почты
MAIL_PASSWORD Пароль почты
MAIL_SERVER Сервер SMTP
MAIL_PORT Порт SMTP
OAuth OAUTH_CLIENT_ID ID клиента OAuth
OAUTH_CLIENT_SECRET Секретный ключ OAuth
OAUTH_AUTH_URL URL авторизации (по умолчанию: https://id.kloud.one/api/oidc/auth)
OAUTH_TOKEN_URL URL получения токена (по умолчанию: https://id.kloud.one/api/oidc/token)
OAUTH_PROFILE_URL URL профиля (по умолчанию: https://id.kloud.one/api/oidc/me)
OAUTH_SCOPE Область доступа OAuth (по умолчанию: openid email profile)
База данных MONGO_URL URL MongoDB (по умолчанию: mongodb://wisebot-mongo:27017/bf)
Rasa RASA_URL URL Rasa сервера (по умолчанию: http://wisebot-rasa:5005/)
BF_URL URL GraphQL endpoint (по умолчанию: http://wisebot-app:3000/graphql)
AUGMENTATION_FACTOR Коэффициент аугментации (по умолчанию: 50)
Логирование LOG_LEVEL_LIBRARIES Уровень логирования библиотек (по умолчанию: DEBUG)
LOG_LEVEL_MATPLOTLIB Уровень логирования matplotlib (по умолчанию: DEBUG)
MPLCONFIGDIR Директория конфигурации matplotlib (по умолчанию: /tmp/.matplotlib)
MAX_LOGGED_DATA_LENGTH Максимальная длина логируемых данных (по умолчанию: 10000)
Другое GRAPHQL_REQUEST_SIZE_LIMIT Лимит размера GraphQL запроса (по умолчанию: 10mb)
MODE Режим работы (по умолчанию: production)

Дополнительные компоненты

Установка N8N (Action Server)

n8n — это инструмент для автоматизации рабочих процессов и интеграции различных приложений и сервисов. Он позволяет пользователям создавать сложные автоматизированные процессы без необходимости писать код, используя визуальный интерфейс.

В сочетании с продуктом WiseBot, инструмент n8n способен выступать в роли action-сервера, реализуя пользовательские сценарии и обеспечивая интеграцию с внешними системами. Это значительно расширяет возможности обычных чат-ботов, позволяя им функционировать как полноценные цифровые ассистенты.

📚 Документация N8N

# Загрузка конфигурационных файлов
curl -O https://git.digtlab.ru/wisebot.studio/wisebot/-/raw/main/n8n/docker-compose.yml
curl -O https://git.digtlab.ru/wisebot.studio/wisebot/-/raw/main/n8n/.env

# Запуск сервисов
docker compose up --pull=always -d

Установка Minio (S3 хранилище)

MinIO — это высокопроизводительное, распределенное хранилище объектов, совместимое с API Amazon S3. Он разработан для работы с большими объемами данных и идеально подходит для облачных приложений, анализа данных и хранения бэкапов.

При реализации функциональности обычного чат-бота и цифрового ассистента в качестве ответов могут использоваться предварительно сохраненные изображения. Для хранения этих изображения (как впрочем и других файлов, используемых в ответах ассистента), должно быть подключено хранилище объектов с доступом по REST API.

📚 Документация Minio

# Загрузка конфигурационных файлов
curl -O https://git.digtlab.ru/wisebot.studio/wisebot/-/raw/main/minio/docker-compose.yml
curl -O https://git.digtlab.ru/wisebot.studio/wisebot/-/raw/main/minio/.env

# Запуск сервисов
docker compose up --pull=always -d

Установка Chatwoot

Chatwoot — это открытая платформа для управления взаимодействием с клиентами, которая позволяет компаниям общаться с клиентами через различные каналы, такие как веб-чаты, электронная почта, социальные сети и мессенджеры. Она предназначена для улучшения клиентского обслуживания и повышения уровня взаимодействия.

📚 Документация Chatwoot

# Загрузка конфигурационных файлов
curl -O https://git.digtlab.ru/wisebot.studio/wisebot/-/raw/main/chatwoot/docker-compose.yml
curl -O https://git.digtlab.ru/wisebot.studio/wisebot/-/raw/main/chatwoot/.env

# Запуск сервисов
docker compose up --pull=always -d