Состав компонентов платформы

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

Платформа ИИ разворачивается в кластере Kubernetes через проект Garden deploy (имя aip-deploy). Проект объединяет в один граф действий исходники Платформы ИИ (agent-platform), Low-code Конструктора (langflow), а также внешние read-only сервисы (rag, memory) и носитель lfx. deploy владеет окружениями (dev-local, qa), провайдерами, общим поставщиком идентичности, шлюзовой инфраструктурой и манифестами.

Топология пространств имён (CORE-1894) разделяет роли: управляющая подсистема, Agent Registry и документация живут в aip-<env>, модели — в aip-<env>-models, опубликованные агенты — в aip-<env>-agents, поставщик идентичности и общие провайдеры — в aip-<env>-infra, Low-code Конструктор — в aip-<env>-low-code-ide, внешние read-only RAG/Memory — в aip-<env>-services.

Принципы развертывания

• Единый граф композиции. deploy — единственная точка оркестрации. В графе зафиксированы точные SHA коммитов продуктов. Коммит композиции является воспроизводимой совместимой связкой версий (deployment BOM).
• Независимость компонентов. Платформа ИИ и Low-code Конструктор разворачиваются независимо. Общие зависимости (Keycloak) при совместном развёртывании выполняются один раз.
• Декларативный состав. Каждый компонент Платформы ИИ управляется собственным флагом включения; Helm-шаблоны чарта отрисовывают ресурсы только для включённых компонентов.
• Публичное присутствие. Маршрутизацией, DNS, сертификатами и TLS владеет DevOps. deploy не создаёт эти ресурсы — он формирует только HTTPRoute в своём пространстве имён и привязывает их к уже существующим ListenerSet.

Helm-релизы

Образы сервисов подтягиваются из корпоративного реестра nexus.inno.tech:19108 по секрету aip-image-pull-secret. Политика подтягивания образов — Always (QA) / IfNotPresent (dev-local).

1. Поставщик идентичности

1.1 Keycloak

Управляемый поставщик OIDC/SSO, обслуживает realm, общий для обоих продуктов. Выставлен на префиксе /keycloak.

1.2 Keycloak Reconciler

Одноразовый Pod, применяющий декларативное состояние realm через Keycloak Admin REST API: сначала базовые настройки realm (realm-base), затем объекты, принадлежащие каждому продукту (clients, роли, пользователи). Применение идемпотентное и ограничено своим скоупом; общий realm не перезаписывается целиком.

Запускается как Pod для каждого уровня идентификации:

1.3 Тестовые пользователи

Определяются в aip-identity-fixtures (включаются целью identity-fixtures):

2. Платформа ИИ

Платформа ИИ поставляется одним «зонтичным» Helm-релизом aip. Релиз собирает в единое развёртывание управляющую подсистему (Control Plane), каталог агентов (Agent Registry), LLM Gateway, подсистему проверки текста (Guardrails) и (опционально) тестовые данные. Прикладные сервисы создаются в aip-<env>, а общие провайдеры — отдельными релизами в aip-<env>-infra.

В текущей архитектуре (R2) управление и вызов разделены на две границы: Platform API Gateway (api-gw) для management/discovery и Platform Agent Gateway (agent-gw) для A2A-invocation. Control Plane — единственный public API для platform-managed desired state; Agent Registry — read-only каталог, наблюдающий за опубликованными агентами.

2.1 Agent Registry

Каталог агентов платформы. Наблюдает за точным allowlist пространств имён (aip-<env>-agents), хранит карточки агентов и обеспечивает permission-aware get/list/search. Выставлен на префиксе /agent-registry.

Имя компонента в кластере: aip-agent-registry.

Подкомпоненты

Каждый подкомпонент развёртывается как отдельный Deployment. Перед запуском контейнера выполняется инициализационный контейнер database-migration, применяющий миграции схемы.

Одноразовые задания (Jobs)

Дополнительно

• Политики сети и правил Prometheus отключены по значениям окружения.
• API поддерживает опциональную публичную маршрутизацию HTTPRoute, а также документацию Swagger с OAuth2-потоком по паролю.

2.2 Control Plane

Управляющая подсистема и единственный public API для platform-managed desired state. Владеет моделями/providers, виртуальными API-ключами, explicit model grants и публикацией агентов (Agent Publication). Может быть отключена (controlPlane.enabled=false).

Имя компонента в кластере: aip-control-plane.

Подкомпоненты

Дополнительно

• Отдельный опциональный SPA-фронтенд (controlPlane.frontend) — свой Deployment + HTTPRoute на cp.* origin.
• Авторизация через общий SpiceDB; схема мигрируется отдельным Job.
• Temporal-оркестрация подключена через общий провайдер aip-temporal в aip-<env>-infra.
• Публикация идёт только в aip-<env>-agents; обход Agent Gateway блокируют admission, ClusterIP и default-deny NetworkPolicy.

2.3 LLM Gateway

Маршрутизация запросов к LLM-провайдерам (data plane на agentgateway). Живёт в aip-<env>-models как отдельный Gateway aip-model-gateway с собственным proxy и RLS (rate-limit service) на Valkey Sentinel. Может быть отключён; активируется вместе с Control Plane.

2.4 Guardrails

Проверка текста (запросов и ответов модели) на запрещённое содержимое. Компонент разделён на два слоя с чёткой границей ответственности:

• Control Plane владеет версиями политик: хранит их, проверяет структуру (схема JSON), компилирует в «generation» и доставляет неизменяемый набор в Kubernetes, а также управляет привязкой политики к модели. Guardrails Runtime не обращается к БД Control Plane или Kubernetes на каждый запрос: недоступность управления не останавливает уже загруженные проверки.
• Guardrails Runtime — отдельный процесс. Загружает неизменяемый набор политик при старте (hot-reload отсутствует, смена версии требует нового поколения развёртывания), проверяет текст и выдаёт решение pass / deny / mask. Внутренняя очередь отсутствует: при превышении лимита одновременных проверок возвращается 503 overloaded.

Применяется двумя способами:

1. Через шлюз (Agentgateway). Политика привязывается к модели в Control Plane; Gateway сам вызывает Runtime (promptGuard как webhook с failureMode: FailClosed) и защищает текстовые вызовы Chat Completions в профиле agentgateway-1.5.0-text-webhook-v1.
2. Прямой HTTP-вызов из сервиса. Адаптер RAG/Memory сам вызывает Runtime (POST /request / POST /response) перед индексацией, записью или выдачей. Автопривязок вида «политика → коллекция RAG / память агента» в Control Plane нет.

Состав политик — стадии request/response, каждая со списком правил: regex (RE2), stop_list, external_pipeline (внешний детектор) и llm_classifier (семантическая проверка моделью). Ошибки, таймауты и неопределённые ответы трактуются как запрет (FailClosed).

Развёртывание (dev-local). Runtime не является статическим Deployment: поколения (Deployment + Service + policy шлюза) создаёт model-worker Control Plane в aip-<env>-models на основе доставленного профиля. Поставка собирается графом deploy отдельными действиями: guardrail-runtime-image (сборка образа), dev-local-guardrail-image (публикация по неизменяемому digest) и dev-local-guardrail-delivery (подготовка неизменяемых ресурсов доставки в models-namespace и профиль в platform-namespace). Компонент включается флагом controlPlane.guardrails.enabled, на текущий момент только для dev-local; QA/production выкатываются отдельно.

Для model-inline promptGuard-webhook в dev-local используется проверенный локальный контроллер Agentgateway v1.5.0-ap-gr1 с наложенным патчем (ADR-0011 в deploy): upstream 1.4.1 не добавляет Model-level promptGuard в коллекцию ancestor backends, поэтому TLS/auth-политики webhook применяются только с патчем.

Промышленное подключение RAG/Memory (прямые HTTP-вызовы) — впереди; в текущей поставке закрыт только управляемый путь через модель.

Подробности: API проверки текста, управление политиками, подключение RAG и Memory, подключение и эксплуатация.

2.5 Team Docs

Статическая документация команды. Выставлена на отдельном origin docs.*.

2.6 Общие сервисные провайдеры (shared)

Отдельные Helm-релизы в aip-<env>-infra, на которые опираются и Platform, и Low-code Конструктор:

2.7 Test-данные (fixtures)

Опциональный Helm-релиз на том же чарте, что и runtime, но с переключёнными значениями: runtime-компоненты отключены (runtime.enabled: false), активны только fixture-данные. Релиз выполняется в aip-<env>-infra и включается отдельной целью agent-platform-fixtures или агрегатом all-fixtures.

2.7.1 Smoke Agent

Отключён: у sdk-smoke-v1 нет R2-пути публикации (нужен принятый ADR-0009).

2.7.2 Low-code Agent

Публикуется реально через Control Plane API (тот же путь, что и Studio «Publish»), а не как статический Deployment.

Исторический R1 alias ap-agent-linguist (/a2a/lowcode-linguist-v1 с URLRewrite) больше не является целевой моделью: R2 публикует агентов по стабильному /a2a/v1/agents/{agent_id} через Agent Gateway. R1 остаётся только в quarantined fixture-графе.

3. Общеплатформенные сервисы (RAG, Memory)

RAG и Memory — внешние read-only сервисы, подключаемые к платформе как отдельные приложения. Их исходники (rag, memory) принадлежат другим командам и для deploy readonly; deploy только упаковывает upstream-образы в Helm-релизы и разворачивает API + worker.

Оба сервиса живут в общем пространстве имён aip-<env>-services, используют общие провайдеры (aip-<env>-infra: PostgreSQL, OpenSearch, RabbitMQ) и не владеют собственной инфраструктурой, ingress или fixture-нагрузкой. Развёртывание включается отдельными целями rag / memory (не входит в all).

Сборка образов

Образы фиксируются source SHA и опубликованным digest в deployment BOM. Upstream-Dockerfile резолвит непинненные Python-зависимости, поэтому пересборка тех же исходников не гарантирует идентичный образ.

CORE-1894 покрывает только сборку образов и установку. Функциональность приложений и совместимость с версиями общих провайдеров не утверждаются.

4. Low-code Конструктор

Источник исходного кода — langflow. Выставлен на отдельном origin ide.*. Пространство имён: aip-<env>-low-code-ide.

Релиз Helm: aip-low-code-ide (чарт charts/langflow-sso).

4.1 Бэкенд

4.2 Фронтенд

Единственный браузерный origin; проксирует API-трафик бэкенда.

5. Шлюзовая инфраструктура

5.1 Gateway API CRDs

5.2 Agentgateway CRDs

CRDs:

• agentgatewaybackends.agentgateway.dev
• agentgatewaymodels.agentgateway.dev
• agentgatewayparameters.agentgateway.dev
• agentgatewaypolicies.agentgateway.dev

5.3 Agentgateway Controller

Для model-inline promptGuard-webhook Guardrails в dev-local используется локальный профиль контроллера v1.5.0-ap-gr1 с проверенным патчем (ADR-0011 в deploy): upstream не добавляет Model-level promptGuard в коллекцию ancestor backends, поэтому TLS/auth-политики webhook прикладываются только с патчем.

5.4 Local Gateway Topology (dev-local)

ListenerSets в aip-<env> (owner aip-deploy):

Три локальных forward-порта 18085, 18086, 18087 ведут в aip-gateway:80; hostname выбирает listener.

5.5 Внешний шлюз (владение DevOps)

В ai-dev общий немодельный Gateway QA/RC и его operator принадлежат DevOps (hostNetwork, nodeSelector in-vdl-k8s-c6). Каждая среда имеет отдельный model Gateway, к которому привязан её биллинг. ListenerSets секции https:

6. HTTPRoutes (маршрутизация)

Маршруты формируются чартами продуктов (default-disabled) и включаются deploy с environment-специфичными host/parentRef/path.

6.1 Платформа ИИ

A2A-маршруты опубликованных агентов создаёт Publisher в aip-<env>-agents по стабильному /a2a/v1/agents/{agent_id} на agent-gw.*-listeners.

6.2 Langflow

6.3 Keycloak

7. Секреты и ConfigMaps

7.1 Секреты

7.2 ConfigMaps (desired state identity)

8. Сводная таблица всех компонентов

Прикладные (runtime)

Общие провайдеры

Шлюзовая инфраструктура

Fixture-компоненты (opt-in)

Reconciler Jobs (identity)

9. Граф зависимостей развёртывания

environment (namespaces, shared credentials)
  ├── shared-postgresql → shared-databases
  │     ├── shared-spicedb
  │     └── shared-temporal
  ├── shared-opensearch
  ├── shared-redpanda
  ├── shared-valkey
  └── shared-opentelemetry

identity-provider/keycloak (aip-keycloak)
  └── realm-base (Job)
        ├── agent-platform-identity (Job)
        │     └── aip (Helm release: runtime)
        │           ├── Agent Registry (api, reconciler, relay, indexer)
        │           ├── Control Plane (api, workers, frontend)
        │           ├── LLM Gateway (models ns) + RLS
        │           ├── Guardrails (dev-local):
        │           │     dev-local-guardrail-image (Run, digest)
        │           │     dev-local-guardrail-delivery (Run: transport, CA,
        │           │       classifier catalog, profile → cp-guardrail-delivery)
        │           │     → поколения Runtime создаёт model-worker (models ns)
        │           └── Team Docs
        │                 └── aip (Helm release: fixtures, opt-in)
        │                       └── low-code agent (published via CP)
        ├── langflow-identity (Job)
        │     └── aip-low-code-ide (Helm release)
        │           ├── backend
        │           └── frontend
        │                 └── langflow-fixtures (Job)
        └── identity-fixtures (Job)

Сборка образов (Build actions, не отображены в графе):

• agent-platform-image → Agent Registry API
• control-plane-image → Control Plane (api + workers)
• control-plane-frontend-image → Control Plane SPA
• guardrail-runtime-image → Guardrails Runtime (dev-local)
• team-docs-image → Team Docs
• low-code-runtime-image → low-code fixture runtime
• platform-lfx-wheel-image → carrier для LFX wheel (ADR-0009)
• langflow-backend-image → Low-code Конструктор backend
• langflow-frontend-image → Low-code Конструктор frontend
• keycloak-reconciler-image → identity reconciler Jobs