1. Общие сведения


Наименование ИС	Платформа ИИ
Краткое описание ИС	Платформа для разработки, прототипирования и применения AI-агентов: визуальное конструирование пайплайнов в Low-code Конструкторе, среда исполнения Low-code Runtime, каталог агентов Agent Registry, управляемый сервис извлечения знаний Platform RAG и управляемый слой персистентной памяти Memory Service; управляющий слой Control Plane для управления моделями, виртуальными ключами LLM и публикацией агентов за Platform API Gateway.
ИС реализует следующие функции	Визуальное создание и проверка агентских пайплайнов; автоматическое обнаружение и каталогизация агентов в Kubernetes; вызов агентов через Platform Agent Gateway с проверкой прав доступа; приём документов и гибридный поиск с фильтрацией по правам; персистентная память агентов с извлечением фактов через LLM; управление профилями обслуживания, провайдерами и моделями LLM, виртуальными ключами и публикацией low-code агентов (Control Plane); управление ролями и рабочими пространствами.
Критичность ИС	Other

Адрес размещения электронной версии Паспорта ИС: TBD

Версия	Дата	Автор	Описание изменений
1	2026-08-14	Кириенко Леонид Александрович	Сформирован впервые

Связанные с Паспортом документы:

№ п/п	Название документа	Ссылка
1.	Архитектура ИС.
2.	Руководство Администратора ИС
3.	Руководство пользователя ИС

Рабочая группа по подготовке ИС к передаче на сопровождение (далее – РГ):

№	ФИО, должность	Роль
1	Тарасов Никита Сергеевич	Руководитель РГ. Представитель команды внедрения
2	Карпович Сергей Анатольевич	Бизнес-владелец ИС
3	Валышев Антон Владимирович	Технический владелец ИС (представитель команды сопровождения)
4	Алферов Виктор Андреевич	Представитель команды разработки
5	Цуников Роман Валерьевич, Пищулин Андрей Евгеньевич	Представитель от инфраструктуры
6	Тишкевич Александр Игоревич, Сластилов Андрей Юрьевич	Представитель ДИБ
7	Коршиков Ярослав Николаевич, Возчиков Андрей Николаевич	Архитектор

2. Термины и сокращения

Термин (сокращение)	Описание
Платформа ИИ	Платформа для разработки, прототипирования и применения AI-агентов, включающая Low-code Конструктор, Low-code Runtime, Agent Registry, Platform RAG, Memory Service и управляющий слой Control Plane.
Low-code Конструктор (IDE)	Визуальный редактор для конструирования и отладки агентских пайплайнов с входом через SSO, проверкой политики компонентов и экспортом версионированных артефактов (fork LangFlow — только как источник исходного кода). Отделён от Runtime.
Low-code Runtime	Универсальный контейнерный образ на базе `lfx`, исполняющий один опубликованный неизменяемый Поток и предоставляющий согласованные интерфейсы A2A и MCP. Неотличим от SDK-агента для AES и Registry.
Agent Registry	Сервис-каталог агентов и MCP-серверов; автоматически обнаруживает агенты в Kubernetes, обеспечивает просмотр, поиск и проверку карточек A2A/MCP с авторизацией через SpiceDB.
Platform RAG	Управляемый сервис извлечения знаний (RAG): реестр коллекций, приём документов, гибридный поиск (kNN + BM25) с фильтрацией по правам доступа и упаковка контекста.
Memory Service	Управляемый слой персистентной памяти агентов: извлечение фактов через LLM, мультисигнальный поиск, CRUD записей с историей, рабочая память сессий; контракт API совместим с mem0.
Platform Agent Gateway	Публичный шлюз маршрутизации вызовов агентов; проверяет OIDC-идентичность, выполняет live-проверку прав в SpiceDB, заменяет исходный пользовательский токен на короткоживущее target-bound удостоверение. Отдельная граница, не смешивается с Platform API Gateway.
Control Plane	Управляющая подсистема платформы: владеет desired state и длительными операциями, управляет профилями обслуживания (Tier), провайдерами и моделями LLM, виртуальными ключами LLM и публикацией low-code агентов. Монтируется за Platform API Gateway по пути `/control-plane`; вне путей инференса LLM и A2A-вызова.
Platform API Gateway (`api-gw`)	Общий южно-северный шлюз управления и каталога; маршрутизирует Control Plane API (`/control-plane`) и Agent Registry API (`/agent-registry`) под одним origin. Не владеет бизнес-логикой и не смешивается с Platform Agent Gateway.
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	Ядро исполнения Потоков; stateless-исполнитель, загружающий Поток из JSON (форк 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.

3. Информация об ИС

3.1. Компонентная архитектура

Платформа представляет собой набор микросервисов, развёртываемых в Kubernetes-кластере. Каждый компонент имеет собственную границу данных и ответственности.

Основные преимущества микросервисной архитектуры:

Масштабируемость. Горизонтальное масштабирование отдельных сервисов (API, воркеры, обработчики) для увеличения производительности конкретных компонентов.
Гибкость в выборе технологий. Для каждого сервиса выбирается наиболее подходящий язык программирования и фреймворк.
Отказоустойчивость. Сбой одного компонента не приводит к остановке всей платформы; отказ поискового сервиса не блокирует приём документов.
Непрерывная доставка. Стратегия Rolling Updates обеспечивает плавное обновление без простоя.

3.1.1. Компоненты поставки

Компонент	Назначение
Low-code Конструктор (IDE)	Визуальный редактор для создания, сохранения и проверки агентских пайплайнов; вход через SSO, проверка политики компонентов, экспорт версионированных артефактов (fork LangFlow — только как источник исходного кода).
Low-code Runtime	Универсальный контейнерный образ на базе `lfx`, исполняющий один опубликованный Поток; предоставляет интерфейсы A2A и MCP.
Agent Registry	Сервис-каталог агентов и MCP-серверов; автоматическое обнаружение в Kubernetes, каталог, поиск с учётом прав, проверка карточек A2A/MCP.
Platform RAG	Управляемый сервис извлечения знаний: реестр коллекций, приём документов, гибридный поиск с фильтрацией по ACL.
Memory Service	Управляемый слой персистентной памяти: извлечение фактов, мультисигнальный поиск, CRUD записей, рабочая память сессий.
Control Plane	Управляющая подсистема: управление Tier, провайдерами и моделями LLM, виртуальными ключами LLM и публикацией low-code агентов; Stateful API + фоновые воркеры (reconciler, publisher). Монтируется за Platform API Gateway.

3.1.2. Платформенные зависимости

Зависимость	Назначение
PostgreSQL	Каноническое хранилище метаданных каталога, рабочих данных Low-code Конструктора и desired state Control Plane (схема `control_plane`)
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
Temporal	Оркестрация durable-операций Control Plane (порядок Workflow, таймеры, retry)
Platform API Gateway	Общий южно-северный шлюз; маршрутизация Control Plane API и Agent Registry API
AI Gateway	Эмбеддинг, реранкинг и LLM-инференс; единственный разрешённый путь к LLM для Memory, RAG и Control Plane

3.1.3. Разделение образов

Образы платформы публикуются в выделенное хранилище артефактов (nexus и т.п.), доступное из узлов кластера.

3.1.4. Сквозной пользовательский путь

Автор создаёт и сохраняет пайплайн агента в Low-code Конструкторе.
Low-code Конструктор проверяет структуру пайплайна и формирует версионированный неизменяемый артефакт (source + манифест) с контрольной суммой.
Публикация выполняется через Control Plane (capability Agent Publication) за Platform API Gateway: Publisher выделяет идентификаторы, создаёт Kubernetes-ресурсы и выкладывает артефакт в Object Storage; вручную — размещением исходных данных и манифеста оператором.
Low-code Runtime проверяет контрольные суммы и переходит в состояние готовности.
Agent Registry независимо обнаруживает службу Low-code Runtime в Kubernetes и добавляет информацию в каталог.
Пользователь находит агента в Agent Registry. Наличие записи не означает наличие права на вызов.
Вызов выполняется через Platform Agent Gateway после проверки права agent#invoke в SpiceDB. Исходный пользовательский токен не передаётся в Low-code Runtime.

3.2. Тип расположения ИС

Локальная:

Вариант	Необходимо выбрать
Однопользовательская (устанавливается на АРМ)
Клиент-сервер (в пределах одной территории)	Х

Распределённая:

Вариант	Необходимо выбрать
С одной серверной группировкой	Х
Распределённая серверная группировка

Вариант	Необходимо выбрать
В облачной инфраструктуре. Вид тенанта:
· Изолированный
· Внутренний	Х
На физических серверах

Адрес размещения: TBD

Архитектура ИС:

Вариант	Необходимо выбрать
Монолитная
Многоуровневая
Микросервисная	Х

4. Описание серверного состава ИС и других инфраструктурных ресурсов

Назначение	CPU, шт	RAM, Гб	HDD, Гб
—	—	—	—
—	—	—	—

Примечание: Точные параметры серверного состава и инфраструктуры будут определены на этапе подготовки к промышленной эксплуатации.

5. Описание реализуемых бизнес-процессов

Ниже приведены базовые опорные сценарии использования платформы.

5.1. Блок 1: Создание и проверка пайплайна агента

1. Создание нового агента в Low-code Конструкторе

Участники: Автор агента (AI-инженер / DS-специалист).

Контекст: Необходимо создать агента для автоматизации бизнес-задачи (например, анализ документов, генерация контента).

Процесс:

Автор открывает адрес Low-code Конструктора и входит через SSO платформы.
Создаёт новую пайплайн или открывает рабочую версию.
Добавляет компоненты из разрешённой палитры: вход, PlatformLLM, выход.
Настраивает параметры LLM-компонента, связи между узлами и формат выходных данных.
Сохраняет пайплайн с осмысленным названием, отражающим назначение агента.

2. Проверка пайплайна перед передачей

Участники: Автор агента.

Контекст: Пайплайн создан, требуется убедиться в корректности структуры и соответствии политикам.

Процесс:

Автор запускает встроенную проверку пайплайна.
Проверка подтверждает: корректность структуры, отсутствие недопустимых циклов, наличие обязательных полей, соответствие политике компонентов, отсутствие открытых секретов, совместимость с версией lfx.
При наличии ошибок (например, component_not_allowed) автор вносит исправления в схему и повторяет проверку.
После успешной проверки автор фиксирует версию и контрольную сумму передаваемых данных.

5.2. Блок 2: Развёртывание и каталогизация агента

3. Публикация агента

Участники: Автор агента, Оператор платформы.

Контекст: Публикация выполняется через Control Plane (capability Agent Publication) за Platform API Gateway; автономный Agent Publisher в этой поставке отсутствует, поэтому допускается ручная процедура передачи артефакта.

Процесс:

Контролируемый путь: издатель (Publisher worker Control Plane) выделяет идентификаторы, выкладывает неизменяемый артефакт (URI + sourceSha256) в Object Storage и создаёт Kubernetes-ресурсы; Registry независимо наблюдает за результатом.
Ручной путь: автор передаёт оператору проверенные исходные данные (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).
Пользователь открывает каталог, находит агента по названию, владельцу, рабочему пространству, протоколу или типу реализации.
Карточка агента содержит описание возможностей и информацию о доступных интерфейсах.

5.3. Блок 3: Вызов агента

5. Вызов агента через Platform Agent Gateway

Участники: Пользователь платформы, Потребитель агента.

Контекст: Агент найден в каталоге, требуется выполнить вызов.

Процесс:

Пользователь получает URL вызова из карточки агента в каталоге.
Запрос направляется через Platform Agent Gateway, который повторно проверяет токен и право вызова агента через SpiceDB.
Gateway заменяет исходный пользовательский токен на короткоживущее удостоверение, связанное с конкретным агентом.
Исходный пользовательский токен не передаётся в Low-code Runtime.
Результаты выполнения возвращаются пользователю через Gateway.

6. Вызов агента с файлом (FileRef)

Участники: Потребитель агента, принимающий файлы.

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

Процесс:

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

5.4. Блок 4: Использование Platform RAG

7. Приём и поиск в коллекции Platform RAG

Участники: Автор агента, Интеграционный сервис.

Контекст: Необходимо подготовить базу знаний для агента с использованием Platform RAG.

Процесс:

Интеграционный сервис извлекает данные из источника, применяет ACL и передаёт нормализованные документы через RAG API.
Сервис проверяет права доступа через SpiceDB, выполняет дедупликацию и создаёт задание в job store со статусом PENDING.
Воркеры ingestion обрабатывают задание: чанкинг, эмбеддинг через AI Gateway, индексация в OpenSearch.
Потребитель вызывает поиск через Platform SDK или low-code компонент, указывая коллекцию и текст запроса.
Конвейер поиска: переписывание запроса → гибридный поиск (kNN + BM25) со слиянием RRF → фильтрация по ACL → реранк → упаковка контекста с цитатами.
Результаты содержат цитаты (ссылки на doc_id/chunk_id), обеспечивая атрибуцию ответов.

5.5. Блок 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-инфраструктуры.

6. Описание доступов к компонентам ИС, необходимых для обеспечения поддержки ИС

Среда	Назначение ВМ / ресурса	Наименование машины / ресурса	Адрес машины / DNS	Что размещено	Необходимый уровень доступа для администрирования
DEV	Kubernetes namespace aip-dev (ядро платформы)	k8s API	10.9.123.31-36	Компоненты ядра ИС	Полный доступ на уровне kubectl
QA	Kubernetes namespace aip-qa (ядро платформы)	k8s API	10.9.123.31-36	Компоненты ядра ИС	Полный доступ на уровне kubectl
UAT	Kubernetes namespace aip-uat (ядро платформы)	k8s API	10.9.108.20, 10.9.108.21, 10.9.108.22	Компоненты ядра ИС	Полный доступ на уровне kubectl
UAT	Kubernetes namespace aip-uat-agents (NS для развертывания агентов)	k8s API	--/--	Агентская нагрузка	Полный доступ на уровне kubectl
PreProd	Kubernetes namespace aip-preprod (ядро платформы)	k8s API	10.10.22.20	Компоненты ядра ИС	Полный доступ на уровне kubectl
PreProd	Kubernetes namespace aip-preprod-agents (NS для развертывания агентов)	k8s API	--/--	Агентская нагрузка	Полный доступ на уровне kubectl
PreProd	база данных ИС	PostgreSQL	in-vrl-psql1; in-vrl-psql2; in-vrl-psql3	База данных ИС	SSH, администратор БД
Prod	Kubernetes namespace aip-prod (ядро платформы)	k8s API	10.10.21.20, 10.10.21.21, 10.10.21.22	Компоненты ядра ИС	Полный доступ на уровне kubectl
Prod	Kubernetes namespace aip-prod-agents (NS для развертывания агентов)	k8s API	--/--	Агентская нагрузка	Полный доступ на уровне kubectl
Prod	база данных ИС	PostgreSQL	in-vpl-psql1; in-vpl-psql2; in-vpl-psql3	База данных ИС	SSH, администратор БД

7. Описание серверного состава ИС и других инфраструктурных ресурсов

Примечание: Ресурсы 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	Сервер БД	agent-platform-postgresql-hl	postgresql://:5432	VMware Photon OS 5.0
5	Сервис авторизации (SpiceDB)	agent-platform-spicedb	http://:8443	distroless
6	Сервис авторизации (SpiceDB)	agent-platform-spicedb	grpc://:50051	distroless
7	Control Plane API	ap-control-plane-api	http://:8080	Debian GNU/Linux 13.6
8	Control Plane Web	ap-control-plane-web	http://:8080	Debian GNU/Linux 13.6
9	Temporal frontend	agent-platform-temporal-frontend	grpc://:7233	—
10	Temporal web	agent-platform-temporal-web	http://:8080	—
11	Temporal worker	agent-platform-temporal-worker-headless	grpc://:7239	—
12	Temporal matching	agent-platform-temporal-matching-headless	grpc://:7235	—
13	Temporal history	agent-platform-temporal-history-headless	grpc://:7234	—
14	agent-registry	ap-agent-registry-api	http://:8080	Debian GNU/Linux 13.6
15	Сервис эмбеддингов	ap-agent-registry-embeddings	http://:80	Debian GNU/Linux 13.6
16	keycloak	ap-agent-registry-keycloak-http	http://:8443	RHEL 9.6
17	keycloak	ap-agent-registry-keycloak-http	http://:9000	RHEL 9.6
18	keycloak	ap-agent-registry-keycloak-headless	http://:8080	RHEL 9.6
19	Сервис онлайн докумнетации	ap-team-docs-web	http://:8080	Debian GNU/Linux 13.6
20	Low-code Конструктор (back)	langflow-backend	http://:7860	RHEL 10.2
21	Low-code Конструктор (front)	langflow-frontend	http://:80	Debian GNU/Linux 12
22	Low-code Runtime	low-code-runtime	http://:80	Debian GNU/Linux 13.6
23	LLM Gateway	ap-llm-gateway	http://:80	Debian GNU/Linux 13.6
24	LLM Gateway (key probe)	ap-llm-gateway-key-probe	http://:80	Debian GNU/Linux 13.6
25	LLM Gateway (RLS)	ap-llm-gateway-rls	http://:8081	Debian GNU/Linux 13.6
26	Счётчики LLM (Redis)	ap-llm-counters	redis://:6379	Debian GNU/Linux 13.6
27	Кластер opensearch	opensearch-cluster-master	http://:9200	Amazon Linux 2023.12.20260710
28	Кластер opensearch	opensearch-cluster-master	tcp://:9300	Amazon Linux 2023.12.20260710
29	Кластер opensearch	opensearch-cluster-master	http://:9600	Amazon Linux 2023.12.20260710
30	Брокер RedPanda	agent-platform	tcp://:9092	Debian GNU/Linux 13.6

Примечание: Ресурсы CPU, RAM, а также дисковая память выделяются динамически в k8s кластере. В качестве DNS имен указаны имена k8s сервисов без суффикса <имя-пространства-имён>.svc.cluster.local (например, aip-dev.svc.cluster.local).

UAT

№ п/п	Тип сервера	DNS имя / IP адрес	Строка доступа к ресурсу	Параметры	Дисковое пространство и тип дисков	Операционная система
—	—	—	—	—	—	—

PreProd

№ п/п	Тип сервера	DNS имя / IP адрес	Строка доступа к ресурсу	Параметры	Дисковое пространство и тип дисков	Операционная система
—	—	—	—	—	—	—

Prod

№ п/п	Тип сервера	DNS имя / IP адрес	Строка доступа к ресурсу	Параметры	Дисковое пространство и тип дисков	Операционная система
—	—	—	—	—	—	—

Примечание: Среда prod не реализована. Требуется подготовка внешних зависимостей, секреты, TLS, масштабирование и порядок отката.

8. Описание протоколов и портов для сетевого взаимодействия с другими ИС Компании и с внешними ИС

Примечание: Точные подсети и правила сетевого взаимодействия будут определены на этапе подготовки к промышленной эксплуатации.

DEV

№ п/п	Источник трафика (хост/подсеть)	Протокол	Получатель трафика (хост/подсеть)	Порт	Протокол	Назначение трафика
1	10.9.123.0/24	https	httpRoute api-gw-dev.ai-dev.inno.tech/agent-registry	443	https	Взаимодействие с API реестра
2	10.9.123.0/24	a2a	httpRoute agent-gw-dev.ai-dev.inno.tech/a2a	443	a2a	Взаимодействие с опубликованными агентами по протоколу a2a
3	10.9.123.0/24	https	httpRoute api-gw-dev.ai-dev.inno.tech/keycloak	443	https, OIDC	Аутентификация на шлюзе OIDC
4	10.9.123.0/24	https	httpRoute ide-dev.ai-dev.inno.tech	443	https	Работа с визуальным конструктором потоков
5	10.9.123.0/24	https	httpRoute docs-dev.ai-dev.inno.tech	443	https	Онлайн документация платформы

UAT

№ п/п	Источник трафика (хост/подсеть)	Протокол	Получатель трафика (хост/подсеть)	Порт	Протокол	Назначение трафика
1	10.9.108.0/24	https	httpRoute api-gw-uat.ai-dev.inno.tech/agent-registry	443	https	Взаимодействие с API реестра
2	10.9.108.0/24	a2a	httpRoute agent-gw-uat.ai-dev.inno.tech/a2a	443	a2a	Взаимодействие с опубликованными агентами по протоколу a2a
3	10.9.108.0/24	https	httpRoute api-gw-uat.ai-dev.inno.tech/keycloak	443	https, OIDC	Аутентификация на шлюзе OIDC
4	10.9.108.0/24	https	httpRoute ide-uat.ai-dev.inno.tech	443	https	Работа с визуальным конструктором потоков
5	10.9.108.0/24	https	httpRoute docs-uat.ai-dev.inno.tech	443	https	Онлайн документация платформы

PreProd

№ п/п	Источник трафика (хост/подсеть)	Протокол	Получатель трафика (хост/подсеть)	Порт	Протокол	Назначение трафика
1	10.10.21.0/24	https	httpRoute api-gw-preprod.ai-dev.inno.tech/agent-registry	443	https	Взаимодействие с API реестра
2	10.10.21.0/24	a2a	httpRoute agent-gw-preprod.ai-dev.inno.tech/a2a	443	a2a	Взаимодействие с опубликованными агентами по протоколу a2a
3	10.10.21.0/24	https	httpRoute api-gw-preprod.ai-dev.inno.tech/keycloak	443	https, OIDC	Аутентификация на шлюзе OIDC
4	10.10.21.0/24	https	httpRoute ide-preprod.ai-dev.inno.tech	443	https	Работа с визуальным конструктором потоков
5	10.10.21.0/24	https	httpRoute docs-preprod.ai-dev.inno.tech	443	https	Онлайн документация платформы

Prod

№ п/п	Источник трафика (хост/подсеть)	Протокол	Получатель трафика (хост/подсеть)	Порт	Протокол	Назначение трафика
1	10.10.22.0/24	https	httpRoute api-gw-prod.ai-dev.inno.tech/agent-registry	443	https	Взаимодействие с API реестра
2	10.10.22.0/24	a2a	httpRoute agent-gw-prod.ai-dev.inno.tech/a2a	443	a2a	Взаимодействие с опубликованными агентами по протоколу a2a
3	10.10.22.0/24	https	httpRoute api-gw-prod.ai-dev.inno.tech/keycloak	443	https, OIDC	Аутентификация на шлюзе OIDC
4	10.10.22.0/24	https	httpRoute ide-prod.ai-dev.inno.tech	443	https	Работа с визуальным конструктором потоков
5	10.10.22.0/24	https	httpRoute docs-prod.ai-dev.inno.tech	443	https	Онлайн документация платформы

9. Информационная безопасность ИС

9.1. Калькулятор уровня защищённости персональных данных

тип ПДн — не применимо;
количество субъектов — не применимо;
субъекты ПДн — не применимо;
тип актуальных угроз — не применимо.
Расчётный уровень защищённости: не применимо.

9.2. Типы обрабатываемой информации

Типы обрабатываемой информации	Необходимо отметить «X», если применимо
Коммерческая тайна	не применимо
Персональные данные (ПДн)	не применимо
Финансовая информация	не применимо

9.3. Доступ к информации

Режим доступа к информации	Необходимо отметить «X», если применимо
Однопользовательская
Многопользовательская	Х
Одинаковые права для всех пользователей
Реализована система разграничения доступа	Х

Тип аутентификации	Необходимо отметить «X», если применимо
Локальная	Х
Доменная	Х

9.4. Уровень защищённости ПДн, обрабатываемых в ИС

Уровень защищённости ПДн, обрабатываемых в ИС	Необходимо отметить «X», если применимо
УЗ-1 (первый уровень защищённости ПДн при их обработке в ИСПДн)	не применимо
УЗ-2 (второй уровень защищённости ПДн при их обработке в ИСПДн)	не применимо
УЗ-3 (третий уровень защищённости ПДн при их обработке в ИСПДн)	не применимо
УЗ-4 (четвертый уровень защищённости ПДн при их обработке в ИСПДн)	не применимо

9.5. Категории значимости объекта КИИ

Категории значимости объекта КИИ	Необходимо отметить «X», если применимо
КЗ-1 (первая категория значимости)	Не применимо
КЗ-2 (вторая категория значимости)	Не применимо
КЗ-3 (третья категория значимости)	Не применимо

9.6. Класс защищённости ГИС

Класс защищённости ГИС	Необходимо отметить «X», если применимо
КЗ-1 (первый класс защищённости)	Не применимо
КЗ-2 (второй класс защищённости)	Не применимо
КЗ-3 (третий класс защищённости)	Не применимо

9.7. Меры по защите ИС

№ п/п	Меры	Техническое средство	Особенности реализации
1	Аутентификация	Корпоративный провайдер учётных записей OIDC	Аутентификация через Keycloak с протоколом OpenID Connect; SSO для всех компонентов платформы.
2	Разграничение доступа	Авторизационная информация в JWT; SpiceDB	Реализована система разграничения доступа на основе ReBAC; проверка прав на каждую операцию через SpiceDB.
3	Физический доступ к оборудованию	В соответствии с регламентами вычислительного центра	—
4	Противодействие умышленным атакам	WAF	Сервис не доступен из внешних сетей.
5	Управление уязвимостями	Регулярное обновление общесистемного и прикладного программного обеспечения. Периодическое сканирование средством анализа защищённости	Обновление общесистемного и прикладного ПО осуществляется в соответствии с положением о процессе управления обновлениями программного обеспечения.

9.8. Перечень технических и административных учётных записей

Наименование	Назначение	Примечание	Срок действия УЗ
workspace-admin	Администратор рабочей области (фикстурный пользователь Keycloak)		Согласно регламенту управления УЗ/секретами
agent-invoker	Вызывающий агент (фикстурный пользователь Keycloak)		—
unauthorized-user	Запрещённый пользователь (тест)		—
—	—	—	—

Примечание: Фикстурные пользователи создаются только в non-production средах и не переносятся в промышленную эксплуатацию. Точный перечень технических учётных записей будет определён на этапе подготовки к промышленной эксплуатации.

9.9. Администрирование

Руководитель и Подразделение, занимающееся администрированием системы:

Гурбич Богдан Васильевич, Ведущий руководитель проекта Группа проектного офиса «Платформа ИИ»

Руководитель и Подразделение, занимающееся предоставлением доступа к системе (при наличии):

Валышев Антон Владимирович, Руководитель отдела, Отдел поддержки продуктов

Маршрут предоставления доступа к ИС (необходимо указать ответственных за согласование/исполнение на каждом этапе. Маршрут должен быть согласован ДИБ):

Бизнес-роль	Назначение	Описание прав	Лицо, принимающее решение о предоставлении доступа
Автор агента	Создание, сохранение и проверка пайплайнов агентов в Low-code Конструкторе	Доступ к Low-code Конструктору в своей рабочей области; создание и редактирование пайплайнов; экспорт версионированных артефактов.	Бизнес-владелец ИС / руководитель подразделения пользователя.
Оператор	Ручная передача артефактов пайплайна, развёртывание Low-code Runtime в Kubernetes	Доступ к объектному хранилищу; права на создание и управление подами Kubernetes; выполнение проверки контрольных сумм.	Технический владелец ИС; согласование с ДИБ для административных и привилегированных доступов.
Издатель агентов	Публикация low-code агентов и управление их версиями через Control Plane	Право `control_plane#publish` (ресурс `control_plane:control-plane`); запуск Publication и PublishJob через Platform API Gateway.	Технический владелец ИС; согласование с ДИБ.
Администратор Control Plane	Администрирование профилей обслуживания (Tier), провайдеров, моделей и виртуальных ключей LLM	Право `control_plane#administer`; управление моделями, ключами и политикой выдачи через Control Plane API.	Технический владелец ИС; согласование с ДИБ.
Потребитель агента	Просмотр каталога агентов и вызов разрешённых агентов через Platform Agent Gateway	Чтение каталога Agent Registry; вызов агентов при наличии права `agent#invoke` в SpiceDB.	Бизнес-владелец ИС;
Администратор платформы	Поддержание согласованного состояния компонентов, ежедневная проверка, диагностика и восстановление	Полный доступ ко всем компонентам через Garden и Kubernetes; управление зависимостями (PostgreSQL, SpiceDB, OpenSearch, Temporal и др.).	Технический владелец ИС; согласование с ДИБ.
Интеграционный сервис	Приём документов из внешних источников в Platform RAG	Право записи в конкретную коллекцию через SpiceDB; собственные Secrets и NetworkPolicy.	Технический владелец ИС; согласование с ДИБ.

9.10. Механизмы идентификации и аутентификации пользователей

Аутентификация в Системе выполняется с помощью внутреннего компонента Keycloak, развернутого в составе компонентов платформы.

Keycloak использует протокол OpenID Connect, для получения сведений о пользователе от внешнего OIDC провайдера.

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

Примечание: Время жизни токена доступа по умолчанию составляет 15 минут и может быть скорректировано прикладным администратором платформы в настройках Keycloak.

9.10.1. Авторизация

Авторизационный механизм реализован на базе opensource решения SpiceDB. Авторизационная схема описывается декларативно и инициализируется в момент развёртывания приложения.

В системе используется модель управления доступом ReBAC (Relationship-Based Access Control). Она основана на отношениях между субъектами, ресурсами и контекстом.

Доступ определяется ролями в привязке к контексту — рабочей области (workspace), команде и агенту, а также зависит от свойств объектов и их отношений.

9.10.2. Шифрование

Взаимодействие пользователя с опубликованными endpoint платформы выполняется по защищённому протоколу HTTPS/TLS через Ingress.

Взаимодействие backend/API с Keycloak выполняется по HTTPS/OIDC; взаимодействие с PostgreSQL, Kubernetes API осуществляется по внутреннему сетевому контуру с использованием защищённых протоколов/сетевых политик согласно целевой инфраструктурной конфигурации.

Описание шифрования дисков системы: Шифрование дисков ВМ, persistent volumes и/или managed storage, на которых размещаются компоненты системы и данные, должно быть реализовано средствами инфраструктуры либо средствами уровня ОС. Конкретный механизм шифрования и зона ответственности подлежат подтверждению инфраструктурой перед ПЭ.

9.11. Криптографическая защита

Дополнительная криптографическая защита не используется.

№ п/п	Название сертификата: домен, который закрывается	Дата выпуска	Дата окончания действия	Выпускающий УЦ
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

9.12. Минимальные параметры работы ИС

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	Дополнительное программное обеспечение	Не используется

9.13. Параметры надёжности и непрерывности ИС

Критичность	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

9.14. Сводная таблица по организации эксплуатации ИС

Таблицу заполняет Технический владелец ИС.

Компонент ИС	№ п/п	Наименование работ	Группа поддержки
Поддержка пользователя	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 / команда БД

9.15. Последовательность запуска и остановки ИС, проверка работоспособности ИС после запуска

Запуск системы после развёртывания происходит автоматически. Специальной процедуры старта не предусмотрено.

Для проверки работоспособности после запуска необходимо убедиться в успешном старте и доступности ключевых компонентов, опубликованных на Ingress Controller.

В корневом namespace системы (k8s кластер) все компоненты должны функционировать без ошибок (поды запущены, ошибки запуска отсутствуют, не наблюдается постоянных перезапусков контейнеров, readiness probe отрабатывает штатно).

Специальной процедуры остановки системы не предусмотрено. При необходимости, отдельные компоненты системы могут быть приостановлены администратором k8s кластера путем downscale соответствующих deployment, stateful set.

Следует учитывать, что остановка произвольных компонентов системы может привести к нарушению работоспособности зависимых компонентов и всей платформы в целом.

9.16. Порядок установки обновлений

Установка обновлений производится аналогично первоначальному развёртыванию — путём обновления helm релиза приложения в целевом namespace k8s кластера через Garden.

До начала обновления все артефакты нового релиза (докер образы и helm чарты) должны быть размещены в соответствующих registry.

До начала обновления необходимо выполнить резервное копирование БД PostgreSQL для stateful компонентов системы.

Обновление рассматривается как согласованное изменение ключевых компонентов (Low-code Конструктор, Low-code Runtime, Agent Registry, Control Plane), даже если они поставляются разными проектами.

Перед изменением версии необходимо:

Зафиксировать текущее и целевое состояние всех компонентов и внешних зависимостей.
Проверить совместимость пайплайнов Low-code с целевой версией.
Выполнить все проверки совместимости Agent Registry (OpenAPI, Alembic, SpiceDB, Redpanda, OpenSearch).
Выполнить garden validate --env TARGET, затем garden deploy --env TARGET --yes --forward.

9.16.1. Зафиксированные версии внешних зависимостей

Зависимость	Версия поставки
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.

9.16.2. Условия немедленной остановки обновления

Остановите обновление, если:

миграция данных завершилась ошибкой;
прежний пайплайн Low-code не проходит целевую проверку;
карточка или описание агента объявляет отсутствующую возможность;
Low-code Конструктор может передать непроверенный или содержащий секрет источник;
Agent Registry возвращает недоступный объект;
новый экземпляр Reconciler не получил свежее полное наблюдение;
поисковая проекция не сходится с метаданными.

9.16.3. Критерии завершения обновления

Обновление завершено только когда:

образы, настройки, схемы данных и внешние зависимости совместимы;
активные и откатные пайплайны Low-code прошли проверку;
Low-code Конструктор создаёт повторяемый пайплайн;
Low-code Runtime готов и исполняет принятый профиль;
Agent Registry автоматически обнаруживает его и соблюдает отрицательные проверки доступа;
сохранены контрольные суммы и очищенные результаты проверки;
подтверждён применимый путь отката.

9.17. Мониторинг ИС

Примечание: Способ мониторинга платформы будет дополнен после завершения процедуры постановки на сопровождение.

9.17.1. Нефункциональные требования к ИС

Область	Требование
Надёжность	Система должна обеспечивать устойчивую обработку запросов, корректную обработку ошибок внешних сервисов и повторяемость асинхронных операций при сбоях.
Масштабируемость	Архитектура должна допускать горизонтальное масштабирование API, воркеров, очередей и сервисов обработки.
Безопасность	Доступ к данным и функциям должен быть ограничен ролями, группами и ABAC-политиками. Чувствительные данные не должны попадать в логи.
Сопровождаемость	Компоненты должны иметь идентификаторы версий, контролируемые конфигурации, трассируемые запросы и диагностические логи.
Совместимость	API должны сохранять обратную совместимость в пределах согласованной версии или сопровождаться миграционными инструкциями.
Изоляция данных	Данные разных команд (пространств) должны быть изолированы логически и/или физически в соответствии с целевой схемой внедрения.

9.17.2. Требования к времени отклика операций

Не определены.

9.17.3. Бизнес-показатели ИС

№ п/п	Наименование показателя	Описание показателя	Единица измерения показателя	Целевое значение за период
1	Количество активных пользователей / сессий	Количество уникальных пользователей или активных пользовательских сессий за период.	шт.	TBD
2	Количество обработанных пользовательских запросов	Количество запросов, обработанных серверными API / цифровым ассистентом за период.	шт./период	TBD
3	Доступность сервиса	Доля времени доступности ключевых серверных API и пользовательских сценариев.	%	TBD / SLA

9.17.4. Дополнительные параметры (метрики) мониторинга, характерные для данной системы

Метрика	Порог	Потенциальная проблема	Уведомление
Доступность 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

9.18. ИТ-активы по ИС

№	Актив	Срок
1	TLS/SSL-сертификаты для доменов публикации Ingress/API/веб-интерфейсов	Продление до окончания срока действия; конкретные даты — [уточнить]
2	Сервисные и технические учётные записи Keycloak/AD/Nexus/S3/PostgreSQL/интеграций	Сроки и ротация по регламенту управления УЗ/секретами — [уточнить]
3	Контейнерные образы и артефакты сборки в Nexus/Registry	По жизненному циклу релиза и политике хранения артефактов — [уточнить]
4	PostgreSQL, Object Storage S3/MinIO	Срок хранения и резервирования согласно Backup/DRP/retention policy — [уточнить]

Паспорт ИС "Платформа ИИ"

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