Inicio / Varios agentes y verificación adversa

Workflows deterministas: esquemas, checkpoints, reanudación

Un workflow es un script que encadena llamadas de agente de forma determinista: las mismas etapas y el mismo esquema de salida en cada ejecución. Un esquema JSON impone campos con nombre de una etapa a otra, y cada etapa terminada escribe un checkpoint, de modo que un workflow interrumpido se reanuda sin rehacerlo todo.

Un workflow, en el sentido de este módulo, es un script que encadena varias llamadas de agente de forma determinista: la misma secuencia de etapas y el mismo esquema de salida en cada ejecución, a diferencia de una conversación donde el agente decide solo el orden de sus acciones.

El esquema que reemplaza a un informe en lenguaje libre

Cuando un agente debe transmitir su resultado a la etapa siguiente, un esquema JSON impone campos con nombre y tipos precisos, en lugar de un párrafo que el agente siguiente tendría que releer e interpretar. Dos agentes que intercambian mediante un esquema común no se malentienden sobre la forma, lo que traslada la vigilancia a donde de verdad importa, el contenido.

El checkpoint que evita rehacerlo todo

Cada etapa terminada escribe un checkpoint. En el momento de reanudar un workflow interrumpido, una etapa marcada como terminada devuelve directamente su resultado guardado sin relanzar al agente que lo produjo. Una etapa cuyo prompt ha cambiado desde la última ejecución se relanza, y toda etapa colocada después de ella en la secuencia también, incluso si su propio prompt no se ha movido. Antes de la versión 2.1.305, los agentes terminados podían también volver a ejecutarse al relanzar un script sin modificar; la reanudación los sirve ahora desde el diario de la ejecución.

etapa : rédaction_synthèse
estado : terminado
prompt idéntico a la última ejecución : sí
modelo puesto en el script para esta etapa : ninguno

El modelo que un agente relanzado hereda realmente

Desde la versión 2.1.251, el modelo que se aplica a un agente relanzado sigue un orden de prioridad de cuatro niveles: el parámetro puesto directamente en la llamada de ese agente, el campo modelo del propio subagente, una variable de entorno propia del subagente, y luego, como último recurso, el modelo de la sesión que ejecuta el script en el momento en que lo relanza. Antes de esta versión, el orden difería en un punto que afecta a los scripts antiguos: la variable de entorno pasaba primero y prevalecía sobre el parámetro de la llamada así como sobre el campo modelo del frontmatter, incluso sobre el valor model: inherit. Desde octubre, la variable CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL hace funcionar todos los agentes de un workflow con un solo modelo sin tocar los demás subagentes; la línea del registro de cambios no dice dónde se sitúa en este orden, y la página de workflows no menciona la variable: solo el registro de cambios la documenta. Cuando ninguno de los niveles prioritarios está rellenado, un agente escrito bajo un modelo dado en una fecha determinada cambia silenciosamente al modelo de la sesión que lo relanza meses después, sin que ningún mensaje en pantalla lo señale. Este punto se une a la elección de arquitectura planteada en fan-out, pipeline, barrera: un pipeline guardado sigue siendo un pipeline, y cada una de sus etapas conserva su propio riesgo de herencia silenciosa de modelo.

Reabrir un script antiguo y verificar qué modelo se aplicará a cada agente lleva unos minutos, comparando también la versión de la herramienta en que se escribió con la instalada hoy.

Cuándo detener una etapa que falla

En un bucle de etapas, «el mismo error dos veces» se juzga sobre el conjunto de criterios rechazados en un intento, no sobre un identificador aislado. Un conjunto distinto abre un intento más, el mismo conjunto cierra la etapa, y dos etapas fallidas seguidas detienen el bucle. Una etapa fallida no detiene el proyecto: su trabajo queda en el repositorio y se retoma en un pequeño proyecto nuevo. En cada reanudación, relee el plan y añade una precisión antes del intento siguiente, y haz que los veredictos los escriba un script que compruebe que las claves igualan los criterios.