AI Platform DocsРазработка
Именование объектов в Платформе
Базовые соглашения по именованию сущностей, объектов, компонентов.
Официальное наименование продукта: Платформа ИИ.
Среды развертывания в Т1
| Наименование среды | Кластер | Namespace |
|---|---|---|
| QA (ранее ST) | ai-dev | aip-qa - Ядро платформы; aip-qa-services - RAG+Memory |
| UAT | in-vtl-k8s | aip-uat |
| PreProd | in-vrl-k8s | aip-preprod |
| Prod | in-vpl-k8s | aip-prod |
Компоненты платформы
| # | Компонент | Русскоязычное наименование (для документации и UI) | Домен | Назначение | Альтернативные (legacy) или внутренние наименования |
|---|---|---|---|---|---|
| 1 | Agent Registry | Реестр агентов | core | Каталог агентов. Наблюдает за allowlist пространств имён aip-<env>-agents, хранит карточки агентов, обеспечивает permission-aware get/list/search. Read-only каталог, не управляет публикацией. | registry, aip-agent-registry |
| 2 | Agentgateway | core | Инфраструктурный сервис шлюза (agentgateway, CRD). Выполняет аутентификацию, авторизацию (частично) и проксирование вызовов. Две границы: Platform API Gateway (api-gw) — management/discovery, Platform Agent Gateway (agent-gw) — A2A-invocation. | ||
| 3 | Control Plane | Панель управления | core | Управляющая подсистема, единственный public API для platform-managed desired state. Владеет моделями/providers, виртуальными API-ключами, grants и публикацией агентов (Agent Publication). | CP, control-plane, aip-control-plane |
| 4 | Team Docs | Онлайн документация | core | Статическая документация команды. Выставлена на отдельном origin docs.*. | team-docs, aip-docs |
| 5 | Rate Limit Service (RLS) | core | Подкомпонент LLM Gateway: сервис ограничения запросов | rls, ratelimit, envoy-ratelimit | |
| 6 | Valkey | - | core | Redis-совместимое KV хранилище. Используется в RLS и других сервисах. | valkey, ap-llm-counters, valkey-sentinel |
| 7 | SpiceDB | - | core, RAG | Сервис авторизации (ReBAC). | — |
| 8 | PostgreSQL | - | core, RAG, memory | Каноническое хранилище: метаданные Agent Registry, event store Memory Service, job store RAG, схема migrations (Alembic). | — |
| 9 | Redpanda | - | core | Брокер сообщений. Используется в Agent Registry (outbox events). | — |
| 10 | OpenSearch | - | core, RAG, memory | Векторный и полнотекстовый поиск: проекция каталога Agent Registry, индекс фактов Memory Service, индекс чанков RAG. | — |
| 11 | OpenTelemetry Collector | - | core | Приём телеметрии (traces, metrics) от всех компонентов. | — |
| 12 | Temporal | Оркестратор workflow | core | Workflow-оркестратор для Control Plane. Общий провайдер aip-temporal в aip-<env>-infra. | temporal, aip-temporal |
| 13 | Temporal Web UI | Панель управления Temporal | core | Веб-интерфейс для мониторинга и управления Temporal workflows (оркестрация Control Plane). | temporal-web, temporal-ui |
| 14 | Keycloak Identity Provider | Провайдер учётных записей | core | Управляемый поставщик OIDC/SSO, обслуживает общий для обоих продуктов realm. Выставлен на префиксе /keycloak. Релиз aip-keycloak в aip-<env>-infra. | KeycloakX, aip-keycloak, identity-provider |
| 15 | Keycloak Reconciler | core | Одноразовый Pod, применяющий декларативное состояние realm через Keycloak Admin REST API. Идемпотентное применение, ограниченное своим scope: базовые настройки realm, затем clients, роли, пользователи каждого продукта. | realm-base, agent-platform-identity, langflow-identity | |
| 16 | Low-code Runtime | Среда исполнения low-code агента | core | Исполняет один неизменяемый low-code Flow и предоставляет согласованные интерфейсы A2A и MCP. Low-code агент публикуется через Control Plane API (тот же путь, что и «Publish» в Конструкторе), доступен по стабильному /a2a/v1/agents/{agent_id}. | lfx runtime, runtime, low-code-agent-runtime |
| 17 | Low-code Конструктор | core | Позволяет создавать, сохранять и проверять Flow агента (адаптированная версия langflow, источник исходного кода). Бэкенд + фронтенд, отдельный origin ide.*, пространство имён aip-<env>-low-code-ide. | Low-code IDE, LangFlow, LangFlow Studio, low-code-studio, IDE | |
| 18 | RAG service | Платформенный RAG сервис | RAG | Внешний read-only сервис извлечения знаний, подключаемый к платформе как отдельное приложение. Источник исходного кода принадлежит другой команде (deploy только упаковывает образы). Живёт в aip-<env>-services. Зависит от PostgreSQL, RabbitMQ, OpenSearch, SpiceDB. | RAG, platform-rag, RAG API, retrieval |
| 19 | Memory Service | Платформенный сервис памяти агентов | memory | Внешний read-only сервис персистентной памяти, подключаемый к платформе как отдельное приложение. Источник исходного кода принадлежит другой команде (deploy только упаковывает образы). Живёт в aip-<env>-services. Публичный контракт совместим с mem0. Зависит от PostgreSQL, RabbitMQ, OpenSearch. | Platform Memory, memory, platform-memory, Memory API |
| 20 | RabbitMQ | - | RAG, memory | Очередь заданий для Memory Service (memory.add) и RAG (rag.ingest). | — |
| 21 | S3 / MinIO | - | RAG | Staging канонических документов RAG на время ingest-задания. | — |
| 22 | Embeddings stand-in | RAG | Стенд для embeddings в non-production средах (замена реальному AI Gateway). | non-production embeddings | |
| 23 | Agent execution service | core | Механизм оркестрации агентов. ex. Hub. |
Бизнес-сущности
| # | Англоязычный термин | Русскоязычный термин | Назначение | Альтернативные (legacy) наименования | Где упоминается | Рекомендуемое наименование |
|---|---|---|---|---|---|---|
| 1 | Agent | Агент | Представляет сущность платформы Agent | low-code agent, sdk agent, smoke agent, linguist agent, agent_id | Agent Registry, Low-code Runtime, Register SDK A2A, Control Plane PRD | Agent (каноническое) |
| 2 | Agent Card | Карточка агента | JSON-описание агента: имя, версия, поддерживаемые интерфейсы (A2A/MCP), навыки, возможности (streaming, push, extended). | agent-card, A2A Agent Card | Register SDK A2A, Low-code Runtime, Agent Registry | Agent Card (каноническое) |
| 3 | AgentVersion | Версия агента | Неизменяемая версия identity (UUIDv7), SemVer, протокол, тип реализации. Один агент может иметь несколько версий | agent version, immutable agent version, AgentVersion ID, agent_version_id | Control Plane PRD | AgentVersion |
| 4 | Flow | Поток (Flow), Флоу | Визуально редактируемый граф узлов (нод), определяющий логику агента. Хранится в Low-code Конструкторе как рабочая/зафиксированная версия. Экспортируется в source.json. | flow, low-code pipeline, langflow flow, пайплайн langflow, поток, Поток (Flow) | Low-code Конструктор, Low-code Runtime, admin/low-code-ide, admin/low-code-runtime | Flow (соответствует langflow/LFX) |
| 5 | FlowVersion | Версия потока (Flow) | Версия Flow: рабочая (редактируемая) или зафиксированная (с SHA-256). Определяет неизменяемый артефакт для Runtime. | flow version, версия пайплайна, pipeline version, рабочая версия, зафиксированная версия, версия потока | Low-code Конструктор, Low-code Runtime, docs/contracts/version-registry | FlowVersion |
| 8 | Principal | Пользователь | Субъект-человек, обладающий идентичностью в Keycloak. | пользователь, user, user principal, subject, human principal | Agent Registry, admin/agent-registry | Principal |
| 9 | Service Principal | ТУЗ, Сервисный пользователь, | Сервисный субъект. | service principal, machine principal, service-token principal | Control Plane PRD | Service Principal |
| 10 | Provider | Провайдер | Конфигурация upstream-поставщика моделей | model provider, upstream provider, provider configuration, provider credential | Control Plane PRD | Provider |
| 11 | Model | Модель | Объект, представляющий LLM в платформе. Привязан к провайдеру. | model identity, routable model, routable model identity, model, LLM model | Control Plane PRD | Model |
| 13 | Tier | Профиль доступа | Технический профиль качества обслуживания (rate-лимит и квоты), на который ссылается ApiKey. | tier, rate profile, quota profile, technical rate/quota profile | Control Plane PRD | Tier |
| 14 | ApiKey | API ключ | Ключ доступа к модели с примененным профилем качества. | api key, virtual key, virtual LLM key, key, LLM API key, key_id | Control Plane PRD | ApiKey |
| 17 | Skill | Навык | Декларация способности агента. Часть Agent Card. | skill, agent skill | Register SDK A2A | Skill |
| 18 | Collection | Коллекция | Управляемый индекс знаний в RAG | knowledge base, RAG collection, knowledge collection | Platform RAG, api/rag | Collection (каноническое) |
| 19 | Document | Документ | Нормализованный документ приёма RAG | канонический документ, canon document, doc, chunk | Platform RAG, api/rag | Document (каноническое) |
| 20 | Chunk | Чанк | Единица текста, полученная из документа при чанкинге. | fragment, текстовый фрагмент | Platform RAG | Chunk |
| 21 | Fact | Факт | Атомарное знание о пользователе, агенте или задаче, извлечённое из диалога (LLM-инференс) или записанное напрямую. | запись памяти, memory record, memory entry | Memory Service, api/memory | Fact |
| 25 | Tenant | Тенант | Многотенантная граница в RAG: X-Tenant-Id. Фильтр выдачи по tenant_id обязателен. | tenant, tenant_id | Platform RAG | Tenant |
| 28 | Manifest | Манифест | Описывает агента, карточку A2A/MCP, ссылку на source.json, SHA-256, политику компонентов. | publish manifest, low-code manifest, publish-manifest | Low-code Runtime, admin/low-code-runtime, docs/contracts/version-registry | Publish Manifest |