Документация по эксплуатации

«КОРТЕКС» (далее — Система) — корпоративная программная платформа для безопасной работы с большими языковыми моделями (LLM) и базами знаний организации в полностью изолированном (on-premise, без доступа в Интернет) контуре.

Основные функции:

• диалог с языковой моделью на русском языке (локальный инференс);
• интеллектуальный поиск по документам с цитированием (RAG) — загрузка документов в базу знаний и получение ответов со ссылками на источники;
• граф знаний — извлечение сущностей и связей из документов;
• распознавание текста (OCR), включая рукописный и сканированный;
• анализ совещаний — расшифровка аудио и формирование протоколов;
• сравнение документов, библиотека сценариев и промптов, разграничение прав по рабочим пространствам и ролям.

Все вычисления выполняются локально; передача данных во внешние сервисы не производится.

Для работы пользователя необходим веб-браузер и сетевой доступ к серверу, на котором развёрнута Система (порт 8189). Серверная часть и требования к ней описаны в документе «Инструкция по установке». Установка дополнительного ПО на рабочее место пользователя не требуется.

1. Открыть в браузере адрес Системы: http://<адрес-сервера>:8189.
2. Ввести учётные данные (e-mail и пароль). Демонстрационный доступ: demo@cortex.ru / CortexDemo2026.
3. При наличии доступа к нескольким рабочим пространствам — выбрать рабочее пространство.

После входа открывается основной интерфейс с разделами «Чаты», «База знаний», «Граф знаний» и (для административных ролей) разделами управления.

5.1. Диалог с моделью

Открыть раздел «Чаты» → выбрать сценарий (или открыть готовый чат) → ввести вопрос → получить потоковый ответ. При необходимости к сценарию подключается база знаний или граф знаний.

5.2. Ответ по документам с цитированием (RAG)

1. Открыть готовый чат «Демонстрация: вопросы по документу» (в комплекте уже настроены сценарий и база знаний с проиндексированным документом).
2. Задать вопрос по содержанию документа.
3. Получить ответ со ссылками на источники (блок «Использованные источники»).

Для загрузки собственных документов (роль администратора пространства): раздел «База знаний» → создать коллекцию → загрузить документ → дождаться завершения индексации (статус «обработан») → задавать вопросы по коллекции в чате.

5.3. Вложения к чату

Прикрепить объёмный документ непосредственно к сообщению для разового анализа без добавления в базу знаний.

5.4. Анализ совещаний

Загрузить аудиозапись совещания → получить расшифровку с разделением по участникам, протокол, решения и поручения → экспортировать результат. (Расшифровка аудио рекомендуется к выполнению на сервере с GPU.)

5.5. Сравнение документов

Загрузить две версии документа → получить таблицу изменений (что добавлено, удалено, изменено) и краткое заключение.

5.6. Граф знаний

Просмотреть сущности и связи организации, извлечённые из документов; задать вопрос о связях между сущностями.

Для административных ролей доступны:

• управление пользователями и ролями, рабочими пространствами;
• управление коллекциями базы знаний, сценариями, шаблонами документов;
• включение/отключение функциональных модулей;
• настройка квот рабочего пространства;
• управление локальными языковыми моделями (просмотр перечня).

Журналирование. Логи каждого компонента доступны штатными средствами Docker:

docker logs <имя-контейнера>

Все значимые действия пользователей фиксируются в журнале аудита внутри Системы (доступен роли «Аудитор»).

Контроль состояния. Состояние сервисов отслеживается встроенными healthcheck-проверками Docker (docker compose ps) и служебной точкой проверки работоспособности /api/health.

Резервное копирование. Данные хранятся в именованных томах Docker (cortex_reestr_pgdata, cortex_reestr_qdrantdata, cortex_reestr_neo4jdata, cortex_reestr_ollama, cortex_reestr_storage и др.). Резервная копия выполняется архивированием этих томов; восстановление — распаковкой томов и повторным запуском Системы (./deploy.sh).

Остановка Системы (с сохранением данных):

./stop.sh

Полная остановка с удалением данных: ./stop.sh --purge.