Настройка и запуск Visiology Cortex

Настройка и запуск Visiology Cortex

Visiology Cortex – это сервис искусственного интеллекта, предназначенный для расширения возможностей пользователей платформы. Сервис объединяет в себе специализированных ИИ-агентов, которые автоматизируют сложные задачи, ускоряют анализ данных, снижают нагрузку на аналитиков и позволяют бизнес-пользователям быстро получать точные ответы на интересующие бизнес-вопросы.

Сервис глубоко интегрирован в платформу Visiology, все действия выполняются от имени пользователя с учетом его прав доступа, что гарантирует прозрачность и безопасность работы.

Активация модуля

Для активации модуля необходимо сделать следующее:

  1. Остановите платформу, выполнив команду:
     /var/lib/visiology/scripts/run.sh --stop

  2. Выполните поочередно следующие команды:
    /var/lib/visiology/scripts/v3/prepare-config.sh --with-ai-agent true

  3. Запустите платформу:
    /var/lib/visiology/scripts/run.sh --restart

Настройка модуля для использования локальных моделей

Для использования локальных моделей сначала настройте сервер Настройка сервера для использование локальных моделей

Чтобы настроить модуль для работы с другими LLM-моделями, выполните следующие действия:

  1. Опционально. Вернуть настройки по-умолчанию

    /var/lib/visiology/scripts/v3/prepare-config.sh \ --set-default-ai-settings
  2. Выбор/изменение локальной модели и размера максимальной длины генерации:

    /var/lib/visiology/scripts/v3/prepare-config.sh \ --ai-model <model> --ai-default-max-tokens <number>

    где <model> может принимать значения VisiologyGpt-Pro-V1 и VisiologyGpt-Max-V1. Рекомендуемые значения <number> для VisiologyGpt-Pro-V1 и VisiologyGpt-Max-V1 - 100000.
    Перезапустить платформу:

    /var/lib/visiology/scripts/run.sh --restart
  3. Если требуется использование нескольких видеокарт, отредактируйте поле AI_VLLM_COMMAND в файле /var/lib/visiology/scripts/v3/env-files/ai.env и добавьте ключ --tensor-parallel-size XXX, где XXX - количество ваших видеокарт. Например:

    AI_VLLM_COMMAND="--model /models/VisiologyGpt-Max-V1 --enable-auto-tool-choice --tool-call-parser hermes --tensor-parallel-size 4"

    Работает только для модели VisiologyGpt-Max-V1

  4. Перезапустите платформу
    /var/lib/visiology/scripts/run.sh --restart

 

Настройка модуля для использования внешних моделей

  1. Откройте файл /var/lib/visiology/scripts/v3/env-files/ai.env и задайте переменным требуемые значения. Доступны следующие переменные:

    • AI_SERVER_URL – базовый URL-адрес, по которому отправляются запросы к модели.

    • AI_DEFAULT_MODEL – название модели, используемой по умолчанию.

    • AI_DEFAULT_MAX_TOKENS – размер максимальной длины генерации.

    • AI_SERVICE_TYPE – тип сервиса ИИ. Поддерживаются openai, gigachat и local.

    • AI_AUTH_SCOPE – область доступа OAuth-токена, определяющая разрешения для работы с API.

    • AI_NEED_VERIFY – флаг, указывающий, нужно ли проверять SSL-сертификат при запросах к API (если false, проверка отключена, что может быть полезно в тестовых средах).

    • AI_VLLM_COMMAND - команда для тонкой настройки запуска модели

Пример конфигурации для Local:

Пример конфигурации для OpenAI:

  • AI_SERVER_URL=https://api.proxyapi.ru/openai/v1 AI_DEFAULT_MODEL=gpt-4.1 AI_SERVICE_TYPE=openai AI_DEFAULT_MAX_TOKENS=100000 AI_AUTH_SCOPE= AI_NEED_VERIFY=true

    Конфигурация OpenAI поддерживает cервисы работающие по протоколу OpenAI API.

    Пример конфигурации для GigaChat:

    AI_SERVER_URL=https://gigachat.devices.sberbank.ru/api/v1 AI_DEFAULT_MODEL=GigaChat-2-Max AI_SERVICE_TYPE=gigachat AI_DEFAULT_MAX_TOKENS=100000 AI_AUTH_SCOPE=GIGACHAT_API_PERS AI_NEED_VERIFY=false

    Конфигурация GigaСhat требует указание параметра AI_AUTH_SCOPE. Доступны следующие значения:

  • GIGACHAT_API_PERS – версия API для физических лиц;

    • GIGACHAT_API_B2B – версия API для ИП и юрлиц при работе по предоплате;

    • GIGACHAT_API_CORP – версия API для ИП и юрлиц при работе по постоплате.

Вы также можете задать дополнительные настройки через переменные окружения в файле /var/lib/visiology/scripts/v3/env-files/ai.env:

  • Настройки аутентификации пользователей через OpenID Connect.
    Ключевые параметры:

    • AUTHORIZATION__USE_AUTHORIZATION – включает (true) или отключает (false) проверку авторизации.

    • AUTHORIZATION__OPENID_CONFIGURATION – URL конфигурации OpenID (например, https://keycloak.example.com/.well-known/openid-configuration).

    • AUTHORIZATION__REQUIRE_HTTPS_METADATA – если true, требует использования HTTPS для загрузки метаданных OpenID.

    • AUTHORIZATION__COOKIE_SAME_SITE – определяет политику SameSite для сессионных cookie (Lax, Strict, None).

    • AUTHORIZATION__COOKIE_SECURE_POLICY – если true, cookie будут передаваться только по защищенному соединению (HTTPS).

  • Параметры для работы с языковыми моделями. Поддерживаются только OpenAI-совместимые сервисы.
    Ключевые параметры:

    • OPENAI__BASE_URL – базовый адрес API LLM-провайдера.

    • OPENAI__DEFAULT_SERVICE_TYPE – тип сервиса (openai, gigachat, local). Влияет на логику работы.

    • OPENAI__DEFAULT_MODEL – модель по умолчанию.

    • OPENAI__DEFAULT_TEMPERATURE, OPENAI__DEFAULT_MAX_TOKENS – параметры генерации текста.

    • OPENAI__TIMEOUT – максимальное время ожидания ответа (в секундах).

  • Настройки, касающиеся авторизации в LLM.
    Ключевые параметры:

    • OPENAI__AUTHORIZATION__SCOPE – область доступа OAuth (если требуется).

    • OPENAI__AUTHORIZATION__VERIFY – указывает проверять ли SSL-сертификат (true/false).

    • OPENAI__AUTHORIZATION__API_KEY – ключ доступа к API (если используется).

Ниже приведены примеры настроек секции openai для разных LLM сервисов:

Local (локальный сервер)

OPENAI__BASE_URL=http://ai-vllm-openai:8000/v1 OPENAI__DEFAULT_MODEL=/models/VisiologyGpt-Small-V1 OPENAI__DEFAULT_SERVICE_TYPE=local OPENAI__DEFAULT_TEMPERATURE=0.7 OPENAI__TIMEOUT=60 OPENAI__AUTHORIZATION__VERIFY=false

GigaChat

OPENAI__BASE_URL=https://gigachat.devices.sberbank.ru/api/v1 OPENAI__DEFAULT_MODEL=GigaChat-2-Max OPENAI__DEFAULT_SERVICE_TYPE=gigachat OPENAI__DEFAULT_TEMPERATURE=0.7 OPENAI__TIMEOUT=60 OPENAI__AUTHORIZATION__SCOPE=GIGACHAT_API_PERS OPENAI__AUTHORIZATION__VERIFY=false OPENAI__AUTHORIZATION__API_KEY=XXXXXXXXXXXXXg==

OpenAI (через прокси)

OPENAI__BASE_URL=https://api.proxyapi.ru/openai/v1 OPENAI__DEFAULT_MODEL=o4-mini OPENAI__DEFAULT_SERVICE_TYPE=openai OPENAI__DEFAULT_TEMPERATURE=0.7 OPENAI__TIMEOUT=60 OPENAI__AUTHORIZATION__VERIFY=false OPENAI__AUTHORIZATION__API_KEY=sh-XXXXXXXXXXXXX
  1. Перезапустите платформу:
    /var/lib/visiology/scripts/run.sh --restart

При необходимости изменить промпт, отправляемый в ИИ-сервис, обратитесь, пожалуйста, в службу технической поддержки.

После подключения модуля ИИ-сервис получит доступ к вашим наборам данных.
Если вы обрабатываете конфиденциальную информацию, рекомендуем развернуть ИИ-агента в локальной среде для обеспечения максимальной безопасности.

Если вы используете аутентификацию через внешний Keycloak, перейдите в раздел Подключение внешнего Keycloak.


Смотрите также

Создание мер с помощью ИИ