AI Platform DocsРазработка
Именование объектов в Платформе
Базовые соглашения по именованию сущностей, объектов, компонентов.
Официальное наименование продукта: Платформа ИИ.
Среды развертывания в Т1
| Наименование среды | Кластер | Namespace |
|---|---|---|
| ST | ai-dev | ap-st - Ядро платформы; gpt-(dev/st) - RAG+Memory |
| QA | ai-dev | ap-qa |
| UAT | in-vtl-k8s | ap-uat |
| PreProd | in-vrl-k8s | ap-preprod |
| Prod | in-vpl-k8s | ap-prod |
Компоненты платформы
| # | Компонент | Русскоязычное наименование (для документации и UI) | Домен | Назначение | Альтернативные (legacy) или внутренние наименования |
|---|---|---|---|---|---|
| 1 | Agent Registry | Реестр агентов | core | Автоматически обнаруживает агентов в Kubernetes, ведёт реестр агентов, возвращает проверенный адрес вызова, управляет жизненным циклом агентов (active/rejected/degraded). | registry, ap-agent-registry |
| 2 | Agentgateway | core | Выполняет аутентификацию, авторизацию (частично) и проксирование вызовов на внутренние группы API. Группирует Application gw, LLM gw, Agent gw и пр. Инфраструктурный k8s сервис (CRD) | ||
| 3 | Control Plane | Панель управления | core | Управляет публикацией агентов, политиками моделей/ключей. | CP, control-plane |
| 4 | Team Docs | Онлайн документация | core | Онлайн документация платформы. | team-docs, ap-team-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 | temporal, ap-temporal, temporal-server, temporal-worker |
| 13 | Temporal Web UI | Панель управления Temporal | core | Веб-интерфейс для мониторинга и управления Temporal workflows (оркестрация Control Plane). | temporal-web, temporal-ui, ap-temporal-ui |
| 14 | Keycloak Identity Provider | Провайдер учетных записей | core | OIDC-провайдер платформы. Хранит realm, клиентов, роли, мапперы. | KeycloakX, ap-agent-registry-keycloak, identity-provider |
| 15 | Keycloak Reconciler | core | Job-процесс, согласующий желаемое состояние realm/clients/roles/scopes/mappers в Keycloak. | identity-reconciler | |
| 16 | Low-code Runtime | Среда исполнения low-code агента | core | Исполняет один неизменяемый low-code Flow и предоставляет согласованные интерфейсы A2A и MCP. Один Deployment = один агент. | lfx runtime, runtime, low-code-agent-runtime |
| 17 | Low-code IDE | Конструктор | core | Позволяет создавать, сохранять и проверять Flow агента (адаптированная версия LangFlow). | LangFlow, LangFlow Studio, low-code-studio, IDE, langflow |
| 18 | RAG service | Платформенный RAG сервис | RAG | Управляемый сервис извлечения знаний: реестр коллекций, приём документов (ingest), гибридный поиск с фильтрацией по правам (ACL), выдача фрагментов с цитатами. Зависит от PostgreSQL, RabbitMQ, OpenSearch, S3/MinIO, AI Gateway, SpiceDB. | RAG, platform-rag, RAG API, retrieval |
| 19 | Memory Service | Платформенный сервис памяти агентов | memory | Управляемый слой персистентной памяти: извлечение фактов (LLM-инференс), мультисигнальный поиск, CRUD, рабочая память сессий. Публичный контракт совместим с mem0. Зависит от PostgreSQL, RabbitMQ, OpenSearch, AI Gateway. | 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 IDE как рабочая/зафиксированная версия. Экспортируется в source.json. | flow, low-code pipeline, langflow flow, пайплайн LangFlow, поток, Поток (Flow) | Low-code IDE, 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 IDE, 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 |