Los workflows dinámicos retiran «esperar a que el modelo termine y luego analizar». El contrato de progreso sigue siendo un flujo de eventos JSON. El 9 de octubre de 2026, Claude Managed Agents abrió los workflows dinámicos en beta, con la cabecera managed-agents-2026-04-01. El agente escribe un programa. El servidor lo ejecuta en segundo plano como un workflow run. Lo que sigues no es la frase final, sino workflow_run.* en el flujo de eventos de la sesión.
Este texto está escrito para el 12 de octubre de 2026, según la nota de versión y la página Workflow runs. Ya cubrimos la Agents API y JSON Schema y MCP, Skills, Tools y Subagents. Aquí solo importa qué JSON cuenta como el fin de una ejecución y cuál no debe tomarse por éxito.
Qué se abrió el 9 de octubre
El interruptor está en el bloque multiagent. Con el tipo multiagent_20261001, subagents y workflows están activos por defecto. Solo workflows: subagents en disabled. Los agentes ya creados van en workflows.predefined_agents. Los que escribe el propio workflow son agentes inline.
{
"type": "multiagent_20261001",
"workflows": { "type": "enabled" }
}
Una ejecución tiene tres capas: el workflow run en segundo plano (puede haber varias abiertas), fases con nombres que escribe el modelo, e hilos de agente. El programa puede arrancar varios a la vez, pasar un resultado al siguiente y repetir dentro de una fase. Solo el agente inicia una ejecución. Ningún evento que envíes la termina. Archivar la sesión sí puede.
Los eventos van por el flujo de la sesión y también aparecen al listarlos. No disparan webhooks. La vida por defecto es de 24 horas; el agente puede acortarla. Esperar a tu cliente y las pausas cuentan. Una ejecución en pausa puede acabar con timeout_error.
created es la lista de fases
workflow_run.created lleva workflow_run_id (wrun_), name, description y phases. Cada fase tiene id (wrph_), name y description. Sin descripción, el campo es null. phases siempre está y puede ir vacío. Los nombres los escribe el modelo o el servidor. No son un enum estable.
{
"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 y phase_ended llevan workflow_run_phase_id y ningún nombre. El nombre se busca en created.phases. phase_ended casa el inicio con phase_started_id y no dice si el trabajo terminó. La página dice una fase cada vez, en el orden de phases, cada una como mucho una vez, y también que la API no lo garantiza. Hay que aceptar varias fases abiertas, una fase fuera de la lista y una fase listada que nunca arranca. Toda fase que empieza también termina, antes de status_ended.
completed no es «salió bien»
workflow_run.status_ended es siempre el último workflow_run.* de esa ejecución e incluye result. La ejecución está abierta desde created hasta ahí, en marcha o en idle.
| result | Significado |
|---|---|
| type completed | El programa terminó. No cada pieza. Un hilo puede fallar o no crearse. |
| type stopped | El agente paró la ejecución, o la sesión se archivó. El evento no dice cuál. |
| error timeout_error | Se acabó la vida: 24 horas, o la más corta que fijó el agente. |
| error program_error | Falló el código, se rompió una regla, o un hilo falla y el programa deja que eso acabe la ejecución. |
| error thread_limit_error | Demasiados agentes para un workflow. |
| error unknown_error | El servidor no pudo seguir, u otro límite del servidor. |
Un error tiene la forma {"type":"error","error":{"type":"timeout_error","message":"..."}}. message se puede registrar. Un result.type desconocido: la ejecución acabó de otra forma. Un error.type desconocido: un error.
workflow_run.error llega antes de status_ended y no es el fin. workflow_run_id a null significa que no se creó ninguna ejecución. Si no, hay que seguir hasta status_ended. Un fallo de modelo, MCP, credenciales o facturación aparece primero como session.error y no acaba la ejecución por sí solo. Si el programa deja que ese fallo la acabe, termina con program_error.
Los hilos no nombran su fase
Cada agente trabaja en su hilo de sesión. session.thread_created lleva el workflow_run_id. Los demás hilos ponen el campo a null. Ningún campo dice la fase, y agent_name puede repetirse. El progreso va por eventos de fase; los hilos, por session_thread_id.
Un agente de predefined_agents tiene id y version en el hilo. Uno inline tiene type inline y no esos campos. Usa el modelo del agente de la sesión. Herramientas, MCP y skills son un subconjunto; la página dice que recibe todos y también que la API no lo garantiza. Los hilos comparten el sandbox, no el historial.
No se puede parar un hilo por id ni archivarlo mientras la ejecución está abierta. El agente tiene que parar toda la ejecución. Con ejecuciones abiertas, una llamada de herramienta puede llegar con la sesión en running. No esperes a session.status_idle. Responde en cuanto evaluated_permission sea ask.
Cuatro JSON que hay que revisar antes
- multiagent. Tipo
multiagent_20261001yworkflows.typeenenabled. Solo workflows:subagentsendisabledde forma explícita. - Un workflow_run.created.
phasesestá, los ids empiezan porwrph_. Un array vacío es válido. No pongas los nombres en una lista blanca. - Un status_ended. Lee primero
result.type. Después decompleted, lee aún los eventos de cada hilo. - El par inicio y fin de fase. Únelos con
phase_started_id. Busca el nombre en lasphasesde created.
Cruzar eventos con herramientas locales
Antes de activar la beta, abre tres textos: el bloque multiagent, un workflow_run.created y un workflow_run.status_ended.
- Validador JSON — si cada evento es JSON válido y si reconoces
result.type. - JSONPath —
$.phases[*].idfrente aworkflow_run_phase_id. - JSON Diff — la lista de fases contra los eventos posteriores, para ver ids que no estaban.
Nada sale del navegador. Lee los eventos en plano y luego deja que el agente escriba. El éxito no es solo result.type == completed.
FAQ
¿Está disponible para todos y se puede omitir la cabecera beta?
A 12 de octubre de 2026 sigue en beta. La petición necesita managed-agents-2026-04-01. Tipo multiagent multiagent_20261001 y workflows en enabled.
Si result.type es completed, ¿cada pieza tuvo éxito?
No. completed significa que el programa terminó. Un hilo puede fallar o no crearse. Los fallos están en los eventos de cada hilo.
¿Puedo parar cuando llega workflow_run.error?
No. Llega antes de status_ended y no es el fin. workflow_run_id null: no se creó ninguna ejecución. Si no, espera status_ended.
¿Por qué phase_started no trae el nombre de la fase?
El nombre solo está en phases de workflow_run.created. Se busca por workflow_run_phase_id. phase_ended casa el inicio con phase_started_id.
¿Puedo enviar un evento que pare un hilo?
No. Con la ejecución abierta no se para un hilo por id ni se archiva. El agente tiene que parar toda la ejecución. Ningún evento que envíes la termina. Archivar la sesión sí puede.
¿Es el mismo JSON que un tools/list de MCP?
No. tools/list es el descubrimiento de herramientas. Este contrato son los eventos workflow_run. Las herramientas de un agente inline son un subconjunto, no un segundo tools/list.
Resumen
Los workflows dinámicos convierten cientos de documentos en un programa en segundo plano. El progreso sigue siendo eventos JSON. La beta del 9 de octubre se abre con multiagent_20261001. created lista las fases. status_ended es el fin. completed no significa que cada hilo tuviera éxito. Un evento error espera el fin posterior. Los nombres de fase no van en los eventos de fase.
Deja planos multiagent, created y status_ended en local antes de dejar que el agente escriba. El éxito no debe reducirse a un solo completed.