🧱Flujos de trabajo

Crear un flujo de trabajo

El constructor de flujos de trabajo es un lienzo visual de nodos. Añades nodos desde una biblioteca, los conectas, configuras cada uno en un inspector y publicas cuando está listo. Esta página recorre el ciclo completo de construcción.

🧱ConstruirAñadir y conectar nodos
💾Guardado automáticoBorrador guardado mientras trabajas
ValidarDetecta problemas a tiempo
🚀PublicarPonlo en marcha
El ciclo de construcción: diseña en el lienzo, valida, publica y luego itera

Las tres áreas del constructor

Abre cualquier flujo de trabajo desde la pestaña Flujos de trabajo para iniciar el constructor. Tiene tres áreas que funcionan conjuntamente:

  • Biblioteca de nodos: una barra lateral que lista todos los tipos de nodo, agrupados por categoría (disparadores, IA, flujo de control, acciones, terminal). Añade un nodo para colocarlo en el lienzo.
  • Lienzo: el espacio de trabajo desplazable y con zoom donde organizas los nodos y trazas las conexiones entre ellos.
  • Inspector: un panel lateral que se abre al seleccionar un nodo. Configura las entradas del nodo aquí, asigna datos de nodos anteriores e inserta contexto con referencias {{ }}. {{ }}
ℹ️
El primer nodo debe ser un disparador

Un flujo de trabajo siempre comienza con exactamente un disparador. En un lienzo vacío, la biblioteca solo ofrece disparadores; una vez que hay un disparador, todos los demás tipos de nodo quedan disponibles. Consulta Disparadores para conocer las seis opciones. Disparadores

Añadir nodos desde la biblioteca

La biblioteca de nodos agrupa todos los nodos disponibles por propósito para que encuentres el correcto rápidamente. Al añadir un nodo, se coloca en el lienzo con valores predeterminados sensatos; luego lo conectas y abres el inspector para configurarlo. Para el catálogo completo de lo que hace cada nodo, consulta la referencia de nodos.

Conectar nodos

Los nodos se conectan mediante conexiones: flechas que definen el orden de ejecución y pasan la salida de cada nodo a la entrada del siguiente. Arrastra desde el puerto de salida de un nodo al puerto de entrada de otro para crear una conexión. Un nodo solo se ejecuta cuando los nodos que lo alimentan han finalizado.

Algunos nodos tienen más de una ruta de salida. Un nodo Condición, por ejemplo, tiene salidas separadas "verdadero" y "falso", y muchos nodos exponen una rama de error que puedes conectar para manejar los fallos con elegancia en lugar de detener toda la ejecución.

💡
Pasa datos hacia adelante con {{ }}

En cualquier campo de texto del inspector, escribe {{ para insertar una referencia a la salida de un nodo anterior; por ejemplo {{ trigger.output.email }} o {{ agent1.output.summary }}. El selector lista los campos que declara cada nodo anterior, para que puedas conectar datos a través del flujo sin necesidad de una ejecución de prueba.

Guardado automático con rebote

No tienes que acordarte de guardar. Mientras editas, el constructor guarda automáticamente tus cambios como borrador tras un breve retardo, y un indicador de estado Guardando / Guardado muestra el estado actual. El borrador es independiente de la versión publicada en producción: editar nunca afecta lo que está en marcha hasta que publicas.

Guardar borrador vs Publicar

Un flujo de trabajo tiene dos estados: el borrador que estás editando y la versión publicada que realmente se ejecuta.

AcciónQué hace
Guardar borradorGuarda el trabajo en curso. Los borradores nunca activan disparadores ni afectan a la versión en producción: edita libremente sin consecuencias.
PublicarPromueve el borrador actual a la versión activa. Sus disparadores (URL de webhook, programa, formulario) se activan, y las nuevas ejecuciones usan esta versión.

Validación

Antes de publicar, el constructor valida el grafo y muestra los problemas encontrados: un nodo al que le falta configuración requerida, una conexión sin destino, un disparador en el lugar incorrecto o una referencia a un campo inexistente. Los problemas se marcan en el nodo afectado y en un resumen.

⚠️
Las advertencias pueden bloquear el guardado

Los problemas de validación tienen distintas gravedades. Las notas informativas son orientativas, pero las advertencias se tratan como bloqueantes: deben resolverse antes de poder guardar o publicar el flujo de trabajo. Corrige los nodos marcados y el bloqueo desaparece. El lienzo y el servidor comparten el mismo validador, así que lo que pasa en el constructor pasa en tiempo de ejecución.

Historial de versiones y reversión

Cada flujo de trabajo conserva un historial completo de versiones, para que puedas publicar con confianza sabiendo que siempre puedes volver atrás.

  1. Edita como borrador

    Tus cambios se guardan automáticamente como borrador mientras trabajas. Los borradores nunca afectan a la versión en producción, así que puedes experimentar con seguridad.

  2. Publica cuando esté listo

    Publicar registra una nueva versión y la convierte en la activa. Sus disparadores se activan de inmediato.

  3. Revisa el historial de versiones

    Cada publicación queda registrada. Navega por las versiones anteriores para ver cómo era el flujo de trabajo en cada momento.

  4. Revierte al instante

    Restaura cualquier versión anterior desde el historial. Las reversiones se aplican de inmediato: no es necesario volver a conectar nada a mano.

ℹ️
Siguiente: elige cómo comienza

Con los conceptos básicos del lienzo cubiertos, el siguiente paso es elegir un disparador: el evento que inicia tu flujo de trabajo. Continúa en Disparadores.