Agent Runner

runner-agent выполняет версионируемые системные агенты AI Router как jobs Command Manager. Agent loop работает в runner, но доступ к LLM, tools, RAG и артефактам проходит через policy-checked Runtime API AI Router.

Установка

ush install agent --start \
  --set url=https://platform.example.com/ \
  --set ai-router-url=https://platform.example.com/proxy/ai-router \
  --set token=SERVICE_TOKEN

Бинарник публикуется по общей схеме: https://storage.unishift.ru/runners/{os}/agent. Версия передаётся заголовком X-Version; перед запуском CLI выставляет executable permissions.

Требования

• Доступ к gRPC endpoint Command Manager через Gateway.
• Доступ к internal Runtime API AI Router.
• Совместимая версия runner protocol.
• Service token аутентифицирует runner в Command Manager и internal Runtime API. Каждый agent job дополнительно получает отдельный краткоживущий delegated token в X-Agent-Job-Token.

Runner не требует PostgreSQL и не должен получать ключи LLM, MCP или Storage.

Capabilities

При подключении runner объявляет protocol/runtime version и capabilities:

Capability	Назначение
agent.run.v1	Базовый agent loop
artifact.pptx.v1	Typed IR презентаций
artifact.diagram.v1	Typed IR draw.io/BPMN
a2a.client.v1	Remote A2A runtime

AgentVersion доступна для запуска только при наличии online runner со всеми capabilities из requires. Если подходящего runner нет, API возвращает runner_unavailable; job не остаётся в очереди.

Выполнение

Runner получает immutable snapshot:

• идентификаторы run и версии;
• инструкции, rules и skills;
• input/output schemas;
• pipeline и allowlist tools;
• scopes/MCP references;
• лимиты шагов, времени, токенов и tool calls;
• delegated token.

Progress отправляется через runner stream. Остановка job отменяет context agent loop. Terminal result содержит typed JSON либо ошибку; создание файла и запись chat message выполняет AI Router.

Конфигурация

Общие параметры описаны в настройках runners.

Env	Назначение
URL	Gateway / Command Manager gRPC endpoint
TOKEN	Service token регистрации
AI_ROUTER_URL	Internal Runtime API AI Router
CONCURRENCY	Число параллельных agent jobs
TASK_TIMEOUT	Максимальная длительность job

Граница доверия

Публичный runner считается недоверенным клиентом. AI Router при каждом runtime-вызове проверяет подпись и срок job-token, run status, user/tenant, allowlist, scopes и budgets. Ограничения безопасности не должны существовать только в prompt или коде runner.