После динамических workflow Claude: почему прогресс всё ещё JSON? От multiagent_20261001 к workflow_run.status_ended

На 12 октября 2026: бета от 9 октября позволяет Managed Agent написать workflow. Прогресс — не последняя фраза, а события workflow_run. completed значит, что программа дошла до конца, а не что каждый поток удался.

Динамические workflow забирают «дождаться конца модели и потом разобрать». Контракт прогресса по-прежнему поток JSON-событий. 9 октября 2026 Claude Managed Agents открыл динамические workflow в бете, с заголовком managed-agents-2026-04-01. Агент пишет программу. Сервер выполняет её в фоне как workflow run. Следить нужно не за последней фразой, а за workflow_run.* в потоке событий сессии.

Текст написан на 12 октября 2026 по заметке о выпуске и странице Workflow runs. У нас уже есть Agents API и JSON Schema и MCP, Skills, Tools и Subagents. Здесь один вопрос: какой JSON считается концом запуска и какой нельзя принять за успех.

Что открылось 9 октября

Переключатель сидит в блоке multiagent. С типом multiagent_20261001 и subagents, и workflows включены по умолчанию. Только workflow: subagents в disabled. Уже созданные агенты — в workflows.predefined_agents. Агенты, которых пишет сам workflow, — inline.

{
  "type": "multiagent_20261001",
  "workflows": { "type": "enabled" }
}

У запуска три слоя: фоновый workflow run (открытых может быть несколько), фазы с именами, которые пишет модель, и потоки агентов. Программа может стартовать многих сразу, передавать результат дальше и повторять шаг внутри фазы. Запуск начинает только агент. Ни одно отправленное вами событие его не заканчивает. Архивация сессии может.

События идут по потоку сессии и видны в списке событий. Webhook они не вызывают. Срок жизни по умолчанию 24 часа, агент может укоротить. Ожидание клиента и паузы входят в срок. Запуск, который остаётся на паузе, может закончиться timeout_error.

created — это список фаз

workflow_run.created несёт workflow_run_id (wrun_), name, description и phases. У фазы есть id (wrph_), name и description. Нет описания — поле null. phases всегда есть и может быть пустым. Имена пишет модель или сервер. Это не стабильный enum.

{
  "type": "workflow_run.created",
  "id": "sevt_01abc",
  "workflow_run_id": "wrun_01J8XkN5uT3vHpLqRfWdY2",
  "name": "Find change-of-control clauses",
  "description": "Reads each contract and lists those that have the clause.",
  "phases": [
    {"id": "wrph_01Kd3a1f3", "name": "Read the contracts", "description": "Reads each contract for the clause."},
    {"id": "wrph_01Kd3b7c9", "name": "Reconcile the findings", "description": null}
  ]
}

У phase_started и phase_ended есть workflow_run_phase_id и нет имени. Имя ищите в created.phases. phase_ended стыкуется со стартом через phase_started_id и не говорит, закончилась ли работа. Страница пишет: по одной фазе, в порядке phases, каждая не больше одного раза — и что API этого не гарантирует. Нужно принять несколько открытых фаз, фазу вне списка и фазу из списка, которая так и не началась. Каждая начавшаяся фаза заканчивается до status_ended.

completed — это не «получилось»

workflow_run.status_ended всегда последнее workflow_run.* этого запуска и содержит result. Запуск открыт от created до этого события, в работе или в idle.

resultСмысл
type completedПрограмма дошла до конца. Не каждая часть. Поток может упасть или не создаться.
type stoppedАгент остановил запуск, или сессию архивировали. Событие не говорит, что именно.
error timeout_errorСрок вышел: 24 часа или более короткий, который задал агент.
error program_errorКод упал, нарушено правило, или поток упал и программа позволила этому закончить запуск.
error thread_limit_errorСлишком много агентов для одного workflow.
error unknown_errorСервер не смог продолжить, или другой серверный предел.

Ошибка выглядит как {"type":"error","error":{"type":"timeout_error","message":"..."}}. message можно писать в лог. Незнакомый result.type — запуск закончился иначе. Незнакомый error.type — ошибка.

workflow_run.error приходит до status_ended и не является концом. workflow_run_id равный null значит, что запуск не создан. Иначе следите до status_ended. Сбой модели, MCP, учётных данных или оплаты сначала виден как session.error и сам по себе запуск не кончает. Если программа позволяет этому сбою закончить запуск, он кончается program_error.

Потоки не называют свою фазу

Каждый агент работает в своём потоке сессии. session.thread_created несёт workflow_run_id. У других потоков поле null. Никакое поле не говорит фазу, и agent_name может повторяться. Прогресс — по событиям фаз, потоки — по session_thread_id.

У агента из predefined_agents на потоке есть id и version. У inline type равен inline, этих полей нет. Он использует модель агента сессии. Инструменты, MCP и skills — подмножество; страница говорит «все» и тут же, что API этого не гарантирует. Потоки делят песочницу, но не историю разговора.

Пока запуск открыт, поток нельзя остановить по id и нельзя архивировать. Останавливать должен агент, весь запуск. Вызов инструмента может прийти, пока сессия остаётся running. Не ждите session.status_idle. Отвечайте, как только evaluated_permission станет ask.

Четыре JSON, которые стоит сверить заранее

  1. multiagent. Тип multiagent_20261001, workflows.type равен enabled. Только workflow: subagents явно disabled.
  2. Один workflow_run.created. phases есть, id начинаются с wrph_. Пустой массив законен. Имена не кладите в allowlist.
  3. Один status_ended. Сначала result.type. После completed всё равно читайте события каждого потока.
  4. Пара начала и конца фазы. Стыкуйте через phase_started_id. Имя ищите в phases события created.

Сверять события локальными инструментами

Перед включением беты откройте три текста: блок multiagent, один workflow_run.created и один workflow_run.status_ended.

  • Валидатор JSON — каждое событие является допустимым JSON, и вы узнаёте result.type.
  • JSONPath — $.phases[*].id против workflow_run_phase_id.
  • JSON Diff — список фаз против поздних событий, чтобы увидеть id вне списка.

Ничего не покидает браузер. Прочитайте события плоско, потом пускайте агента писать. Успех — не только result.type == completed.

Вопросы

Это общедоступно, и можно ли обойтись без beta-заголовка?

На 12 октября 2026 это всё ещё бета. Запросу нужен managed-agents-2026-04-01. Тип multiagent — multiagent_20261001, workflows — enabled.

Если result.type равен completed, каждая часть удалась?

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

Можно остановиться на workflow_run.error?

Нет. Оно приходит до status_ended и не является концом. workflow_run_id null: запуск не создан. Иначе ждите status_ended.

Почему в phase_started нет имени фазы?

Имя есть только в phases у workflow_run.created. Ищите по workflow_run_phase_id. phase_ended стыкует начало через phase_started_id.

Можно отправить событие, которое остановит один поток?

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

Это тот же JSON, что MCP tools/list?

Нет. tools/list — обнаружение инструментов. Этот контракт — события workflow_run. Инструменты inline-агента — подмножество, а не второй tools/list.

Итог

Динамические workflow превращают сотни документов в фоновую программу. Прогресс по-прежнему JSON-события. Бета от 9 октября включается через multiagent_20261001. created перечисляет фазы. status_ended — конец. completed не значит, что каждый поток удался. Событие error ждёт более позднего конца. Имён фаз на событиях фаз нет.

Сначала локально разверните multiagent, created и status_ended, потом пускайте агента писать. Успех не должен сжаться до одного completed.