AI Platform Docs
Администрирование

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

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

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

Платформа состоит из трёх основных продуктовых слоёв, общего провайдера идентификации и инфраструктуры шлюза. Helm-чарты поставляются продуктовыми репозиториями (agent-platform, langflow) и импортируются в composition репозиторий ap-deploy по точным Git SHA.

Импортируемые Helm-чарты

ЧартИсточникРелиз Helm
keycloakx (Codecentric, OCI)ap-deploy (зашитый URL)agent-registry-keycloak
charts/agent-platformagent-platform (Git SHA)agent-platform
charts/agent-platform (fixtures)agent-platform (Git SHA)agent-platform-fixtures
charts/langflow-ssolangflow (Git SHA)langflow

Не-Helm ресурсы

Ряд компонентов разворачивается через прямые Kubernetes manifests, Garden Run-экшены и Helm для CRDs:

  • Gateway API CRDs (digest-pinned)
  • agentgateway CRDs + controller
  • Non-production embeddings stand-in
  • Identity secrets и ConfigMaps

Общеплатфрменные сервисы

Отдельными позициями в составе платформы присутствуют общеплатформенные сервисы:

  • RAG
  • Memory

Их назначение, методика развертывания и администрирования описаны в отдельных разделах.

1. Слой идентификации

1.1 Keycloak Identity Provider

ПараметрЗначение
Чартkeycloakx v7.2.2 (Codecentric, OCI)
Imagequay.io/keycloak/keycloak:26.3.2
Тип ресурсаStatefulSet
Релиз Helmagent-registry-keycloak
Полное имяap-agent-registry-keycloak
Режимstart-dev (H2 файловая БД)
PVC5Gi (standard / longhorn)
CPU/RAMreq 250m/1Gi, lim 1/2Gi
Владельцыap-deploy

Keycloak запускается с флагом start-dev (dev-режим без production конфигурации). Хранит данные realm в файловой H2-базе на PVC.

1.2 Realm-base

ConfigMap ap-identity-realm-base содержит желаемое состояние realm:

ПараметрЗначение
Realmap-dev
accessTokenLifespan3600 сек
registrationAllowedfalse
resetPasswordAllowedfalse
rememberMefalse
Владельцыap-deploy

1.3 Keycloak Reconciler

ПараметрЗначение
ImageСобственная сборка из tools/keycloak-reconciler
ТипKubernetes Pod (Run action, restartPolicy: Never)
Режим работыСквозное согласование, без prune

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

JobОбласть владенияЧто согласовывает
realm-baseap-deployRealm-level settings
agent-platform-identityagent-platformAP clients/scopes/roles/mappers
langflow-identitylangflowLangflow clients/scopes/roles/mappers
identity-fixturesap-deployТестовые пользователи (3 шт.)
langflow-fixtureslangflowLangflow fixture grants

1.4 Тестовые пользователи идентификации

ConfigMap ap-identity-fixtures определяет трёх fixture-пользователей:

UsernameРольEmail
workspace-adminworkspace adminworkspace-admin@dev.invalid
agent-invokeragent invokeragent-invoker@dev.invalid
unauthorized-usernegative testunauthorized-user@dev.invalid

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

2.1 Helm-чарт charts/agent-platform (runtime)

Релиз Helm: agent-platform. Основной чарт разворачивает все компоненты Платформы ИИ.

2.1.1 Agent Registry API

ПараметрЗначение
Тип ресурсаDeployment
fullnameOverrideap-agent-registry
Компонентыapi, kubernetesReconciler, outboxRelay, searchIndexer
Реплики (каждый)1
Owneragent-platform

Компоненты Agent Registry:

КомпонентТипОписание
apiDeploymentОсновной API сервер
kubernetesReconcilerDeploymentРеconciler Kubernetes-ресурсов
outboxRelayDeploymentRelay для event-driven интеграций
searchIndexerDeploymentИндексатор поиска

2.1.2 Team Docs

ПараметрЗначение
Тип ресурсаDeployment
fullnameOverrideap-team-docs
ОбразСобственная сборка team-docs-image
ОписаниеImmutable pre-rendered documentation
Owneragent-platform

2.1.3 Jobs

JobОписание
searchReindexПереиндексация поиска
retentionПолитика хранения данных

2.2 Встроенные зависимости (bundled)

Чарт agent-platform включает все зависимости как part of the same release:

КомпонентТипPVCStorageClass
PostgreSQLStatefulSet1Gistandard / longhorn
SpiceDBStatefulSet——
OpenSearchStatefulSet—standard / longhorn
RedpandaStatefulSet—standard / longhorn
OpenTelemetry CollectorDeployment——

Все включены через bundled.enabled: true.

2.3 Non-production embeddings stand-in

ПараметрЗначение
Тип ресурсаKubernetes manifest (не Helm)
Serviceap-agent-registry-embeddings (ClusterIP)
НазначениеСтенд для embeddings в non-production
Owneragent-platform

2.4 Helm-чарт charts/agent-platform (fixtures)

Релиз Helm: agent-platform-fixtures. Тот же чарт, что и runtime, но с переключёнными значениями: runtime компоненты отключены (enabled: false), активны только fixture-данные.

2.4.1 Smoke Agent

ПараметрЗначение
Имяsdk-smoke-v1 (dev-local) / st-smoke-v1 (st)
Версия1.0.0
Workspaceap-dev / ap-st

2.4.2 Low-code Agent

ПараметрЗначение
Имяlowcode-linguist-v1
Версия1.0.3
Workspaceap-dev / ap-st
ExposureHTTPRoute
Imagelow-code-runtime-image (собственная сборка)

2.4.3 HTTPRoute fixture

ПараметрЗначение
Имя маршрутаap-agent-linguist
Path/a2a/lowcode-linguist-v1
RewriteReplacePrefixMatch: / (снимает prefix)
Labelsexposure=nonprod_direct, authorization=none
Parentapi-gw.*-listeners
Owneragent-platform

3. Low-code IDE

3.1 Helm-чарт charts/langflow-sso

Релиз Helm: langflow.

3.1.1 Backend

ПараметрЗначение
Тип ресурсаDeployment
Реплики1
PVC5Gi (standard / longhorn)
CPU/RAMreq 250m/512Mi, lim 2/3Gi
Ownerlangflow

3.1.2 Frontend

ПараметрЗначение
Тип ресурсаDeployment
Реплики1
CPU/RAMreq 50m/64Mi, lim 500m/256Mi
Ownerlangflow

3.1.3 База данных

ПараметрЗначение
ТипSQLite (файловая, на PVC)
SpiceDBотключён (spicedb.enabled: false)

3.1.4 OIDC интеграция

ПараметрЗначение
Client IDlangflow-studio
Scopeopenid profile email
Admin Roleadmin
Audiencelangflow-api
Roles Claimresource_access.langflow-studio.roles

3.1.5 LiteLLM (Scibox)

ПараметрЗначение
Base URLhttps://litellm.ai-dev.inno.tech/v1
API KeyСекрет ap-model-provider-scibox / SCIBOX_API_KEY

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

4.1 Gateway API CRDs

ПараметрЗначение
Версия1.5.0
Файлstandard-install.yaml
SHA-256510338cf6709f84410efcce5269268f4c7c5067efdc5d04c75aa2fd2f8380c96
ТипClusterRole, ClusterRoleBinding, CRDs
ScopeCluster-scope (только disposable local)

4.2 Agentgateway CRDs

ПараметрЗначение
Chartagentgateway-crds v1.4.1 (OCI)
Digestsha256:8fbdf62d1c2e095da0c5b197770cd711a8338354e9439f73aee32bb7a90eb980
ТипCRDs (4 шт.)

CRDs:

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

4.3 Agentgateway Controller

ПараметрЗначение
Chartagentgateway v1.4.1 (OCI)
Controller Imagesha256:8b9e2bbe65b6a4b2ed93acd4fd0ede11f1eb2cfa8495e2b67c2d890e7fce8cec
Proxy Imageagentgateway:v1.4.1
Namespaceagentgateway-system
ТипDeployment
ScopeТолько disposable local

4.4 Local Gateway Topology (dev-local)

РесурсТипОписание
agentgateway-systemNamespaceПространство имён для gateway
api-platformGateway (ClusterIP)Data plane для API
applicationsGateway (ClusterIP)Data plane для приложений
api-gw.localhost-listenersListenerSetHTTP для api-gw.localhost
ide.localhost-listenersListenerSetHTTP для ide.localhost
docs.localhost-listenersListenerSetHTTP для docs.localhost

4.5 ST Gateway (внешняя, DevOps-owned)

ListenerSets в пространстве имён agentgateway-system, секция https:

ListenerSetHostМаршруты
api-gw.ai-dev.inno.tech-listenersapi-gw.ai-dev.inno.techAPI, Keycloak, low-code
ide.ai-dev.inno.tech-listenerside.ai-dev.inno.techLangflow
docs.ai-dev.inno.tech-listenersdocs.ai-dev.inno.techTeam Docs

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

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

RoutePathParentHost
ap-agent-registry-api/agent-registryapi-gw.*-listenersapi-gw.*
ap-team-docs-web/docs.*-listenersdocs.*
ap-agent-linguist/a2a/lowcode-linguist-v1api-gw.*-listenersapi-gw.*

5.2 Langflow

RoutePathParentHost
langflow-frontend/ide.*-listenerside.*

5.3 Keycloak

RoutePathParentHost
ap-agent-registry-keycloak/keycloakapi-gw.*-listenersapi-gw.*

6. Секреты и ConfigMaps

6.1 Секреты

СекретСодержимоеВладелец
ap-identity-adminAdmin credentials Keycloakap-deploy
ap-identity-fixture-usersPasswords fixture usersidentity-fixtures
ap-image-pull-secretRegistry credentialsap-deploy
ap-model-provider-sciboxSCIBOX API keyap-deploy
ap_build_ca_bundle_00a76a28Innotech Root + Issuing CAap-deploy

6.2 ConfigMaps

ConfigMapСодержимоеВладелец
ap-identity-realm-baseRealm-level desired stateap-deploy
ap-identity-fixturesFixture users desired stateidentity-fixtures
ap-identity-agent-platformAP client desired stateagent-platform
ap-identity-langflowLangflow client desired statelangflow
ap-identity-langflow-fixturesLangflow fixture grantslangflow

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

Production-компоненты (runtime)

#КомпонентТипРелиз HelmNamespaceOwner
1Keycloak (StatefulSet)StatefulSetagent-registry-keycloakap-*ap-deploy
2Agent Registry APIDeploymentagent-platformap-*agent-platform
3Kubernetes ReconcilerDeploymentagent-platformap-*agent-platform
4Outbox RelayDeploymentagent-platformap-*agent-platform
5Search IndexerDeploymentagent-platformap-*agent-platform
6Team DocsDeploymentagent-platformap-*agent-platform
7PostgreSQLStatefulSetagent-platformap-*agent-platform
8SpiceDBStatefulSetagent-platformap-*agent-platform
9OpenSearchStatefulSetagent-platformap-*agent-platform
10RedpandaStatefulSetagent-platformap-*agent-platform
11OpenTelemetry CollectorDeploymentagent-platformap-*agent-platform
12Embeddings stand-inDeploymentmanifestap-*agent-platform
13Langflow BackendDeploymentlangflowap-*langflow
14Langflow FrontendDeploymentlangflowap-*langflow

Infrastructure-компоненты

#КомпонентТипScopeOwner
15Gateway API CRDsCRDsCluster (local only)ap-deploy
16Agentgateway CRDsCRDsCluster (local only)ap-deploy
17Agentgateway ControllerDeploymentagentgateway-system (local)ap-deploy
18Gateway api-platformGateway (local)agentgateway-systemap-deploy
19Gateway applicationsGateway (local)agentgateway-systemap-deploy
20ListenerSet api-gw.*ListenerSetagentgateway-systemDevOps
21ListenerSet ide.*ListenerSetagentgateway-systemDevOps
22ListenerSet docs.*ListenerSetagentgateway-systemDevOps

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

#КомпонентТипРелиз HelmOwner
23Smoke AgentDeploymentagent-platform-fixturesagent-platform
24Low-code AgentDeploymentagent-platform-fixturesagent-platform
25Fixture HTTPRouteHTTPRouteagent-platform-fixturesagent-platform
26Fixture Users (3 шт.)Keycloak usersreconcilerap-deploy
27Langflow Fixture GrantsKeycloak grantsreconcilerlangflow

Jobs (опциональные)

#JobРелиз HelmOwner
28Search Reindexagent-platformagent-platform
29Retentionagent-platformagent-platform

Reconciler Jobs (Run actions)

#JobOwner
30realm-base reconcileap-deploy
31agent-platform-identity reconcileagent-platform
32langflow-identity reconcilelangflow
33identity-fixtures reconcileap-deploy
34langflow-fixtures reconcilelangflow

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

keycloak (StatefulSet)
  └── realm-base reconcile (Job)
        ├── agent-platform-identity reconcile (Job)
        │     └── agent-platform (Helm release)
        │           ├── api (Deployment)
        │           ├── kubernetesReconciler (Deployment)
        │           ├── outboxRelay (Deployment)
        │           ├── searchIndexer (Deployment)
        │           ├── teamDocs (Deployment)
        │           ├── postgresql (StatefulSet)
        │           ├── spiceDb (StatefulSet)
        │           ├── openSearch (StatefulSet)
        │           ├── redpanda (StatefulSet)
        │           ├── openTelemetryCollector (Deployment)
        │           └── embeddings (Deployment)
        │                 └── agent-platform-fixtures (Helm release)
        │                       ├── smoke agent (Deployment)
        │                       ├── low-code agent (Deployment)
        │                       └── HTTPRoute (ap-agent-linguist)
        └── langflow-identity reconcile (Job)
              └── langflow (Helm release)
                    ├── backend (Deployment)
                    └── frontend (Deployment)

Сборка образов (Build actions, не отображены в графе зависимостей развёртывания):

  • agent-platform-image → образ для Agent Registry API
  • team-docs-image → образ для Team Docs
  • low-code-runtime-image → образ для low-code fixture
  • langflow-backend-image → образ для Langflow Backend
  • langflow-frontend-image → образ для Langflow Frontend
  • keycloak-reconciler-image → образ для reconciler Jobs

Использование RAG

Предыдущая страница

Сервис памяти агентов

Следующая страница

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

Общие сведенияИмпортируемые Helm-чартыНе-Helm ресурсыОбщеплатфрменные сервисы1. Слой идентификации1.1 Keycloak Identity Provider1.2 Realm-base1.3 Keycloak Reconciler1.4 Тестовые пользователи идентификации2. Платформа ИИ2.1 Helm-чарт charts/agent-platform (runtime)2.1.1 Agent Registry API2.1.2 Team Docs2.1.3 Jobs2.2 Встроенные зависимости (bundled)2.3 Non-production embeddings stand-in2.4 Helm-чарт charts/agent-platform (fixtures)2.4.1 Smoke Agent2.4.2 Low-code Agent2.4.3 HTTPRoute fixture3. Low-code IDE3.1 Helm-чарт charts/langflow-sso3.1.1 Backend3.1.2 Frontend3.1.3 База данных3.1.4 OIDC интеграция3.1.5 LiteLLM (Scibox)4. Шлюзовая инфраструктура4.1 Gateway API CRDs4.2 Agentgateway CRDs4.3 Agentgateway Controller4.4 Local Gateway Topology (dev-local)4.5 ST Gateway (внешняя, DevOps-owned)5. HTTPRoutes (маршрутизация)5.1 Платформа ИИ5.2 Langflow5.3 Keycloak6. Секреты и ConfigMaps6.1 Секреты6.2 ConfigMaps7. Сводная таблица всех компонентовProduction-компоненты (runtime)Infrastructure-компонентыFixture-компоненты (opt-in)Jobs (опциональные)Reconciler Jobs (Run actions)8. Граф зависимостей развёртывания