Nach Claude Dynamic Workflows: Warum ist der Fortschritt immer noch JSON? Von multiagent_20261001 zu workflow_run.status_ended

Stand 12. Oktober 2026: Die Beta vom 9. Oktober lässt einen Managed Agent einen Workflow schreiben. Der Fortschritt ist nicht der letzte Satz, sondern workflow_run-Events. completed heißt, das Programm ist durch, nicht dass jeder Thread gelang.

Dynamische Workflows nehmen das „warten, bis das Modell fertig ist, dann parsen“ weg. Der Fortschrittsvertrag bleibt ein Strom von JSON-Ereignissen. Am 9. Oktober 2026 hat Claude Managed Agents dynamische Workflows als Beta geöffnet, mit dem Header managed-agents-2026-04-01. Der Agent schreibt ein Programm. Der Server führt es im Hintergrund als Workflow-Run aus. Was du verfolgst, ist nicht der letzte Satz, sondern workflow_run.* auf dem Session-Event-Stream.

Dieser Text steht auf dem 12. Oktober 2026, nach Release Note und der Seite Workflow runs. Wir haben schon die Agents API und JSON Schema und MCP, Skills, Tools und Subagents. Hier geht es nur darum, welches JSON das Ende eines Runs ist und welches nicht als Erfolg gelten darf.

Was am 9. Oktober aufging

Der Schalter sitzt im multiagent-Block. Mit Typ multiagent_20261001 sind subagents und workflows standardmäßig an. Nur Workflows: subagents auf disabled. Fertige Agenten stehen in workflows.predefined_agents. Agenten, die der Workflow selbst schreibt, sind Inline-Agenten.

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

Ein Run hat drei Schichten: der Workflow-Run im Hintergrund (mehrere können offen sein), Phasen mit Namen, die das Modell schreibt, und Agent-Threads. Das Programm kann viele Agenten zugleich starten, Ergebnisse weiterreichen und innerhalb einer Phase wiederholen. Nur der Agent startet einen Run. Kein Event, das du sendest, beendet ihn. Archivieren der Session kann es.

Die Events laufen über den Session-Stream und erscheinen auch in der Event-Liste. Sie lösen keine Webhooks aus. Lebensdauer standardmäßig 24 Stunden, kürzer setzt der Agent. Warten auf deinen Client und Pausen zählen mit. Ein pausierter Run kann mit timeout_error enden.

created ist die Phasenliste

workflow_run.created trägt workflow_run_id (wrun_), name, description und phases. Jede Phase hat id (wrph_), name und description. Ohne Beschreibung ist das Feld null. phases ist immer da und kann leer sein. Die Namen schreibt das Modell oder der Server. Sie sind keine stabile Aufzählung.

{
  "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 und phase_ended haben workflow_run_phase_id und keinen Namen. Den Namen suchst du in created.phases. phase_ended trifft den Start über phase_started_id und sagt nicht, ob die Arbeit fertig wurde. Die Seite sagt: eine Phase nach der anderen, in der Reihenfolge von phases, jede höchstens einmal — und die API garantiert das nicht. Mehrere offene Phasen, eine Phase außerhalb der Liste und eine gelistete Phase, die nie startet, musst du aushalten. Jede gestartete Phase endet vor status_ended.

completed heißt nicht „bestanden“

workflow_run.status_ended ist immer das letzte workflow_run.* dieses Runs und enthält result. Offen ist der Run von created bis dahin, laufend oder idle.

resultBedeutung
type completedDas Programm ist durch. Nicht jedes Stück hat bestanden. Ein Thread kann scheitern oder gar nicht entstehen.
type stoppedDer Agent hat gestoppt, oder die Session wurde archiviert. Das Event sagt nicht, welches.
error timeout_errorDie Lebensdauer ist um: 24 Stunden oder die kürzere Frist des Agenten.
error program_errorCodefehler, Regelbruch, oder ein Thread scheitert und das Programm lässt das den Run beenden.
error thread_limit_errorZu viele Agenten für einen Workflow.
error unknown_errorDer Server konnte nicht weiter, oder ein anderes Serverlimit.

Ein Fehler sieht aus wie {"type":"error","error":{"type":"timeout_error","message":"..."}}. message darf ins Log. Unbekanntes result.type: der Run endete anders. Unbekanntes error.type: ein Fehler.

workflow_run.error kommt vor status_ended und ist nicht das Ende. workflow_run_id null heißt: kein Run entstand. Sonst weiterverfolgen bis status_ended. Modell-, MCP-, Credential- oder Abrechnungsfehler erscheinen zuerst als session.error auf dem Thread und beenden den Run nicht allein. Lässt das Programm den fehlgeschlagenen Thread den Run beenden, endet er mit program_error.

Threads nennen ihre Phase nicht

Jeder Agent arbeitet in einem eigenen Session-Thread. session.thread_created trägt die workflow_run_id. Andere Threads setzen das Feld auf null. Kein Feld sagt, in welcher Phase der Thread arbeitet, und agent_name kann sich wiederholen. Fortschritt über Phasen-Events, Threads über session_thread_id.

Ein Agent aus predefined_agents hat auf dem Thread id und version. Ein Inline-Agent hat type inline und diese Felder nicht. Er nutzt das Modell des Session-Agenten. Tools, MCP und Skills sind eine Teilmenge; die Seite sagt „alle“, und sie sagt auch, die API garantiere das nicht. Threads teilen die Sandbox, die Gesprächshistorie nicht.

Einen Thread per ID stoppen oder archivieren, solange der Run offen ist, geht nicht. Der Agent muss den ganzen Run stoppen. Bei offenen Runs kann ein Tool-Call kommen, während die Session running bleibt. Nicht auf session.status_idle warten. evaluated_permission ask sofort beantworten.

Vier JSON-Dokumente vorher prüfen

  1. multiagent. Typ multiagent_20261001, workflows.type ist enabled. Nur Workflows: subagents explizit disabled.
  2. Ein workflow_run.created. phases ist da, Ids beginnen mit wrph_. Ein leeres Array ist gültig. Namen nicht auf eine Allowlist setzen.
  3. Ein status_ended. Zuerst result.type. Nach completed noch die Thread-Events lesen.
  4. Start und Ende einer Phase. Über phase_started_id paaren. Den Namen in created phases nachschlagen.

Ereignisse lokal abgleichen

Vor dem Beta-Schalter drei Texte öffnen: den multiagent-Block, ein workflow_run.created und ein workflow_run.status_ended.

  • JSON-Validator — ob jedes Event gültiges JSON ist und result.type bekannt ist.
  • JSONPath — $.phases[*].id gegen workflow_run_phase_id.
  • JSON Diff — Phasenliste gegen später empfangene Phase-Events, Ids außerhalb der Liste suchen.

Nichts verlässt den Browser. Events flach lesen, dann den Agenten schreiben lassen. Erfolg ist nicht nur result.type == completed.

FAQ

Ist das allgemein verfügbar, und kann der Beta-Header weg?

Stand 12. Oktober 2026 ist es Beta. Der Request braucht managed-agents-2026-04-01. multiagent-Typ multiagent_20261001, workflows auf enabled.

Heißt result.type completed, dass jedes Stück gelang?

Nein. completed heißt, das Programm ist durch. Ein Thread kann scheitern oder nicht entstehen. Fehlschläge stehen in den Events des Threads.

Kann ich bei workflow_run.error aufhören?

Nein. Es kommt vor status_ended und ist nicht das Ende. workflow_run_id null heißt: kein Run entstand. Sonst auf status_ended warten.

Warum hat phase_started keinen Phasennamen?

Der Name steht nur in phases von workflow_run.created. Nachschlagen über workflow_run_phase_id. phase_ended trifft den Start über phase_started_id.

Kann ich ein Event senden, das einen Thread stoppt?

Nein. Solange der Run offen ist, nicht per Thread-ID stoppen und nicht archivieren. Der Agent muss den ganzen Run stoppen. Kein Event von dir beendet einen Run. Archivieren der Session kann es.

Ist das dasselbe JSON wie ein MCP-tools/list?

Nein. tools/list ist Tool-Discovery. Dieser Vertrag sind workflow_run-Events. Die Tools eines Inline-Agenten sind eine Teilmenge, keine zweite tools/list.

Fazit

Dynamische Workflows machen aus vielen Dokumenten ein Hintergrundprogramm. Der Fortschritt bleibt JSON-Events. Die Beta vom 9. Oktober schaltet sie mit multiagent_20261001 ein. created listet die Phasen. status_ended ist das Ende. completed heißt nicht, jeder Thread gelang. Ein error-Event wartet auf das spätere Ende. Phasennamen stehen nicht auf den Phase-Events.

multiagent, created und status_ended lokal flach lesen, bevor der Agent einen Workflow schreibt. Erfolg darf nicht auf ein einzelnes completed schrumpfen.