AI Platform Docs

Карта компонентов

В таблице сохранён контекст базовой платформы. Изменение этого выпуска — «Активность и потребление» в Control Plane; его нагрузочная квалификация AU-I05 ещё не завершена.

Область	Изменение	Влияние и основной риск
Agent Registry API (R2)	Контракт v2: нет ручного API, только catalog/search с `agent#view`; Publisher — единственный issuer UUIDv7	Контракт `0.2-r2-draft`; R2 migration удаляет legacy grouping и `agent#invoke`; PDP outage → typed `503`
Control Plane	Добавлен функционал управления Моделями, API ключами и публикации Low-code агентов	Worker отделяется от API process; privileged side effects только через dedicated SA; auto-republish запрещён
Low-code Конструктор	Интеграция LangFlow через Deployment provider `agent-platform`; FlowVersion → CP	LangFlow остаётся source of truth для Flow/FlowVersion; CP создаёт immutable sourceArtifact; browser не вызывает CP
Фоновые процессы Agent Registry	Согласуют Kubernetes, транзакционную очередь, Redpanda, SpiceDB и OpenSearch	Нужны проверки повторной доставки, полного пересчета и восстановления после отказа
PostgreSQL	R2 схема	Обновление Alembic предшествует запуску; откат может уничтожить данные; legacy `agent#invoke` graph удаляется
SpiceDB	Выполняет актуальные проверки `agent#view`, `agent#owner`, `agent#viewer`	При отказе защищенные операции запрещаются (fail-closed, `503`); сохранённое разрешение недопустимо
OpenSearch и AI Gateway	Обеспечивают гибридный поиск и векторизацию (эмбеддинг, реранк)	Готовность для промышленной среды требует проверки качества и нагрузки на настоящих службах
Platform Agent Gateway	Становится единственной точкой вызова агента (A2A)	Gateway удаляет original bearer и caller identity; backend credential = none; ClusterIP + gateway-only NetworkPolicy
Low-code Runtime	Исполняет один immutable flow на `lfx`-образе через A2A и ограниченный MCP	Несовпадение flow, манифеста, политики или образа блокирует готовность; Agent-owned key через immutable Secret
Platform RAG	Управляемый retrieval: коллекции, ingest, hybrid search, ACL filtering	Интеграционный сервис отсутствует; Service не интегрирован с другими компонентами; SDK и low-code component — пути
Memory Service	Управляемый слой памяти: async write, sync search, Guardrails, ReBAC	Service не интегрирован с другими компонентами; SDK и low-code node — пути; Redis блокирует session state
Garden и Helm	Задают единый сценарий развертывания реализованных сред	Ручное применение Helm или Kubernetes не считается воспроизводимым результатом

Для Activity изменяются следующие компоненты:

Область	Изменение	Влияние и основной риск
Control Plane	Агрегаты, графики и журнал LLM-запросов, агрегаты HTTP-запросов к агентам	Дополнительное чтение ClickHouse и текущих прав; недоступность аналитики должна быть видна явно
ClickHouse	Таблица `activity.otel_logs`, схема `activity-storage/v2`, история API 30 дней	Новый постоянный том, миграция, фоновые TTL и резервное копирование; промышленная топология ещё не квалифицирована
Collector Contrib	Отдельный поток Activity и постоянная очередь на диске	Нужны место на PVC, контроль очереди, ошибок и пропусков; общий приём технической телеметрии сохраняется

Влияние на пользователей

Автор Low-code-агента получает возможность публикации агента из интерфейса Low-code Конструктора.

Пользователь видит потребление доступных ему сущностей за выбранный период. Право на агрегаты агента и право на подробную диагностику его LLM-вызовов различаются: владение агентом само по себе не открывает журнал служебного ключа. Состав результата определяется текущими правами без отдельной проекции только собственных сущностей. Неизвестные токены и неполная доставка видны явно и не подменяются нулём.

Влияние на администрирование

Администратор платформы получает возможность централизованного управления LLM и ключами доступа к ним.

Для Activity добавляются эксплуатация ClickHouse, отдельные учётные записи чтения, записи и миграции, том очереди Collector, наблюдение за доставкой и резервными копиями. В dev-local это часть основной композиции с локальным эмулятором OpenAI API; корпоративная инфраструктура не требуется для базовых проверок. Ресурсы этого профиля пока нельзя переносить как проверенную норму для промышленной нагрузки.

Влияние на контракты

A2A зафиксирован на версии 1.0.0 и передаче HTTP+JSON.
MCP зафиксирован на редакции 2025-11-25 и Streamable HTTP.
OpenAPI зафиксирован на версии 3.1.2, JSON Schema — на 2020-12.
Исходная схема Low-code изменена с platform.low-code.flow/v1 на platform.low-code.flow/v2 (детерминированный экспорт на основе FlowVersion).
Манифест Low-code использует platform.low-code.publish-manifest/v1.
Регистрация в Kubernetes использует agent-platform.agent-registry.registration/v1.
FileRef использует platform.file-ref/v1.
CloudEvents на версии 1.0.2.
Kubernetes для поставки зафиксирован на версии 1.36.2.
Activity использует профиль agentgateway-1.5-conservative/v2 и схему activity-storage/v2; версии нормализации события и схемы хранения имеют разные назначения.
Вызовы Activity API дополняют Control Plane. Асинхронный жизненный цикл A2A и сквозная атрибуция LLM-вызова пользователю агента не добавляются.

Влияние на данные

R2 migration Agent Registry удаляет legacy grouping и agent#invoke graph, републикует managed Agents, backfills only explicit direct grants и проверяет zero legacy relationships before contract.

PostgreSQL — каноническая проекция Agent Registry и job store ingest для RAG. OpenSearch — пересоздаваемая поисковая проекция (каталог агентов и RAG-индекс). Редко используемые факты Memory Service могут понижаться в ранжировании (decay).

Low-code Runtime не хранит изменяемую авторскую копию Flow. Каждый экземпляр исполняет один источник и манифест с неизменяемыми контрольными суммами. Рабочая версия Low-code Конструктора и артефакт исполнения имеют разные назначения.

ClickHouse хранит очищенные метаданные событий Activity. Типизированные вычисляемые колонки v2 находятся в той же таблице; исходные поля сохраняются, агрегатные витрины не создаются. Миграция заполняет колонки существующих данных до публикации версии v2 и может потребовать отдельного окна на большой истории. Штатный повторный запуск готовой v2 не повторяет заполнение.

TTL ClickHouse, ограничение API в 30 дней и срок жизни резервных копий — три разных механизма. Откат приложения не удаляет историю и не понижает схему; для возврата нужен совместимый читатель. См. план миграции и эксплуатацию Activity.

Влияние на безопасность

Исходный пользовательский токен не передается в Low-code Runtime, MCP, AI Gateway, OpenSearch, Redpanda или RabbitMQ;
видимость агента не означает наличие права на его вызов;
в R2 отсутствует workspace, team, group, tenant, organization или project как источник полномочий (ADR-0002);
пользовательские поля owner и заголовки удостоверения не являются источником полномочий; отображаемое имя, электронная почта, роли и группы поставщика идентичности — тоже;
схема агента LangFlow, карточка агента, описание MCP, поисковый запрос и FileRef считаются недоверенными входными данными;
журналы и трассировки не должны содержать токены, секреты, текст запросов, содержимое файлов, полные карточки и внутренние адреса;
при отказе SpiceDB запрос останавливается до обращения к агенту (запрет при ошибке проверки);
вызов A2A: Gateway применяет platform_oidc + authenticated_all; agent#invoke в R2 отсутствует; исходный токен и личность вызывающего не передаются агенту;
Activity не сохраняет тела запросов и ответов, исходные токены доступа или заголовки с секретами; разрешённые поля очищаются до постоянной очереди;
права Activity проверяются заново при каждом чтении, включая старые страницы журнала; курсор не фиксирует прежнее разрешение;
доступ к ClickHouse разделён между collector (запись), reader (чтение) и migrator (DDL); вычисляемые колонки не заменяют доверие к источнику записи;
Activity OTLP доступен только разрешённым шлюзам, а права на метрики Collector получает назначенный Model Worker; обычный пользователь CP не получает прямого доступа к ClickHouse либо очереди.

Анализ влияния версии 2026.4.1