AI Platform Docs

Граница доступа

Low-code Runtime не является прямым общедоступным сервером. Пользователь и AES вызывают агента только через Platform Agent Gateway. Gateway проверяет удостоверение, связь маршрута с конкретной версией и право agent#invoke, затем передает короткоживущее удостоверение, предназначенное этой рабочей нагрузке.

Внутренний адрес Low-code Runtime не публикуется Agent Registry и не должен использоваться клиентом.

Зафиксированные версии

Контракт	Версия
A2A	Спецификация 1.0.0, `A2A-Version: 1.0`, HTTP+JSON
MCP	2025-11-25, Streamable HTTP
FileRef	`platform.file-ref/v1`
Исходная схема	`platform.low-code.flow/v1`
Манифест	`platform.low-code.publish-manifest/v1`
JSON Schema	2020-12

Модели A2A и MCP преобразуются во внутренний нейтральный запрос исполнения. Они не используются как канонические внутренние модели приложения.

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

Метод и путь	Назначение
`GET /health/live`	Проверка живого процесса
`GET /health/ready`	Проверка источника, манифеста, политики, точки входа, карточки и критической настройки
`GET /.well-known/agent-card.json`	Проверенная карточка A2A выбранной версии

Эти маршруты принадлежат эксплуатационной и контрольной границе среды. Их публичность определяется политикой маршрутизации, а не фактом наличия в приложении.

Карточка формируется из манифеста и фактического реестра возможностей среды исполнения. Схема не может произвольно объявить потоковую передачу, уведомления или иной неподдерживаемый режим. Несоответствие приводит к advertised_capability_unavailable и блокирует готовность.

Профиль A2A первой поставки

Гарантированный профиль — синхронный message:send с текстовыми или структурированными данными и конечным результатом Message.

Последовательность обработки:

проверить версию протокола, тип содержимого и ограничение размера;
проверить удостоверение и право выполнения;
проверить и разрешить FileRef, если он присутствует;
применить входные Guardrails;
преобразовать части сообщения во внутренний запрос;
исполнить выбранную точку входа lfx;
применить выходные Guardrails и JSON Schema;
преобразовать результат в A2A Message;
вернуть очищенную ошибку и traceId при отказе.

Потоковая передача, уведомления, подписка, отмена и расширенная карточка не входят в гарантированный профиль без отдельного подтвержденного жизненного цикла задач. Они не объявляются и возвращают стандартный типизированный ответ о неподдерживаемой операции.

Профиль MCP первой поставки

MCP включается только если манифест содержит режим mcp_tool и проверка при запуске завершилась успешно.

Поддерживаются:

initialize и завершение начальной установки сеанса для редакции 2025-11-25;
tools/list, возвращающий один неизменяемый инструмент схемы, его входную и выходную JSON Schema и tools.listChanged=false;
tools/call, проверяющий аргументы и вызывающий тот же прикладной сценарий, что и A2A.

Не поддерживаются и не объявляются ресурсы, шаблоны ресурсов, подсказки, выборка, корни, elicitation, управление журналированием и экспериментальные задачи MCP. Неверный метод или аргумент не запускает схему.

Изменение определения инструмента требует новой версии манифеста и рабочей нагрузки. Динамическое уведомление об изменении списка не входит в поставку.

FileRef

Клиент передает логическую ссылку:

{
  "apiVersion": "platform.file-ref/v1",
  "fileId": "00000000-0000-0000-0000-000000000000",
  "name": "contract.pdf",
  "mediaType": "application/pdf",
  "size": 245000,
  "sha256": "64-hex",
  "capability": "opaque-target-bound-value",
  "expiresAt": "2026-08-11T10:15:00Z"
}

Проверяются подпись, издатель, получатель, срок, субъект, вызывающая служба, точный агент, операция, запуск, идентификатор файла, размер, тип и SHA-256. Произвольный URL, путь внутреннего хранилища и пользовательский токен не являются полномочием на чтение.

После проверки адаптер либо читает ограниченный поток байтов, либо получает одноразовый канал, повторно проверяет размер и SHA-256 и передает внутренний идентификатор поставщика в lfx. Этот идентификатор не возвращается клиенту как FileRef.

Просроченный, измененный, межпользовательский, предназначенный другому агенту или другой операции FileRef отклоняется до внешнего вызова и выполнения схемы.

Ограничения и повторные попытки

Перегрузка возвращает 429.
Ошибка формы, права, Guardrails и неподдерживаемая операция не повторяются.
Безопасное чтение может иметь не более двух повторных попыток с разбросом задержки.
Вызов модели или инструмента с побочным действием повторяется только при доказанной идемпотентности.
Установленный срок запроса распространяется на все внутренние действия.

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

Ответ и телеметрия не содержат исходный пользовательский токен, полномочие FileRef, подписанный URL, содержимое файла, секрет поставщика, текст закрытой схемы и внутренний адрес. Неожиданная ошибка преобразуется в стабильный код и безопасный traceId.

Точная форма интерфейса Agent Registry опубликована в отдельном справочнике.

Интерфейсы Low-code Runtime