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

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

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

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

Остановите платформу, выполнив команду:
/var/lib/visiology/scripts/run.sh --stop
Выполните поочередно следующие команды:
/var/lib/visiology/scripts/v3/prepare-config.sh --with-ai-agent true
/var/lib/visiology/scripts/v3/prepare-config.sh --ai-api-key <your-key>
/var/lib/visiology/scripts/v3/prepare-config.sh -f
Запустите платформу:
/var/lib/visiology/scripts/run.sh --restart

Настройка модуля

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

Откройте файл /var/lib/visiology/scripts/v3/env-files/ai.env и задайте переменным требуемые значения. Доступны следующие переменные:
- AI_SERVER_URL – базовый URL-адрес, по которому отправляются запросы к модели.
- AI_DEFAULT_MODEL – название модели, используемой по умолчанию.
- AI_SERVICE_TYPE – тип сервиса ИИ. Поддерживаются openai, gigachat и ollama.
- AI_NEED_AUTH – флаг, указывающий, требуется ли аутентификация для доступа к API.
- AI_AUTH_URL – URL-адрес сервера авторизации, где можно получить OAuth-токен для доступа к API.
- AI_AUTH_SCOPE – область доступа OAuth-токена, определяющая разрешения для работы с API.
- AI_NEED_VERIFY – флаг, указывающий, нужно ли проверять SSL-сертификат при запросах к API (если false, проверка отключена, что может быть полезно в тестовых средах).

Пример конфигурации для OpenAI:
AI_SERVER_URL=https://api.proxyapi.ru/openai/v1 AI_DEFAULT_MODEL=gpt-4.1 AI_SERVICE_TYPE=openai AI_NEED_AUTH=true AI_AUTH_URL= 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_NEED_AUTH=true AI_AUTH_URL=https://ngw.devices.sberbank.ru:9443/api/v2/oauth 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 для ИП и юрлиц при работе по постоплате.
Пример конфигурации для Ollama:
AI_SERVER_URL=http://192.168.23.107:11434/v1 AI_DEFAULT_MODEL=qwen3:4b AI_SERVICE_TYPE=ollama AI_NEED_AUTH=false AI_AUTH_URL= AI_AUTH_SCOPE= AI_NEED_VERIFY=true
Для конфигурации Ollama требуется сервер с настроенным приложением Ollama. Рекомендуется использовать модель Qwen3, но можно использовать любую доступную.

Вы также можете выполнить дополнительные настройки через переменные окружения:

Настройки аутентификации пользователей через 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, ollama). Влияет на логику работы.
- OPENAI__DEFAULT_MODEL – модель по умолчанию.
- OPENAI__DEFAULT_TEMPERATURE, OPENAI__DEFAULT_MAX_TOKENS – параметры генерации текста.
- OPENAI__TIMEOUT – максимальное время ожидания ответа (в секундах).
Настройки, касающиеся авторизации в LLM.
Ключевые параметры:
- OPENAI__AUTHORIZATION__NEED_AUTH – указывает требуется ли аутентификация в API LLM.
- OPENAI__AUTHORIZATION__AUTH_URL – эндпоинт для получения токена (актуально для GigaChat).
- OPENAI__AUTHORIZATION__SCOPE – область доступа OAuth (если требуется).
- OPENAI__AUTHORIZATION__VERIFY – указывает проверять ли SSL-сертификат (true/false).
- OPENAI__AUTHORIZATION__API_KEY – ключ доступа к API (если используется).

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

GigaChat

"openai": {
    "base_url": "https://gigachat.devices.sberbank.ru/api/v1",
    "default_model": "GigaChat-2",
    "default_service_type": "gigachat",
    "default_temperature": 1,
    "default_max_tokens": 1024,
    "timeout": 60,
    "authorization": {
      "need_auth": true,
      "auth_url": "https://ngw.devices.sberbank.ru:9443/api/v2/oauth",
      "scope": "GIGACHAT_API_PERS",
      "verify": false,
      "api_key": "MhR2YWMxMDMszdzhLKHJOTVmOWY1MDU0Zj7LHJkGSaGFhNjMzLWEwMTEzRhLTE1NTNmZWU4MjdjMg=="
    }
}

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

"openai": {
    "base_url": "http://192.168.23.107:11434/v1",
    "default_model": "qwen3:4b",
    "default_service_type": "ollama",
    "default_temperature": 1,
    "default_max_tokens": 1024,
    "timeout": 60,
    "authorization": {
      "need_auth": false,
      "auth_url": "",
      "scope": "",
      "verify": false,
      "api_key": ""
    }
}

Стандартный сервер Ollama не требует авторизации. Параметр `need_auth` следует установить в `true` только если вы используете прокси-сервер с аутентификацией.

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

"openai": {
    "base_url": "https://api.proxyapi.ru/openai/v1",
    "default_model": "o4-mini",
    "default_service_type": "openai",
    "default_temperature": 1,
    "default_max_tokens": 1024,
    "timeout": 60,
    "authorization": {
      "need_auth": true,
      "auth_url": "",
      "scope": "",
      "verify": false,
      "api_key": "sh-P2PduoftaDKVBHdkg6fkDcD0wHFiiW8A6UxAumyuOnSy"
    }
}

Остановите платформу, выполнив следующую команду:
/var/lib/visiology/scripts/run.sh --stop
Примените настройки, выполнив следующую команду:
/var/lib/visiology/scripts/v3/prepare-config.sh -f
Запустите платформу:
/var/lib/visiology/scripts/run.sh --restart

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

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

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

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

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

На этой странице

1 Активация модуля
2 Настройка модуля

Нужна дополнительная помощь?

Свяжитесь с технической поддержкой.