Les workflows dynamiques retirent « attendre la fin du modèle, puis analyser ». Le contrat de progression reste un flux d’événements JSON. Le 9 octobre 2026, Claude Managed Agents a ouvert les workflows dynamiques en bêta, avec l’en-tête managed-agents-2026-04-01. L’agent écrit un programme. Le serveur l’exécute en arrière-plan comme un workflow run. Ce que vous suivez n’est pas la phrase finale, mais workflow_run.* sur le flux d’événements de la session.
Ce texte est écrit pour le 12 octobre 2026, d’après la note de version et la page Workflow runs. Nous couvrons déjà l’Agents API et JSON Schema et MCP, Skills, Tools et Subagents. Ici, seule question : quel JSON compte comme la fin d’un run, et lequel ne doit pas être pris pour un succès.
Ce qui s’est ouvert le 9 octobre
L’interrupteur est dans le bloc multiagent. Avec le type multiagent_20261001, subagents et workflows sont actifs par défaut. Workflows seuls : subagents à disabled. Les agents déjà créés vont dans workflows.predefined_agents. Ceux que le workflow écrit sont des agents inline.
{
"type": "multiagent_20261001",
"workflows": { "type": "enabled" }
}
Un run a trois couches : le workflow run en arrière-plan (plusieurs peuvent être ouverts), des phases dont le modèle écrit les noms, et des threads d’agents. Le programme peut lancer plusieurs agents à la fois, transmettre un résultat, et répéter dans une phase. Seul l’agent démarre un run. Aucun événement que vous envoyez ne le termine. Archiver la session le peut.
Les événements passent par le flux de session et reviennent aussi dans la liste. Ils ne déclenchent pas de webhooks. Durée de vie 24 heures par défaut, plus courte si l’agent le décide. L’attente de votre client et les pauses comptent. Un run en pause peut finir en timeout_error.
created est la liste des phases
workflow_run.created porte workflow_run_id (wrun_), name, description et phases. Chaque phase a id (wrph_), name et description. Sans description, le champ vaut null. phases est toujours présent et peut être vide. Les noms viennent du modèle ou du serveur. Ce n’est pas une énumération stable.
{
"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 et phase_ended ont workflow_run_phase_id et pas de nom. Le nom se retrouve dans created.phases. phase_ended rejoint le début via phase_started_id et ne dit pas si le travail est fini. La page dit : une phase à la fois, dans l’ordre de phases, chacune au plus une fois — et l’API ne le garantit pas. Il faut accepter plusieurs phases ouvertes, une phase hors liste, et une phase listée qui ne démarre jamais. Toute phase commencée se termine avant status_ended.
completed ne veut pas dire « réussi »
workflow_run.status_ended est toujours le dernier workflow_run.* du run et contient result. Le run est ouvert de created jusqu’à cet événement, qu’il tourne ou qu’il soit idle.
| result | Sens |
|---|---|
| type completed | Le programme a fini. Pas chaque pièce. Un thread peut échouer ou ne pas être créé. |
| type stopped | L’agent a arrêté le run, ou la session a été archivée. L’événement ne dit pas lequel. |
| error timeout_error | La durée de vie est atteinte : 24 heures, ou celle plus courte fixée par l’agent. |
| error program_error | Le code a échoué, une règle a été rompue, ou un thread échoue et le programme laisse cela finir le run. |
| error thread_limit_error | Trop d’agents lancés par un workflow. |
| error unknown_error | Le serveur n’a pas pu continuer, ou une autre limite serveur. |
Une erreur ressemble à {"type":"error","error":{"type":"timeout_error","message":"..."}}. message peut aller dans les logs. Un result.type inconnu : le run s’est terminé autrement. Un error.type inconnu : une erreur.
workflow_run.error arrive avant status_ended et n’est pas la fin. workflow_run_id à null : aucun run n’a été créé. Sinon, suivre jusqu’à status_ended. Un échec de modèle, MCP, identifiants ou facturation apparaît d’abord comme session.error et ne termine pas le run seul. Si le programme laisse cet échec terminer le run, celui-ci finit en program_error.
Les threads ne nomment pas leur phase
Chaque agent travaille dans son thread de session. session.thread_created porte le workflow_run_id. Les autres threads mettent le champ à null. Aucun champ ne dit la phase, et agent_name peut se répéter. Le progrès se lit sur les événements de phase, les threads se distinguent par session_thread_id.
Un agent de predefined_agents a id et version sur le thread. Un agent inline a type inline et pas ces champs. Il utilise le modèle de l’agent de session. Outils, MCP et skills sont un sous-ensemble ; la page dit « tous », et aussi que l’API ne le garantit pas. Les threads partagent le bac à sable, pas l’historique.
On ne peut pas arrêter un thread par son id ni l’archiver tant que le run est ouvert. L’agent doit arrêter tout le run. Un appel d’outil peut arriver pendant que la session reste running. N’attendez pas session.status_idle. Répondez tout de suite si evaluated_permission vaut ask.
Quatre JSON à vérifier d’abord
- multiagent. Type
multiagent_20261001,workflows.typeàenabled. Workflows seuls :subagentsexplicitementdisabled. - Un workflow_run.created.
phasesest présent, les ids commencent parwrph_. Un tableau vide est valide. Ne mettez pas les noms sur une liste blanche. - Un status_ended. Lire d’abord
result.type. Aprèscompleted, lire encore les événements de chaque thread. - Le couple début et fin de phase. Les relier par
phase_started_id. Chercher le nom dans lesphasesde created.
Rapprocher les événements en local
Avant d’activer la bêta, ouvrez trois textes : le bloc multiagent, un workflow_run.created et un workflow_run.status_ended.
- Validateur JSON — chaque événement est-il du JSON valide, et
result.typeest-il connu. - JSONPath —
$.phases[*].idface àworkflow_run_phase_id. - JSON Diff — la liste des phases contre les événements reçus ensuite, pour voir les ids hors liste.
Rien ne quitte le navigateur. Lisez les événements à plat, puis laissez l’agent écrire. Le succès n’est pas seulement result.type == completed.
FAQ
Est-ce disponible pour tous, et peut-on omettre l’en-tête bêta ?
Au 12 octobre 2026, c’est encore une bêta. La requête exige managed-agents-2026-04-01. Type multiagent multiagent_20261001, workflows à enabled.
Si result.type vaut completed, chaque pièce a-t-elle réussi ?
Non. completed veut dire que le programme a fini. Un thread peut échouer ou ne pas être créé. Les échecs sont dans les événements du thread.
Puis-je m’arrêter à workflow_run.error ?
Non. Il arrive avant status_ended et n’est pas la fin. workflow_run_id null : aucun run créé. Sinon, attendre status_ended.
Pourquoi phase_started n’a-t-il pas le nom de la phase ?
Le nom n’est que dans phases de workflow_run.created. On le retrouve par workflow_run_phase_id. phase_ended rejoint le début par phase_started_id.
Puis-je envoyer un événement qui arrête un thread ?
Non. Tant que le run est ouvert, pas d’arrêt par id de thread, ni d’archivage. L’agent doit arrêter tout le run. Aucun événement que vous envoyez ne termine un run. Archiver la session le peut.
Est-ce le même JSON qu’un tools/list MCP ?
Non. tools/list est la découverte d’outils. Ce contrat, ce sont les événements workflow_run. Les outils d’un agent inline sont un sous-ensemble, pas un second tools/list.
Résumé
Les workflows dynamiques transforment des centaines de documents en programme d’arrière-plan. La progression reste des événements JSON. La bêta du 9 octobre s’ouvre avec multiagent_20261001. created liste les phases. status_ended est la fin. completed ne veut pas dire que chaque thread a réussi. Un événement error attend la fin suivante. Les noms de phase ne sont pas sur les événements de phase.
Aplatissez multiagent, created et status_ended en local avant de laisser l’agent écrire. Le succès ne doit pas se réduire à un seul completed.