Динамические 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, которые стоит сверить заранее
- multiagent. Тип
multiagent_20261001,workflows.typeравенenabled. Только workflow:subagentsявноdisabled. - Один workflow_run.created.
phasesесть, id начинаются сwrph_. Пустой массив законен. Имена не кладите в allowlist. - Один status_ended. Сначала
result.type. Послеcompletedвсё равно читайте события каждого потока. - Пара начала и конца фазы. Стыкуйте через
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.