Claude の動的ワークフローのあと、進捗がまだ JSON な理由:multiagent_20261001 から workflow_run.status_ended へ

2026年10月12日時点:10月9日のベータは Managed Agent にワークフローを書かせる。進捗は最後の文ではなく workflow_run イベント。completed はプログラムが走り切ったという意味で、各スレッドの成功ではない。

動的ワークフローが引き取るのは「モデルが言い終わるまで待ってから解析する」ことです。進捗の契約は、いまも 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

  1. multiagent。型は multiagent_20261001、workflows.type は enabled。ワークフローだけなら subagents を明示的に disabled。
  2. workflow_run.created を 1 件。phases があり、id は wrph_ で始まる。空配列も合法。名前を許可リストにしない。
  3. status_ended を 1 件。先に result.type。completed のあとでも各スレッドのイベントを読む。
  4. 段階の開始と終了。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 に縮めないでください。