Tras los workflows dinámicos de Claude, ¿por qué el progreso sigue siendo JSON? De multiagent_20261001 a workflow_run.status_ended

A 12 de octubre de 2026: la beta del 9 de octubre deja que un Managed Agent escriba un workflow. El progreso no es la frase final, son los eventos workflow_run. completed significa que el programa terminó, no que cada hilo tuviera éxito.

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.

resultSignificado
type completedEl programa terminó. No cada pieza. Un hilo puede fallar o no crearse.
type stoppedEl agente paró la ejecución, o la sesión se archivó. El evento no dice cuál.
error timeout_errorSe acabó la vida: 24 horas, o la más corta que fijó el agente.
error program_errorFalló el código, se rompió una regla, o un hilo falla y el programa deja que eso acabe la ejecución.
error thread_limit_errorDemasiados agentes para un workflow.
error unknown_errorEl 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

  1. multiagent. Tipo multiagent_20261001 y workflows.type en enabled. Solo workflows: subagents en disabled de forma explícita.
  2. Un workflow_run.created. phases está, los ids empiezan por wrph_. Un array vacío es válido. No pongas los nombres en una lista blanca.
  3. Un status_ended. Lee primero result.type. Después de completed, lee aún los eventos de cada hilo.
  4. El par inicio y fin de fase. Únelos con phase_started_id. Busca el nombre en las phases de 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[*].id frente a workflow_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.