動的ワークフローが引き取るのは「モデルが言い終わるまで待ってから解析する」ことです。進捗の契約は、いまも JSON イベントの列です。2026 年 10 月 9 日、Claude Managed Agents は動的ワークフローをベータで開きました。ヘッダは managed-agents-2026-04-01 です。エージェントがプログラムを書き、サーバがバックグラウンドで workflow run として走らせます。追うのは最後の文ではなく、セッションイベント流の workflow_run.* です。
本稿は 2026 年 10 月 12 日時点。リリースノートと Workflow runs のページに拠ります。本サイトにはすでにAgents API と JSON SchemaとMCP、Skills、Tools、Subagentsがあります。ここでは、何百もの断片が分かれて走るとき、どの JSON が実行の終わりで、どれを成功にしてはいけないかだけを書きます。
10 月 9 日に開いたもの
スイッチはエージェント定義の multiagent にあります。型が multiagent_20261001 のとき、subagents と workflows は既定でオンです。ワークフローだけなら subagents を disabled にします。既存のエージェントは workflows.predefined_agents へ。ワークフローがその場で書くのは inline agent です。
{
"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 です。説明が無いと description は null です。phases は必ずあり、空配列でもよい。名前はモデルかサーバが書いた文章で、安定した列挙ではありません。
{
"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 を id で引きます。phase_ended は phase_started_id で開始イベントと対になり、その段階の仕事が終わったとは書きません。文書は一度に一つ、phases の順、各段階は多くて一度、と書き、同時に API はそれを保証しないとも書きます。同時に開く段階、名簿に無い段階、名簿にあって始まらない段階を受けてください。始まった段階は status_ended の前に終わります。
completed はできた、ではありません
workflow_run.status_ended は、その実行の workflow_run.* の最後で、result を含みます。実行は created からそこまで開いていて、running でも idle でもあります。
| result | 意味 |
|---|---|
| type が completed | プログラムが走り切った。各断片の成功ではない。スレッドは失敗しても、作れなくてもよい。 |
| type が stopped | エージェントが止めたか、セッションがアーカイブされた。イベントはどちらとも書かない。 |
| error.timeout_error | 寿命に達した。既定 24 時間、またはエージェントが短くした時間。 |
| error.program_error | コードの失敗、規則違反、またはスレッド失敗をプログラムが実行終了にした。 |
| error.thread_limit_error | 一つのワークフローが起動できるエージェント数を超えた。 |
| 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 に挙げたエージェントは、スレッドの agent に id と version があります。inline は type が inline で、その二つはありません。使うモデルはセッションエージェントのものです。ツール、MCP、スキルはその部分集合で、文書は全部渡ると書き、API は保証しないとも書きます。スレッドはサンドボックスのファイルを共有し、会話履歴は別です。
実行が開いているあいだ、スレッド ID で一つを止めたりアーカイブしたりはできません。止めるならエージェントに実行全体を止めさせます。実行が開いていると、セッションが running のままツール呼び出しが来ます。session.status_idle を待たないでください。evaluated_permission が ask の agent.tool_use か agent.mcp_tool_use が来たら答えます。
先に照合する 4 つの JSON
- multiagent。型は
multiagent_20261001、workflows.typeはenabled。ワークフローだけならsubagentsを明示的にdisabled。 - workflow_run.created を 1 件。
phasesがあり、id はwrph_で始まる。空配列も合法。名前を許可リストにしない。 - status_ended を 1 件。先に
result.type。completedのあとでも各スレッドのイベントを読む。 - 段階の開始と終了。
phase_started_idで対にする。名前は created のphasesから引く。名前が無いのは解析の壊れではありません。
ローカルの JSON ツールでイベントを合わせる
ベータを開く前に、ブラウザで三つ開きます。multiagent、一件の workflow_run.created、一件の workflow_run.status_ended です。
- JSON バリデーター — 各イベントが合法な JSON か、
result.typeを知っているか。 - JSONPath —
$.phases[*].idをworkflow_run_phase_idと照合する。 - JSON Diff — created の段階名簿と、あとから来た phase イベントを対照し、名簿外の id を見る。
データはブラウザを離れません。イベントを平らにしてから、エージェントにワークフローを書かせます。成功条件を result.type == completed だけにしないでください。
よくある質問
正式版ですか。ベータヘッダは要りますか?
2026 年 10 月 12 日時点ではベータです。リクエストに 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 に段階名が無いのはなぜですか?
名前は workflow_run.created の phases にだけあります。workflow_run_phase_id で引きます。phase_ended は phase_started_id で開始と対になります。
一つのスレッドを止めるイベントを送れますか?
送れません。実行が開いているあいだ、スレッド ID では止められず、アーカイブもできません。エージェントに実行全体を止めさせます。あなたが送るイベントでは実行は終わりません。セッションのアーカイブでは終わり得ます。
MCP の tools/list と同じ JSON ですか?
違います。tools/list はツールの発見です。この契約はセッション流の workflow_run イベントです。inline エージェントのツールはセッションエージェントの部分集合で、別の tools/list ではありません。
まとめ
動的ワークフローは何百もの文書をバックグラウンドのプログラムにします。進捗はいまも JSON イベントです。10 月 9 日のベータは multiagent_20261001 で開きます。created が段階名簿、status_ended が終わりです。completed は各スレッドの成功ではありません。error イベントのあとには終わりのイベントが来ます。段階名は phase イベントに無く、created に戻って引きます。
エージェントに書かせる前に、multiagent、created、status_ended をローカルで平らにしてください。成功条件を一つの completed に縮めないでください。