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

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

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

queuedrunningwaiting_for_agentwaiting_for_usercompletedfailedcancelled

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

Конструктор

harness.create · create_version · add_role · add_workflow_node · validate · publish

Запуски

council.start_run · get_run · advance_run · retry_step

Участники

work.list_available · work.claim · work.heartbeat · work.complete

Решения

proposal · critique · vote · approval · task_plan
MCP · пример вызова
council_submit_proposal({
  run_id: "run_8f2c1",
  role_key: "proposer",
  summary: "Разделить сервис уведомлений на отдельный воркер",
  body: "Снижает связность релизов и позволяет независимо масштабировать очередь"
})

Глоссарий

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

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

Чем Harness отличается от обычного чата с несколькими агентами?

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

Можно ли использовать Harness без Flownix?

Нет: запуск всегда ссылается на конкретную HarnessVersion и опирается на ноды и политики Flownix — это часть его coordination plane.

Что произойдёт при превышении бюджета?

Run останавливается предсказуемо на границе лимита (раунды, вызовы модели, токены, стоимость или время); частично выполненная работа остаётся в истории, а run переходит в failed.

Когда появится встроенный runner?

Это целевая возможность, которая ещё не опубликована; интерфейс явно пометит её доступной только после выпуска — сейчас рекомендуемый путь — внешний host через MCP.

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

Нет: Version — неизменяемый снимок. Изменения оформляются как новая версия, а уже запущенные run продолжают ссылаться на ту, с которой были начаты.

Что если агент не продлит lease вовремя?

Lease истекает, WorkItem безопасно возвращается в очередь для другого участника; идемпотентность не позволяет повторной доставке создать второй результат.