Паспорт ИС "Платформа ИИ"
ООО "ГК "Иннотех", домен Искусственный интеллект, 2026 г.
Общие сведения
| Наименование ИС | Платформа ИИ |
| Краткое описание ИС | Платформа для разработки, прототипирования и применения AI-агентов: визуальное конструирование пайплайнов в Low-code IDE, среда исполнения Low-code Runtime, каталог агентов Agent Registry, управляемый сервис извлечения знаний Platform RAG и управляемый слой персистентной памяти Memory Service. |
| ИС реализует следующие функции | Визуальное создание и проверка агентских пайплайнов; автоматическое обнаружение и каталогизация агентов в Kubernetes; вызов агентов через единый Gateway с проверкой прав доступа; приём документов и гибридный поиск с фильтрацией по правам; персистентная память агентов с извлечением фактов через LLM; управление ролями и рабочими пространствами. |
| Критичность ИС | Other |
Адрес размещения электронной версии Паспорта ИС: TBD
| Версия | Дата | Автор | Описание изменений |
|---|---|---|---|
| 1 | 2026-08-14 | Кириенко Леонид Александрович | Сформирован впервые |
Связанные с Паспортом документы:
| № п/п | Название документа | Ссылка |
|---|---|---|
| 1. | Архитектура ИС. | |
| 2. | Руководство Администратора ИС | |
| 3. | Руководство пользователя ИС |
Рабочая группа по подготовке ИС к передаче на сопровождение (далее – РГ):
| № | ФИО, должность | Роль |
|---|---|---|
| 1 | Тарасов Никита Сергеевич | Руководитель РГ. Представитель команды внедрения |
| 2 | Карпович Сергей Анатольевич | Бизнес-владелец ИС |
| 3 | Валышев Антон Владимирович | Технический владелец ИС (представитель команды сопровождения) |
| 4 | Алферов Виктор Андреевич | Представитель команды разработки |
| 5 | Цуников Роман Валерьевич, Пищулин Андрей Евгеньевич | Представитель от инфраструктуры |
| 6 | Тишкевич Александр Игоревич, Сластилов Андрей Юрьевич | Представитель ДИБ |
| 7 | Коршиков Ярослав Николаевич, Возчиков Андрей Николаевич | Архитектор |
Термины и сокращения
| Термин (сокращение) | Описание |
|---|---|
| Платформа ИИ | Платформа для разработки, прототипирования и применения AI-агентов, включающая Low-code IDE, Low-code Runtime, Agent Registry, Platform RAG и Memory Service. |
| Low-code IDE | Адаптированная версия LangFlow — визуальный редактор для конструирования и отладки агентских пайплайнов с входом через SSO, проверкой политики компонентов и экспортом версионированных артефактов. |
| Low-code Runtime | Универсальная среда исполнения пайплайна LangFlow; исполняет один неизменяемый пайплайн через lfx и предоставляет согласованные интерфейсы A2A и MCP. |
| Agent Registry | Сервис-каталог агентов и MCP-серверов; автоматически обнаруживает агенты в Kubernetes, обеспечивает просмотр, поиск и проверку карточек A2A/MCP с авторизацией через SpiceDB. |
| Platform RAG | Управляемый сервис извлечения знаний (RAG): реестр коллекций, приём документов, гибридный поиск (kNN + BM25) с фильтрацией по правам доступа и упаковка контекста. |
| Memory Service | Управляемый слой персистентной памяти агентов: извлечение фактов через LLM, мультисигнальный поиск, CRUD записей с историей, рабочая память сессий; контракт API совместим с mem0. |
| Platform Agent Gateway | Каноническая точка вызова агента; повторно проверяет токен и право вызова через SpiceDB, заменяет исходный пользовательский токен на короткоживущее удостоверение. |
| Kubernetes (k8s) | Система оркестрации контейнеров, обеспечивающая автоматическое развертывание, масштабирование и управление микросервисами. |
| Garden | Единый инструмент сборки и развёртывания компонентов Платформы ИИ; ручные helm/kubectl не являются поддерживаемым способом. |
| Helm | Инструмент управления пакетами для Kubernetes, используемый для развёртывания и управления приложениями через чарты. |
| A2A (Agent-to-Agent) | Протокол взаимодействия агентов версии 1.0.0, HTTP+JSON. |
| MCP (Model Context Protocol) | Протокол контекста моделей, редакция 2025-11-25, Streamable HTTP. |
| GraphQL | Язык запросов для API, используемый в Agent Registry и других компонентах. |
| OpenAPI | Спецификация REST API версии 3.1.2; JSON Schema — 2020-12. |
| Keycloak | Сервис аутентификации и управления доступом на основе OpenID Connect и SSO, интегрированный в платформу. |
| OpenID Connect (OIDC) | Протокол аутентификации поверх OAuth 2.0, используемый для авторизации пользователей в платформе. |
| SpiceDB | Открытое ядро авторизации на основе ReBAC (Relationship-Based Access Control), используемое для управления разрешениями и политиками доступа на уровне ресурсов. |
| PostgreSQL | Реляционная СУБД, используемая как основное хранилище метаданных платформы. |
| OpenSearch | Поисковая система, применяемая для гибридного поиска (kNN-векторы + BM25) в Agent Registry и Platform RAG. |
| RabbitMQ | Брокер сообщений для асинхронной очереди приёма документов в Platform RAG и извлечения фактов в Memory Service. |
| Redis | Ключ-значение хранилище, используемое для кэширования результатов запросов (Platform RAG) и рабочей памяти сессий (Memory Service). |
| S3 | Протокол объектного хранилища, используемого для staging-объектов в Platform RAG. |
| AI Gateway | Платформенная служба эмбеддинга, реранкинга и LLM-инференса; используется Platform RAG и Memory Service. |
| Guardrails | Сервис маскирования персональных данных на границе записи в Memory Service и Platform RAG. |
| Audit | Immutable-лог всех операций с памятью и приёме документов. |
| lfx | Поддерживаемый интерфейс исполнения пайплайнов LangFlow; Low-code Runtime проверяет совместимость с lfx перед запуском. |
| FileRef | Связанный с пользователем, агентом и операцией токен доступа к файлу со сроком действия; передаётся вместо прямых URL. |
| ReBAC (Relationship-Based Access Control) | Модель управления доступом на основе отношений между субъектами, ресурсами и контекстом; реализована в SpiceDB. |
| JWT (JSON Web Token) | Формат токена, используемый для аутентификации и авторизации в платформе. |
| SSO (Single Sign-On) | Механизм единой аутентификации, обеспечиваемый Keycloak. |
| DAG (Directed Acyclic Graph) | Направленный ациклический граф, используемый для описания пайплайнов в визуальном редакторе. |
| SBOM | Software Bill of Materials — перечень зависимостей программного обеспечения в формате CycloneDX. |
| OpenTelemetry Collector | Служба приёма телеметрии (метрики, трассировки, журналы). |
| Redpanda | Kafka-совместимый брокер сообщений для доставки изменений каталога (Outbox Relay Agent Registry). |
| AIGW (AI Gateway) | Платформенный шлюз для эмбеддинга, реранкинга и LLM-инференса; используется Platform RAG, Memory Service и Low-code Runtime. |
Информация об ИС
Компонентная архитектура
Платформа представляет собой набор микросервисов, развёртываемых в Kubernetes-кластере. Каждый компонент имеет собственную границу данных и ответственности.
Основные преимущества микросервисной архитектуры:
- Масштабируемость. Горизонтальное масштабирование отдельных сервисов (API, воркеры, обработчики) для увеличения производительности конкретных компонентов.
- Гибкость в выборе технологий. Для каждого сервиса выбирается наиболее подходящий язык программирования и фреймворк.
- Отказоустойчивость. Сбой одного компонента не приводит к остановке всей платформы; отказ поискового сервиса не блокирует приём документов.
- Непрерывная доставка. Стратегия Rolling Updates обеспечивает плавное обновление без простоя.
Компоненты поставки
| Компонент | Назначение |
|---|---|
| Low-code IDE | Визуальный редактор для создания, сохранения и проверки агентских пайплайнов; адаптированная версия LangFlow с SSO-входом и политикой компонентов. |
| Low-code Runtime | Среда исполнения пайплайна; исполняет один неизменяемый агентский пайплайн и предоставляет интерфейсы A2A и MCP. |
| Agent Registry | Сервис-каталог агентов; автоматическое обнаружение в Kubernetes, каталог, поиск с учётом прав, проверка карточек A2A/MCP. |
| Platform RAG | Управляемый сервис извлечения знаний: реестр коллекций, приём документов, гибридный поиск с фильтрацией по ACL. |
| Memory Service | Управляемый слой персистентной памяти: извлечение фактов, мультисигнальный поиск, CRUD записей, рабочая память сессий. |
Платформенные зависимости
| Зависимость | Назначение |
|---|---|
| PostgreSQL | Каноническое хранилище метаданных каталога и рабочих данных Low-code IDE |
| SpiceDB | Хранение разрешений и проверка прав доступа (ReBAC) |
| OpenTelemetry Collector | Сбор метрик, трассировок и журналов |
| Redpanda | Канал изменений событий (Outbox Relay Agent Registry) |
| OpenSearch | Поисковая проекция для Agent Registry, Platform RAG и Memory Service |
| RabbitMQ | Очередь приёма документов (Platform RAG) и извлечения фактов (Memory Service) |
| Redis | Кэш результатов запросов (Platform RAG) и рабочая память сессий (Memory Service) |
| Keycloak | Провайдер аутентификации OIDC / SSO |
| AI Gateway | Эмбеддинг, реранкинг и LLM-инференс |
Разделение образов
Образы платформы публикуются в выделенное хранилище артефактов (nexus и т.п.), доступное из узлов кластера.
Сквозной пользовательский путь
- Автор создаёт и сохраняет пайплайн агента в Low-code IDE.
- Low-code IDE проверяет структуру пайплайна и формирует версионированные исходные данные.
- Оператор вручную размещает исходные данные и манифест (Agent Publisher в данной версии отсутствует).
- Low-code Runtime проверяет контрольные суммы и переходит в состояние готовности.
- Agent Registry обнаруживает службу Low-code Runtime в Kubernetes и добавляет информацию в каталог.
- Пользователь находит агента в Agent Registry. Наличие записи не означает наличие права на вызов.
- Вызов выполняется через Platform Agent Gateway после проверки права
agent#invokeв SpiceDB. Исходный пользовательский токен не передаётся в Low-code Runtime.
Тип расположения ИС
Локальная:
| Вариант | Необходимо выбрать |
|---|---|
| Однопользовательская (устанавливается на АРМ) | |
| Клиент-сервер (в пределах одной территории) | Х |
Распределённая:
| Вариант | Необходимо выбрать |
|---|---|
| С одной серверной группировкой | Х |
| Распределённая серверная группировка |
| Вариант | Необходимо выбрать |
|---|---|
| В облачной инфраструктуре. Вид тенанта: | |
| · Изолированный | |
| · Внутренний | Х |
| На физических серверах |
Адрес размещения: TBD
Архитектура ИС:
| Вариант | Необходимо выбрать |
|---|---|
| Монолитная | |
| Многоуровневая | |
| Микросервисная | Х |
Описание серверного состава ИС и других инфраструктурных ресурсов
| Назначение | CPU, шт | RAM, Гб | HDD, Гб |
|---|---|---|---|
| — | — | — | — |
| — | — | — | — |
Примечание: Точные параметры серверного состава и инфраструктуры будут определены на этапе подготовки к промышленной эксплуатации.
Описание реализуемых бизнес-процессов
Ниже приведены базовые опорные сценарии использования платформы.
Блок 1: Создание и проверка пайплайна агента
1. Создание нового агента в Low-code IDE
Участники: Автор агента (AI-инженер / DS-специалист).
Контекст: Необходимо создать агента для автоматизации бизнес-задачи (например, анализ документов, генерация контента).
Процесс:
- Автор открывает адрес Low-code IDE и входит через SSO платформы.
- Создаёт новую пайплайн или открывает рабочую версию.
- Добавляет компоненты из разрешённой палитры: вход,
PlatformLLM, выход. - Настраивает параметры LLM-компонента, связи между узлами и формат выходных данных.
- Сохраняет пайплайн с осмысленным названием, отражающим назначение агента.
2. Проверка пайплайна перед передачей
Участники: Автор агента.
Контекст: Пайплайн создан, требуется убедиться в корректности структуры и соответствии политикам.
Процесс:
- Автор запускает встроенную проверку пайплайна.
- Проверка подтверждает: корректность структуры, отсутствие недопустимых циклов, наличие обязательных полей, соответствие политике компонентов, отсутствие открытых секретов, совместимость с версией
lfx. - При наличии ошибок (например,
component_not_allowed) автор вносит исправления в схему и повторяет проверку. - После успешной проверки автор фиксирует версию и контрольную сумму передаваемых данных.
Блок 2: Развёртывание и каталогизация агента
3. Ручная передача пайплайна оператору
Участники: Автор агента, Оператор платформы.
Контекст: Agent Publisher в версии 2026.3.3 отсутствует; требуется ручная процедура передачи.
Процесс:
- Автор передаёт оператору проверенные исходные данные (
source.json) и манифест (manifest.json). - Оператор запускает общий модуль проверки и формирования манифеста, фиксирует контрольные суммы.
- Оператор загружает артефакты в объектное хранилище по пути, содержащему контрольную сумму.
- Оператор развёртывает экземпляр агента в Kubernetes с обязательными метками, включая
agent-platform.inno.tech/implementation-type=low-code.
4. Автоматическое обнаружение агента в каталоге
Участники: Пользователь платформы.
Контекст: Агент развёрнут, требуется найти его в каталоге.
Процесс:
- Agent Registry автоматически обнаруживает сервис агента через мониторинг Service, EndpointSlice и HTTPRoute в Kubernetes.
- Reconciler обновляет каталог: классифицирует протокол (
a2a/mcp) и тип реализации (sdk/low-code). - Пользователь открывает каталог, находит агента по названию, владельцу, рабочему пространству, протоколу или типу реализации.
- Карточка агента содержит описание возможностей и информацию о доступных интерфейсах.
Блок 3: Вызов агента
5. Вызов агента через Platform Agent Gateway
Участники: Пользователь платформы, Потребитель агента.
Контекст: Агент найден в каталоге, требуется выполнить вызов.
Процесс:
- Пользователь получает URL вызова из карточки агента в каталоге.
- Запрос направляется через Platform Agent Gateway, который повторно проверяет токен и право вызова агента через SpiceDB.
- Gateway заменяет исходный пользовательский токен на короткоживущее удостоверение, связанное с конкретным агентом.
- Исходный пользовательский токен не передаётся в Low-code Runtime.
- Результаты выполнения возвращаются пользователю через Gateway.
6. Вызов агента с файлом (FileRef)
Участники: Потребитель агента, принимающий файлы.
Контекст: Агент принимает входные файлы (например, документы для анализа).
Процесс:
- Пользователь передаёт FileRef вместо прямого URL или пути к хранилищу.
- FileRef связан с пользователем, целевым агентом, операцией и сроком действия.
- Изменённый, просроченный или предназначенный другому агенту FileRef отклоняется до выполнения пайплайна.
Блок 4: Использование Platform RAG
7. Приём и поиск в коллекции Platform RAG
Участники: Автор агента, Интеграционный сервис.
Контекст: Необходимо подготовить базу знаний для агента с использованием Platform RAG.
Процесс:
- Интеграционный сервис извлекает данные из источника, применяет ACL и передаёт нормализованные документы через RAG API.
- Сервис проверяет права доступа через SpiceDB, выполняет дедупликацию и создаёт задание в job store со статусом
PENDING. - Воркеры ingestion обрабатывают задание: чанкинг, эмбеддинг через AI Gateway, индексация в OpenSearch.
- Потребитель вызывает поиск через Platform SDK или кастом-компонент Langflow, указывая коллекцию и текст запроса.
- Конвейер поиска: переписывание запроса → гибридный поиск (kNN + BM25) со слиянием RRF → фильтрация по ACL → реранк → упаковка контекста с цитатами.
- Результаты содержат цитаты (ссылки на
doc_id/chunk_id), обеспечивая атрибуцию ответов.
Блок 5: Использование Memory Service
8. Добавление и поиск персистентной памяти
Участники: Разработчик агента, Пользователь платформы.
Контекст: Агент должен запоминать факты о пользователях, сессиях и задачах для обращения к ним в будущем.
Процесс:
- Агент отправляет ход диалога — платформа извлекает атомарные факты через LLM-инференс на собственных GPU через AI Gateway.
- Извлечение выполняется асинхронно: сообщение попадает в очередь RabbitMQ, воркеры извлекают факты, проводят дедупликацию и индексируют в OpenSearch.
- Результат извлечения возвращается через
event_id. Guardrails маскирует ПД на границе записи. - Перед вызовом LLM агент ищет релевантные факты по семантике и BM25 (мультисигнальный поиск).
- Результаты ранжированы и уложены в заданный бюджет токенов.
- Разработчик и аудитор читают, правят и удаляют конкретные записи памяти, видят историю изменений.
- Пользователь может просматривать, редактировать и удалять записи об себе через интерфейс T1GPT (право на забвение).
9. Рабочая память сессии
Участники: Разработчик агента.
Контекст: Агенту необходимо сохранять и восстанавливать состояние сессии.
Процесс:
- Агент сохраняет чекпоинт сессии через Memory Service.
- Рабочая память хранится в Redis с настраиваемым TTL (по умолчанию 24 часа, диапазон от 60 секунд до 30 дней).
- При возобновлении сессии агент восстанавливает чекпоинт — без необходимости собственного Redis-инфраструктуры.
Описание доступов к компонентам ИС, необходимых для обеспечения поддержки ИС
| Среда | Назначение ВМ / ресурса | Наименование машины / ресурса | Адрес машины / DNS | Что размещено | Необходимый уровень доступа для администрирования |
|---|---|---|---|---|---|
| DEV | Kubernetes namespace ap-st (ядро платформы) | k8s API | 10.9.123.31-36 | Компоненты ядра ИС | Полный доступ на уровне kubectl |
| QA | Kubernetes namespace ap-qa (ядро платформы) | k8s API | 10.9.123.31-36 | Компоненты ядра ИС | Полный доступ на уровне kubectl |
| UAT | Kubernetes namespace ap-uat (ядро платформы) | k8s API | 10.9.108.20, 10.9.108.21, 10.9.108.22 | Компоненты ядра ИС | Полный доступ на уровне kubectl |
| UAT | Kubernetes namespace TBD (NS для развертывания агентов) | k8s API | --/-- | Агентская нагрузка | Полный доступ на уровне kubectl |
| PreProd | Kubernetes namespace ap-preprod (ядро платформы) | k8s API | 10.10.22.20 | Компоненты ядра ИС | Полный доступ на уровне kubectl |
| PreProd | Kubernetes namespace TBD (NS для развертывания агентов) | k8s API | --/-- | Агентская нагрузка | Полный доступ на уровне kubectl |
| PreProd | база данных ИС | PostgreSQL | in-vrl-psql1; in-vrl-psql2; in-vrl-psql3 | База данных ИС | SSH, администратор БД |
| Prod | Kubernetes namespace ap-prod (ядро платформы) | k8s API | 10.10.21.20, 10.10.21.21, 10.10.21.22 | Компоненты ядра ИС | Полный доступ на уровне kubectl |
| Prod | Kubernetes namespace TBD (NS для развертывания агентов) | k8s API | --/-- | Агентская нагрузка | Полный доступ на уровне kubectl |
| Prod | база данных ИС | PostgreSQL | in-vpl-psql1; in-vpl-psql2; in-vpl-psql3 | База данных ИС | SSH, администратор БД |
Описание серверного состава ИС и других инфраструктурных ресурсов
Примечание: Ресурсы CPU, RAM, а также дисковая память выделяются динамически в k8s кластере.
DEV
| № п/п | Тип сервера | DNS имя / IP адрес | Строка доступа к ресурсу | Параметры | Дисковое пространство и тип дисков | Операционная система |
|---|---|---|---|---|---|---|
| 1 | opentelemetry | agent-platform-opentelemetry-collector | grpc://:4317 | distroless | ||
| 2 | opentelemetry | agent-platform-opentelemetry-collector | http://:4318 | distroless | ||
| 3 | Сервер БД | agent-platform-postgresql | postgresql://:5432 | VMware Photon OS 5.0 | ||
| 4 | Сервис авторизации (SpiceDB) | agent-platform-spicedb | http://:8443 | distroless | ||
| 5 | Сервис авторизации (SpiceDB) | agent-platform-spicedb | grpc://:50051 | distroless | ||
| 6 | agent-registry | ap-agent-registry-api | http://:8080 | Debian GNU/Linux 13.6 | ||
| 7 | Сервис эмбеддингов | ap-agent-registry-embeddings | http://:80 | Debian GNU/Linux 13.6 | ||
| 8 | keycloak | ap-agent-registry-keycloak-http | http://:8443 | RHEL 9.6 | ||
| 9 | Сервис онлайн докумнетации | ap-team-docs-web | http://:8080 | Debian GNU/Linux 13.6 | ||
| 10 | Langflow IDE (back) | langflow-backend | http://:7860 | RHEL 10.2 | ||
| 11 | Langflow IDE (front) | langflow-frontend | http://:80 | Debian GNU/Linux 12 | ||
| 12 | Кластер opensearch | opensearch-cluster-master | http://:9200 | Amazon Linux 2023.12.20260710 | ||
| 13 | Кластер opensearch | opensearch-cluster-master | tcp://:9300 | Amazon Linux 2023.12.20260710 | ||
| 14 | Кластер opensearch | opensearch-cluster-master | http://:9600 | Amazon Linux 2023.12.20260710 | ||
| 14 | Брокер RedPanda | agent-platform | tcp://:9092 | Debian GNU/Linux 13.6 |
Примечание: Ресурсы CPU, RAM, а также дисковая память выделяются динамически в k8s кластере. В качестве DNS имен указаны имена k8s сервисов без суффикса
ap-st.svc.cluster.local.
UAT
| № п/п | Тип сервера | DNS имя / IP адрес | Строка доступа к ресурсу | Параметры | Дисковое пространство и тип дисков | Операционная система |
|---|---|---|---|---|---|---|
| — | — | — | — | — | — | — |
PerProd
| № п/п | Тип сервера | DNS имя / IP адрес | Строка доступа к ресурсу | Параметры | Дисковое пространство и тип дисков | Операционная система |
|---|---|---|---|---|---|---|
| — | — | — | — | — | — | — |
Prod
| № п/п | Тип сервера | DNS имя / IP адрес | Строка доступа к ресурсу | Параметры | Дисковое пространство и тип дисков | Операционная система |
|---|---|---|---|---|---|---|
| — | — | — | — | — | — | — |
Примечание: Среда prod не реализована. Требуется подготовка внешних зависимостей, секреты, TLS, масштабирование и порядок отката.
Описание протоколов и портов для сетевого взаимодействия с другими ИС Компании и с внешними ИС
Примечание: Точные подсети и правила сетевого взаимодействия будут определены на этапе подготовки к промышленной эксплуатации.
DEV
| № п/п | Источник трафика (хост/подсеть) | Протокол | Получатель трафика (хост/подсеть) | Порт | Протокол | Назначение трафика |
|---|---|---|---|---|---|---|
| 1 | 10.9.123.0/24 | https | httpRoute api-gw.ai-dev.inno.tech/agent-registry | 443 | https | Взаимодействие с API реетстра |
| 2 | 10.9.123.0/24 | a2a | httpRoute api-gw.ai-dev.inno.tech/a2a | 443 | a2a | Взаимодействие с опубликованными агентами по протоколу a2a |
| 3 | 10.9.123.0/24 | https | httpRoute api-gw.ai-dev.inno.tech/keycloak | 443 | https, OIDC | Аутентификация на шлюзе OIDC |
| 4 | 10.9.123.0/24 | https | httpRoute ide.ai-dev.inno.tech | 443 | https | Работа с визуальным конструктором потоков |
| 5 | 10.9.123.0/24 | https | httpRoute docs.ai-dev.inno.tech | 443 | https | Онлайн документация платформы |
UAT
| № п/п | Источник трафика (хост/подсеть) | Протокол | Получатель трафика (хост/подсеть) | Порт | Протокол | Назначение трафика |
|---|---|---|---|---|---|---|
| 1 | 10.9.108.0/24 | https | httpRoute api-gw.ai-dev.inno.tech/agent-registry | 443 | https | Взаимодействие с API реетстра |
| 2 | 10.9.108.0/24 | a2a | httpRoute api-gw.ai-dev.inno.tech/a2a | 443 | a2a | Взаимодействие с опубликованными агентами по протоколу a2a |
| 3 | 10.9.108.0/24 | https | httpRoute api-gw.ai-dev.inno.tech/keycloak | 443 | https, OIDC | Аутентификация на шлюзе OIDC |
| 4 | 10.9.108.0/24 | https | httpRoute ide.ai-dev.inno.tech | 443 | https | Работа с визуальным конструктором потоков |
| 5 | 10.9.108.0/24 | https | httpRoute docs.ai-dev.inno.tech | 443 | https | Онлайн документация платформы |
PreProd
| № п/п | Источник трафика (хост/подсеть) | Протокол | Получатель трафика (хост/подсеть) | Порт | Протокол | Назначение трафика |
|---|---|---|---|---|---|---|
| 1 | 10.10.21.0/24 | https | httpRoute api-gw.ai-dev.inno.tech/agent-registry | 443 | https | Взаимодействие с API реетстра |
| 2 | 10.10.21.0/24 | a2a | httpRoute api-gw.ai-dev.inno.tech/a2a | 443 | a2a | Взаимодействие с опубликованными агентами по протоколу a2a |
| 3 | 10.10.21.0/24 | https | httpRoute api-gw.ai-dev.inno.tech/keycloak | 443 | https, OIDC | Аутентификация на шлюзе OIDC |
| 4 | 10.10.21.0/24 | https | httpRoute ide.ai-dev.inno.tech | 443 | https | Работа с визуальным конструктором потоков |
| 5 | 10.10.21.0/24 | https | httpRoute docs.ai-dev.inno.tech | 443 | https | Онлайн документация платформы |
Prod
| № п/п | Источник трафика (хост/подсеть) | Протокол | Получатель трафика (хост/подсеть) | Порт | Протокол | Назначение трафика |
|---|---|---|---|---|---|---|
| 1 | 10.10.22.0/24 | https | httpRoute api-gw.ai-dev.inno.tech/agent-registry | 443 | https | Взаимодействие с API реетстра |
| 2 | 10.10.22.0/24 | a2a | httpRoute api-gw.ai-dev.inno.tech/a2a | 443 | a2a | Взаимодействие с опубликованными агентами по протоколу a2a |
| 3 | 10.10.22.0/24 | https | httpRoute api-gw.ai-dev.inno.tech/keycloak | 443 | https, OIDC | Аутентификация на шлюзе OIDC |
| 4 | 10.10.22.0/24 | https | httpRoute ide.ai-dev.inno.tech | 443 | https | Работа с визуальным конструктором потоков |
| 5 | 10.10.22.0/24 | https | httpRoute docs.ai-dev.inno.tech | 443 | https | Онлайн документация платформы |
Информационная безопасность ИС
Калькулятор уровня защищённости персональных данных.
- тип ПДн — не применимо;
- количество субъектов — не применимо;
- субъекты ПДн — не применимо;
- тип актуальных угроз — не применимо.
- Расчётный уровень защищённости: не применимо.
Типы обрабатываемой информации
| Типы обрабатываемой информации | Необходимо отметить «X», если применимо |
|---|---|
| Коммерческая тайна | не применимо |
| Персональные данные (ПДн) | не применимо |
| Финансовая информация | не применимо |
Доступ к информации
| Режим доступа к информации | Необходимо отметить «X», если применимо |
|---|---|
| Однопользовательская | |
| Многопользовательская | Х |
| Одинаковые права для всех пользователей | |
| Реализована система разграничения доступа | Х |
| Тип аутентификации | Необходимо отметить «X», если применимо |
|---|---|
| Локальная | Х |
| Доменная | Х |
Уровень защищённости ПДн, обрабатываемых в ИС
| Уровень защищённости ПДн, обрабатываемых в ИС | Необходимо отметить «X», если применимо |
|---|---|
| УЗ-1 (первый уровень защищённости ПДн при их обработке в ИСПДн) | не применимо |
| УЗ-2 (второй уровень защищённости ПДн при их обработке в ИСПДн) | не применимо |
| УЗ-3 (третий уровень защищённости ПДн при их обработке в ИСПДн) | не применимо |
| УЗ-4 (четвертый уровень защищённости ПДн при их обработке в ИСПДн) | не применимо |
Категории значимости объекта КИИ
| Категории значимости объекта КИИ | Необходимо отметить «X», если применимо |
|---|---|
| КЗ-1 (первая категория значимости) | Не применимо |
| КЗ-2 (вторая категория значимости) | Не применимо |
| КЗ-3 (третья категория значимости) | Не применимо |
Класс защищённости ГИС
| Класс защищённости ГИС | Необходимо отметить «X», если применимо |
|---|---|
| КЗ-1 (первый класс защищённости) | Не применимо |
| КЗ-2 (второй класс защищённости) | Не применимо |
| КЗ-3 (третий класс защищённости) | Не применимо |
Меры по защите ИС
| № п/п | Меры | Техническое средство | Особенности реализации |
|---|---|---|---|
| 1 | Аутентификация | Корпоративный провайдер учётных записей OIDC | Аутентификация через Keycloak с протоколом OpenID Connect; SSO для всех компонентов платформы. |
| 2 | Разграничение доступа | Авторизационная информация в JWT; SpiceDB | Реализована система разграничения доступа на основе ReBAC; проверка прав на каждую операцию через SpiceDB. |
| 3 | Физический доступ к оборудованию | В соответствии с регламентами вычислительного центра | — |
| 4 | Противодействие умышленным атакам | WAF | Сервис не доступен из внешних сетей. |
| 5 | Управление уязвимостями | Регулярное обновление общесистемного и прикладного программного обеспечения. Периодическое сканирование средством анализа защищённости | Обновление общесистемного и прикладного ПО осуществляется в соответствии с положением о процессе управления обновлениями программного обеспечения. |
Перечень технических и административных учётных записей
| Наименование | Назначение | Примечание | Срок действия УЗ |
|---|---|---|---|
| workspace-admin | Администратор рабочей области (фикстурный пользователь Keycloak) | Согласно регламенту управления УЗ/секретами | |
| agent-invoker | Вызывающий агент (фикстурный пользователь Keycloak) | — | |
| unauthorized-user | Запрещённый пользователь (тест) | — | |
| — | — | — | — |
Примечание: Фикстурные пользователи создаются только в non-production средах и не переносятся в промышленную эксплуатацию. Точный перечень технических учётных записей будет определён на этапе подготовки к промышленной эксплуатации.
Администрирование
Руководитель и Подразделение, занимающееся администрированием системы:
Гурбич Богдан Васильевич, Ведущий руководитель проекта Группа проектного офиса «Платформа ИИ»
Руководитель и Подразделение, занимающееся предоставлением доступа к системе (при наличии):
Валышев Антон Владимирович, Руководитель отдела, Отдел поддержки продуктов
Маршрут предоставления доступа к ИС (необходимо указать ответственных за согласование/исполнение на каждом этапе. Маршрут должен быть согласован ДИБ):
| Бизнес-роль | Назначение | Описание прав | Лицо, принимающее решение о предоставлении доступа |
|---|---|---|---|
| Автор агента | Создание, сохранение и проверка пайплайнов агентов в Low-code IDE | Доступ к Low-code IDE в своей рабочей области; создание и редактирование пайплайнов; экспорт версионированных артефактов. | Бизнес-владелец ИС / руководитель подразделения пользователя. |
| Оператор | Ручная передача артефактов пайплайна, развёртывание Low-code Runtime в Kubernetes | Доступ к объектному хранилищу; права на создание и управление подами Kubernetes; выполнение проверки контрольных сумм. | Технический владелец ИС; согласование с ДИБ для административных и привилегированных доступов. |
| Потребитель агента | Просмотр каталога агентов и вызов разрешённых агентов через Platform Agent Gateway | Чтение каталога Agent Registry; вызов агентов при наличии права agent#invoke в SpiceDB. | Бизнес-владелец ИС; |
| Администратор платформы | Поддержание согласованного состояния компонентов, ежедневная проверка, диагностика и восстановление | Полный доступ ко всем компонентам через Garden и Kubernetes; управление зависимостями (PostgreSQL, SpiceDB, OpenSearch и др.). | Технический владелец ИС; согласование с ДИБ. |
| Интеграционный сервис | Приём документов из внешних источников в Platform RAG | Право записи в конкретную коллекцию через SpiceDB; собственные Secrets и NetworkPolicy. | Технический владелец ИС; согласование с ДИБ. |
Механизмы идентификации и аутентификации пользователей
Аутентификация в Системе выполняется с помощью внутреннего компонента Keycloak, развернутого в составе компонентов платформы.
Keycloak использует протокол OpenID Connect, для получения сведений о пользователе от внешнего OIDC провайдера.
При получении JWT на стороне внешнего провайдера, роли пользователя могут быть включены в дополнительные claims, обрабатываемые авторизационным ядром системы.
Примечание: Время жизни токена доступа по умолчанию составляет 15 минут и может быть скорректировано прикладным администратором платформы в настройках Keycloak.
Авторизация
Авторизационный механизм реализован на базе opensource решения SpiceDB. Авторизационная схема описывается декларативно и инициализируется в момент развёртывания приложения.
В системе используется модель управления доступом ReBAC (Relationship-Based Access Control). Она основана на отношениях между субъектами, ресурсами и контекстом.
Доступ определяется ролями в привязке к контексту — рабочей области (workspace), команде и агенту, а также зависит от свойств объектов и их отношений.
Шифрование
Взаимодействие пользователя с опубликованными endpoint платформы выполняется по защищённому протоколу HTTPS/TLS через Ingress.
Взаимодействие backend/API с Keycloak выполняется по HTTPS/OIDC; взаимодействие с PostgreSQL, Kubernetes API осуществляется по внутреннему сетевому контуру с использованием защищённых протоколов/сетевых политик согласно целевой инфраструктурной конфигурации.
Описание шифрования дисков системы: Шифрование дисков ВМ, persistent volumes и/или managed storage, на которых размещаются компоненты системы и данные, должно быть реализовано средствами инфраструктуры либо средствами уровня ОС. Конкретный механизм шифрования и зона ответственности подлежат подтверждению инфраструктурой перед ПЭ.
Криптографическая защита
Дополнительная криптографическая защита не используется.
| № п/п | Название сертификата: домен, который закрывается | Дата выпуска | Дата окончания действия | Выпускающий УЦ |
|---|---|---|---|---|
| 1 | *.ai-dev.inno.tech | 30.04.2026 | 30.04.2027 | Innotech Issuing Certification authority |
| 2 | *.ai.inno.tech | 27 мая 2026 | 27 мая 2027 | Innotech Issuing Certification authority |
| 3 | *.pp.ai.inno.tech | нет данных | нет данных | Innotech Issuing Certification authority |
| 4 | *.uat.ai.inno.tech | нет данных | нет данных | Innotech Issuing Certification authority |
Минимальные параметры работы ИС
| N/N | Параметр | Описание | Техническая реализация | Требуемое пороговое значение |
|---|---|---|---|---|
| 1 | Операционная система | Windows 10, macOS, Linux 8 | ||
| 2 | Центральный процессор | Intel Core i5 | ||
| 3 | Оперативная память | 8 Гб | ||
| 4 | Жёсткий диск | 100 ГБ | ||
| 5 | Браузер | Google Chrome v.123 или выше; Microsoft Edge v.123 или выше; Safari v.17 или выше; FireFox v.115 ESR или выше; Яндекс v.25 или выше. | ||
| 6 | Дополнительное программное обеспечение | Не используется |
Параметры надёжности и непрерывности ИС
| Критичность | RTO | RPO | Режим функционирования | Регламентное время работы (Мск) | Технологическое окно | План резервного копирования | План обеспечения непрерывности и аварийного восстановления (Disaster Recovery Plan, DRP) |
|---|---|---|---|---|---|---|---|
| Other | 48 часов | 24 часа (1 раз в сутки) | Не релизный | Пн – Вс 12 х 5 Интервал 06:00 – 19:00 | Пн – Пт 19:00 – 24:00 00:00 – 06:00, Сб - Вс 9:00 - 21:00 | Требуется подготовить и согласовать. Объекты: PostgreSQL, S3, Kubernetes-конфигурации. Периодичность — не реже 1 раза в сутки согласно RPO 24 ч. | Требуется подготовить и согласовать. Должен описывать восстановление Kubernetes-сервисов, БД, S3 |
Сводная таблица по организации эксплуатации ИС
Таблицу заполняет Технический владелец ИС.
| Компонент ИС | № п/п | Наименование работ | Группа поддержки |
|---|---|---|---|
| Поддержка пользователя | 1.1 | Приём, регистрация, классификация, эскалация обращений пользователей; информирование о статусе заявок. | 1-я / 2-я линия поддержки |
| Поддержка пользователя | 1.2 | Консультации пользователей и бизнес-администраторов по работе с системой и доступными инструментами. | 1-я / 2-я линия поддержки; бизнес-администратор |
| Управление доступами | 2.1 | Создание, изменение, удаление и настройка пользовательских ролей, групп, и сервисных доступов. | Группа управления пользователями / прикладной администратор / ДИБ |
| Инфраструктура / Kubernetes | 3.1 | Мониторинг и восстановление Kubernetes control plane/worker nodes, Ingress, сетевых правил и инфраструктурных ресурсов. | Команда инфраструктуры / Kubernetes / DevOps |
| СУБД и хранилища | 3.2 | Мониторинг и восстановление PostgreSQL, OpenSearch, Object Storage S3. | Команда БД / инфраструктуры / DevOps |
| Серверная часть приложения | 4.1 | Решение инцидентов и установка обновлений. | |
| Информационная безопасность | 5.1 | Анализ ИБ-событий, контроль WAF, управление уязвимостями, контроль удалённого доступа через КСПД. | ДИБ / ИБ / эксплуатация средств защиты |
| Резервное копирование | 6.1 | Контроль выполнения резервного копирования, проверка наличия резервных копий и проведение восстановления при сбое. | Инфраструктура / DevOps / команда БД |
Последовательность запуска и остановки ИС, проверка работоспособности ИС после запуска.
Запуск системы после развёртывания происходит автоматически. Специальной процедуры старта не предусмотрено.
Для проверки работоспособности после запуска необходимо убедиться в успешном старте и доступности ключевых компонентов, опубликованных на Ingress Controller.
В корневом namespace системы (k8s кластер) все компоненты должны функционировать без ошибок (поды запущены, ошибки запуска отсутствуют, не наблюдается постоянных перезапусков контейнеров, readiness probe отрабатывает штатно).
Специальной процедуры остановки системы не предусмотрено. При необходимости, отдельные компоненты системы могут быть приостановлены администратором k8s кластера путем downscale соответствующих deployment, stateful set.
Следует учитывать, что остановка произвольных компонентов системы может привести к нарушению работоспособности зависимых компонентов и всей платформы в целом.
Порядок установки обновлений
Установка обновлений производится аналогично первоначальному развёртыванию — путём обновления helm релиза приложения в целевом namespace k8s кластера через Garden.
До начала обновления все артефакты нового релиза (докер образы и helm чарты) должны быть размещены в соответствующих registry.
До начала обновления необходимо выполнить резервное копирование БД PostgreSQL для stateful компонентов системы.
Обновление рассматривается как согласованное изменение трёх компонентов (Low-code IDE, Low-code Runtime, Agent Registry), даже если они поставляются разными проектами.
Перед изменением версии необходимо:
- Зафиксировать текущее и целевое состояние всех компонентов и внешних зависимостей.
- Проверить совместимость пайплайнов Low-code с целевой версией.
- Выполнить все проверки совместимости Agent Registry (OpenAPI, Alembic, SpiceDB, Redpanda, OpenSearch).
- Выполнить
garden validate --env TARGET, затемgarden deploy --env TARGET --yes --forward.
Зафиксированные версии внешних зависимостей
| Зависимость | Версия поставки |
|---|---|
| Kubernetes | 1.36.x, исходная точная версия 1.36.2 |
| PostgreSQL | 18.4.0; базовый образ и chart 18.8.4 |
| SpiceDB | 1.54.0 |
| Redpanda Community | сервер 26.1.13, chart 26.1.9 |
| OpenSearch | 3.7.0 |
| OpenTelemetry Collector | образ 0.156.0, chart 0.165.0 |
LangFlow / lfx | 1.11.1 |
| Platform Agent Gateway | 1.3.1; Gateway API 1.5.0 |
Примечание: Основное обновление PostgreSQL на существующем постоянном томе требует отдельной проверки
pg_upgrade.
Условия немедленной остановки обновления
Остановите обновление, если:
- миграция данных завершилась ошибкой;
- прежний пайплайн Low-code не проходит целевую проверку;
- карточка или описание агента объявляет отсутствующую возможность;
- Low-code IDE может передать непроверенный или содержащий секрет источник;
- Agent Registry возвращает недоступный объект;
- новый экземпляр Reconciler не получил свежее полное наблюдение;
- поисковая проекция не сходится с метаданными.
Критерии завершения обновления
Обновление завершено только когда:
- образы, настройки, схемы данных и внешние зависимости совместимы;
- активные и откатные пайплайны Low-code прошли проверку;
- Low-code IDE создаёт повторяемый пайплайн;
- Low-code Runtime готов и исполняет принятый профиль;
- Agent Registry автоматически обнаруживает его и соблюдает отрицательные проверки доступа;
- сохранены контрольные суммы и очищенные результаты проверки;
- подтверждён применимый путь отката.
Мониторинг ИС
Примечание: Способ мониторинга платформы будет дополнен после завершения процедуры постановки на сопровождение.
Нефункциональные требования к ИС
| Область | Требование |
|---|---|
| Надёжность | Система должна обеспечивать устойчивую обработку запросов, корректную обработку ошибок внешних сервисов и повторяемость асинхронных операций при сбоях. |
| Масштабируемость | Архитектура должна допускать горизонтальное масштабирование API, воркеров, очередей и сервисов обработки. |
| Безопасность | Доступ к данным и функциям должен быть ограничен ролями, группами и ABAC-политиками. Чувствительные данные не должны попадать в логи. |
| Сопровождаемость | Компоненты должны иметь идентификаторы версий, контролируемые конфигурации, трассируемые запросы и диагностические логи. |
| Совместимость | API должны сохранять обратную совместимость в пределах согласованной версии или сопровождаться миграционными инструкциями. |
| Изоляция данных | Данные разных команд (пространств) должны быть изолированы логически и/или физически в соответствии с целевой схемой внедрения. |
Требования к времени отклика операций
Не определены.
Бизнес-показатели ИС
| № п/п | Наименование показателя | Описание показателя | Единица измерения показателя | Целевое значение за период |
|---|---|---|---|---|
| 1 | Количество активных пользователей / сессий | Количество уникальных пользователей или активных пользовательских сессий за период. | шт. | TBD |
| 2 | Количество обработанных пользовательских запросов | Количество запросов, обработанных серверными API / цифровым ассистентом за период. | шт./период | TBD |
| 3 | Доступность сервиса | Доля времени доступности ключевых серверных API и пользовательских сценариев. | % | TBD / SLA |
Дополнительные параметры (метрики) мониторинга, характерные для данной системы
| Метрика | Порог | Потенциальная проблема | Уведомление |
|---|---|---|---|
| Доступность API /status | endpoint недоступен > 5 мин | Недоступность серверной части или Ingress/API маршрутизации | Alert в observability/дежурному каналу |
| Количество HTTP 5xx | > 5% запросов за 5 мин | Ошибки backend, зависимостей или внешних сервисов | Alert + регистрация инцидента |
| Время ответа API p95 | TBD, например > 5 сек | Деградация производительности API/LLM/RAG | Alert + анализ трассировок/логов |
| Рестарты контейнеров пользовательской нагрузки | TBD | Нехватка оперативной памяти, сбой ядра контейнерной ОС | Alert команде поддержки |
| PostgreSQL connections / errors | TBD | Перегрузка или недоступность БД | Alert DBA/DevOps |
| S3/Object Storage errors | TBD | Недоступность файлов | Alert инфраструктуре |
| Срок действия TLS-сертификатов | < 30 дней до окончания | Риск недоступности HTTPS endpoints | Уведомление ответственным за сертификаты |
| Глубина очереди PENDING в PostgreSQL (RAG) | Рост сверх порога | Нагрузка на воркеры ingestion | Alert команде Platform RAG |
| Глубина очереди PENDING в RabbitMQ (Memory) | Рост сверх порога | Нагрузка на воркеры извлечения фактов | Alert команде Memory Service |
ИТ-активы по ИС
| № | Актив | Срок |
|---|---|---|
| 1 | TLS/SSL-сертификаты для доменов публикации Ingress/API/веб-интерфейсов | Продление до окончания срока действия; конкретные даты — [уточнить] |
| 2 | Сервисные и технические учётные записи Keycloak/AD/Nexus/S3/PostgreSQL/интеграций | Сроки и ротация по регламенту управления УЗ/секретами — [уточнить] |
| 3 | Контейнерные образы и артефакты сборки в Nexus/Registry | По жизненному циклу релиза и политике хранения артефактов — [уточнить] |
| 4 | PostgreSQL, Object Storage S3/MinIO | Срок хранения и резервирования согласно Backup/DRP/retention policy — [уточнить] |