Разделы
На этой странице

Статусы, MCP и глоссарий

Короткий справочник по статусам запуска, действующей MCP-поверхности, бюджетам, политикам и сущностям совета.

queuedrunningwaiting_for_agentwaiting_for_usercompletedfailedcancelled

MCP-поверхность

Конструктор

harness.list · create · create_version · add_role · add_workflow_node · connect_workflow_nodes · set_budget · set_context_policy · set_output_schema · set_policy · validate · publish

Запуски

harness.start_run · get_run · list_runs · list_pending_approvals · retry_step

Участники

work.list_available · work.claim · work.get_context · work.heartbeat · work.complete · work.fail

Решения

council.get_deliberation · submit_proposal · submit_claim · submit_critique · cast_vote · abstain · submit_judgement

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

MCP · пример вызова
council.submit_proposal({
  deliberation_id: "deliberation_8f2c1",
  author_agent_id: "architect-1",
  title: "Выделить worker",
  summary: "Перенести асинхронную доставку в отдельный сервис",
  body: "Это снижает связность релизов и позволяет отдельно масштабировать очередь",
  confidence: 0.82
})

Коротко о рантайме

  • Опубликованная версия неизменяема; запустить можно только опубликованную версию.
  • agent_task и review создают один work item. debate и vote создают min_instances work items. judge создаёт один.
  • condition, loop, human_gate, create_flow_nodes и end ведёт рантайм. parallel_group и transform сейчас ничего не делают и дают предупреждение node.unimplemented_type.
  • Ноды одного совета разделяют deliberation только при одинаковом config.deliberation_key.
  • Правила vote находятся в config ноды vote. Раунды debate задаёт config.max_rounds, обычную доработку — нода loop.
  • Исполняется только политика tools для вызовов work.* и council.*. Другие категории возвращают policy.not_enforced.
  • output_schema роли исполняется на work.complete, output_schema версии (harness.set_output_schema) — на шагах, ведущих в end. Несоответствие — output.schema_violation, некорректная схема — output.schema_invalid.
  • harness.set_context_policy выбирает секции work.get_context (run_input, role, predecessors, all_steps), вырезает ключи exclude и ограничивает выходы шагов max_tokens.
  • Бюджет ограничивает длительность run, число work items, заявленные токены и стоимость. Превышение завершает run с budget.exceeded.

Глоссарий

  • Definition — именованный шаблон; Version — черновая или неизменяемая опубликованная конфигурация.
  • Run — один запуск Version; StepRun — одно прохождение workflow-ноды; WorkItem — leased работа внешнего агента.
  • Proposal — вариант решения; Claim — проверяемое утверждение; Evidence — подтверждающий или опровергающий материал; Critique — обоснованное возражение и ответы на него.
  • Deliberation — общее состояние совета; Ballot — голосование по его предложениям; Decision — записанный вердикт или победившее предложение.
  • ApprovalRequest — решение человека, запрошенное human_gate или tools-политикой require_approval.
  • Artifact — ссылка на результат. create_flow_nodes может превратить подтверждённый список output.flow_nodes в реальные ноды Flownix.

Частые вопросы

Можно ли менять опубликованную версию?

Нет. Создайте новую черновую версию или склонируйте полное определение. Текущие run сохраняют исходную версию.

Как агент получает весь контекст?

После claim вызовите work.get_context: он вернёт вход run, исходные ноды, роль, выходы предшественников, deliberation ID и ballot для vote-ноды — в составе, который задаёт политика контекста версии.

Как понять, почему run ждёт?

Прочитайте его через harness.get_run; решения человека показывает harness.list_pending_approvals. Агент ответить на них не может.

Что если агент пропустил срок lease?

Попытка расходуется, а work item возвращается в очередь, пока остались попытки. Длительность lease и retry задаются на workflow-ноде.