AI Platform Docs

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

Компонент предназначен для запуска экземпляра Low-code агента в Kubernetes кластере.

Один Deployment Low-code Runtime исполняет одну версию одного агента. Все его экземпляры используют одинаковые исходные данные, манифест, образ и настройки. Среда исполнения не подключается к базе Low-code IDE и не загружает изменяемую рабочую копию.

Наружу предоставляются только согласованные A2A и MCP интерфейсы. Административный API LangFlow и внутренний интерфейс lfx не публикуются.

Неизменяемые входные данные

Перед развертыванием зафиксируйте:

Данные	Требование
Образ	Неизменяемый идентификатор, полный SBOM и файл блокировки зависимостей
`source.json`	JSON Потока (Flow) и SHA-256
`manifest.json`	`platform.low-code.publish-manifest/v2`, SHA-256 и ссылка на исходные данные
Политика компонентов	Версия, соответствующая разрешенному набору поставки
Карточка A2A или описание MCP	Совпадает с манифестом и фактическими возможностями
Настройки выпуска	Версия манифестов Kubernetes, ресурсов и регистрационных меток

Исправление любого байта создает новую версию и новую контрольную сумму. Изменять файл внутри работающего контейнера запрещено.

Последовательность запуска

Low-code Runtime должен:

получить исходный Flow и манифест по токену либо ограниченному полномочию;
ограничить тип содержимого, размер и время получения;
проверить SHA-256 обоих файлов;
проверить Flow, идентичность агента, политику и совместимость с lfx;
повторно проверить компоненты, исполняемый код и отсутствие секретов;
загрузить Flow через поддерживаемый интерфейс;
выполнить проверку эндпоинта без вызова модели;
сформировать карточку либо описание и сравнить его с разрешенными возможностями;
перейти в состояние готовности.

Проверки состояния

Маршрут	Значение	Не доказывает
`/health/live`	Процесс работает	Исправность Потока (Flow), модели и доступа
`/health/ready`	Артефакт, манифест, точка входа и критическая настройка приняты	Качество ответа модели и право конкретного пользователя
`/.well-known/agent-card.json`	Карточка A2A выбранной версии	Право вызова; публичный клиент получает маршрут через Agent Registry

Проверка готовности не должна выполнять тяжелый запрос к модели. Фактическая работоспособность модели через AI Gateway подтверждается отдельной сквозной проверкой.

Ручная процедура развертывания

Информация: Agent Publisher в этой версии отсутствует.

Оператор выполняет шаги вручную:

получить Flow из Low-code IDE или другого источника, соответствующего тому же контракту;
запустить общий модуль проверки и формирования манифеста;
убедиться в результате valid и сохранить контрольные суммы;
загрузить source.json и manifest.json в объектное хранилище по пути, содержащему контрольную сумму;
развернуть экземпляр агента в Kubernetes с обязательными метками, включая agent-platform.inno.tech/implementation-type=low-code;
дождаться готовности Low-code Runtime;
сравнить фактическую карточку или описание с манифестом;
дождаться автоматического обнаружения Agent Registry.

Создание агента через Agent Registry API или прямой записью в PostgreSQL запрещено: ни через API, ни через прямую запись в БД.

Регистрационный контракт

Одна сущность Service Kubernetes объявляет один протокол. Если один Deployment агента предоставляет A2A и MCP интерфейсы, создаются две сущности Service с разными логическими именами. Обязательные метки включают регистрацию, протокол, имя, версию, владельца и тип low-code. Аннотация версии контракта равна agent-platform.agent-registry.registration/v1.

Имя агента соответствует виду <domain>-<function>-v<major>, а основная версия имени совпадает с SemVer версии рабочей нагрузки.

Типичные причины неготовности

Признак	Проверка	Безопасное действие
Несовпадение SHA-256	Сравнить байты файла, путь и ожидаемый SHA-256	Повторно разместить файл Потока (Flow) как новую версию
`component_not_allowed`	Найти узел и версию политики в результате проверки	Исправить Поток (Flow) в Low-code IDE; не отключать проверку
Несовместимость среды исполнения	Сверить версию `lfx` и набор совместимости	Заблокировать обновление либо создать совместимый Поток (Flow)
`advertised_capability_unavailable`	Сравнить манифест, карточку и исполняемый путь	Убрать неподдерживаемую возможность и создать новую версию
Ошибка AI Gateway	Проверить целевой профиль, срок полномочия, ограничение времени	Исправить настройку платформенной службы; не передавать пользовательский токен
Ошибка FileRef	Проверить цель, операцию, срок, размер, тип и SHA-256	Получить новый FileRef; не передавать прямой URL
Превышение нагрузки	Проверить параллельность, очередь и сроки	Вернуть `429`, применить ограниченную повторную попытку только для безопасного чтения

Безопасность

Пользовательский запрос приходит только через Platform Agent Gateway.
Gateway проверяет platform OIDC и разрешает вызов любого активного агента любому действительному пользователю платформы; исходный пользовательский токен и заголовки идентификатора удаляются до обращения к среде исполнения.
Low-code Runtime не выполняет авторизацию пользователя и не получает пользовательский токен, идентификатор вызывающего или учётные данные Gateway.
Неподписанные заголовки пользователя и агента не являются полномочием.
Guardrails и FileRef выполняются в Runtime; проверка прав пользователя выполняется Platform Agent Gateway до обращения к среде исполнения.
Flow не может менять ServiceAccount, сетевую политику, тома, переменные среды, ограничения ресурсов и регистрационные метки.

Наблюдаемость

Для диагностики достаточно идентификатора агента и версии, версии Потока (Flow), хеш-префикса, traceId, кода ошибки.

Условие успешной эксплуатации

Версия считается исправной, когда готовность агента устойчива, карточка соответствует поведению, A2A и MCP проходят согласованный набор проверок, неверные FileRef и права отклоняются до выполнения, а Agent Registry автоматически обнаруживает рабочую нагрузку развернутого агента.

Low-code Runtime