Pasos
Los cuatro tipos de paso y cómo cada uno usa lo que vino antes.
Los pasos se ejecutan de arriba abajo. Añádelos, quítalos y reordénalos en el editor, y ponle a cada uno un nombre opcional para que el historial de ejecuciones se lea con sentido.
Pasar resultados adelante
Un paso puede usar lo que produjo un paso anterior, mediante una referencia:
{{run.input}}: la entrada con la que arrancó esta ejecución{{trigger.summary}}: un campo del disparador{{steps.summarise.output}}: lo que produjo el paso llamadosummarise
Escribe / en cualquier campo para insertar una en lugar de teclearla. Equivocarse con el id de un paso es una causa habitual de resultado vacío.
Ejecutar una vez por elemento
Si apuntas la entrada de un paso a un paso cuya salida es una lista, se ejecuta una vez por elemento, con {{item}} disponible dentro.
Diez competidores resumidos individualmente en lugar de en un bloque, o todos los archivos de una carpeta de Drive procesados uno tras otro.
Luego eliges qué pasa cuando falla un elemento:
- Detener la ejecución: para todo. Correcto cuando los elementos son partes de un mismo entregable.
- Continuar con los demás elementos: se salta el malo y sigue. Correcto cuando son independientes, y la ejecución acaba como Completado con problemas para que lo sepas.
Pasos de agente
Ejecuta un agente. Dos formas de especificarlo:
Definir aquí. Escribe instrucciones y elige herramientas solo para este paso. Bueno cuando el trabajo es específico de este flujo y no existe como agente.
Usar un agente existente. Apunta a uno de tus agentes y fija una revisión, para que las ediciones posteriores de ese agente no cambien este flujo sin avisar. El acceso se vuelve a comprobar cuando el flujo se ejecuta, así que si pierdes el acceso al agente el paso falla en lugar de ejecutarse con permisos rancios.
Prefiere un agente existente cuando el mismo trabajo también se hace a mano en el chat. Una definición, mantenida una sola vez.
También puedes fijar el modelo, la temperatura y las colecciones fijadas para el paso.
Pasos de aprobación
Pausa la ejecución hasta que una persona decida. La ejecución se queda en Esperando aprobación hasta que alguien apruebe o rechace, y el rechazo termina la ejecución.
Aprobadores: nombra a personas concretas, o déjalo vacío para el propietario y los editores.
Mensaje: di qué quieres que miren. "Comprueba las cifras contra el panel antes de que esto vaya al cliente" es un mensaje útil. "Por favor, aprueba" no lo es.
Pon uno antes de cualquier cosa que salga de la empresa: un correo a clientes, un archivo escrito en una unidad compartida, una publicación en un canal.
Pasos de condición
Comprueba algo y decide si seguir.
Origen: qué comprobar, normalmente una referencia como {{steps.research.output}}.
Tipo de comprobación, uno de dos:
Regla compara de forma mecánica: no está vacío, está vacío, contiene, no contiene, es igual a, mayor que, menor que. Predecible y gratis. Úsalo siempre que la pregunta sea mecánica.
Preguntar al modelo plantea la pregunta en lenguaje llano: "¿Esto indica una anomalía?". Úsalo solo cuando el juicio requiera de verdad comprensión lectora, ya que cuesta una llamada al modelo y puede responder distinto ante dos entradas parecidas.
Si la comprobación falla, salta a un paso posterior o al final del flujo. Los pasos omitidos se marcan como omitidos en la ejecución, así que una semana tranquila se lee como "nada que reportar" y no como un fallo.
La condición más común y más útil es simplemente No está vacío sobre un paso de investigación, para que el flujo no haga nada en lugar de mandar un resumen vacío.
Pasos de acción
Hace una cosa concreta: envía un correo, crea un archivo, llama a una herramienta de un servicio conectado.
Elige la herramienta y luego rellena lo que necesita. Cualquier campo admite una referencia, así que el cuerpo de un correo puede ser {{steps.writeup.output}}.
Modifica datos es una insignia en las herramientas que hacen algo en el mundo en lugar de solo leer. Trata todas ellas como si necesitasen un paso de aprobación delante, salvo que estés seguro.
Igual que los pasos de agente, una acción puede ejecutarse una vez por elemento de una lista.
Los pasos de acción que tocan un servicio conectado llevan un aviso, y merece la pena leerlo entero. Un paso así:
- actúa como la cuenta conectada del propietario del flujo de trabajo, no como quien o lo que arrancó la ejecución
- sigue adelante sin preguntar, porque no hay nadie ahí. Solo el flujo guardado decide qué ocurre
- no se reintenta si la ejecución se interrumpe, porque puede que ya haya ocurrido. Un correo enviado a medias no se puede desenviar volviéndolo a intentar
Ese último punto es el que se le escapa a la gente: una ejecución interrumpida no reanuda una acción de forma segura, así que el flujo te lo dice en lugar de adivinar.
Si una herramienta deja de estar disponible (un conector apagado, un servidor MCP eliminado), el paso te lo dice y eliges otra. No se queda sin hacer nada en silencio.
Validar antes de guardar
El editor revisa tus pasos y señala los campos que faltan o están mal formados en el paso concreto. Un flujo de trabajo con errores no se guarda, y es a propósito: un flujo roto que se guarda es un flujo roto que se ejecuta a las 9 de la mañana del lunes.