Lógica de un flujo

Un flujo sencillo va en línea recta: recibe algo, lo procesa y devuelve un resultado. Muchas automatizaciones necesitan más: elegir un camino según los datos, repetir unos pasos con cada elemento de una lista o aprovechar un flujo que ya tienes. Esta página explica cómo se hace cada cosa en NappAI.

Casi todo se puede resolver de dos maneras:

Con reglas fijas, cuando sabes exactamente qué condición mirar: “si el estado es pagado, haz esto”.
Con un agente, cuando la decisión depende del significado: “si el cliente está molesto, pásalo a una persona”.

Elegir un camino

Con reglas fijas

Componente	Cuándo usarlo
Switch	Repartir registros entre varios caminos según el valor de uno de sus campos. Defines varios casos, cada uno con su condición (es igual a, contiene, está vacío…), y cada caso tiene su propia salida.
Conditional Router	Comparar un texto con otro y seguir por True Route si se cumple la condición o por False Route si no.
Data Conditional Router	Separar registros según una condición sobre uno de sus campos.

Ejemplo: los pedidos con estado pagado van a facturación y los que están pendientes reciben un recordatorio.

Con un agente

Cuando la condición no se puede escribir como una regla, deja que un agente clasifique primero y usa después una regla fija con su respuesta:

Un Agent lee el mensaje y, siguiendo su System Prompt, responde solo con una categoría, por ejemplo Soporte, Ventas o Urgente.
Un Switch o un Conditional Router mira esa palabra y envía el flujo por el camino que corresponde.

Así la IA se ocupa de entender el mensaje y el resto del flujo sigue un camino claro y fácil de revisar.

Dejar que el agente decida qué hacer

Si conectas varias herramientas a un agente, no hace falta dibujar cada camino: el agente decide en cada conversación qué herramientas usar y en qué orden. Por ejemplo, ante “¿tengo hueco el jueves? Si es así, avisa a Marta”, puede consultar el calendario y después enviar el mensaje.

Ver Herramientas.

Repetir pasos con cada elemento de una lista

Muchas veces un paso devuelve una lista: los correos sin leer, las filas de una hoja de cálculo, los pedidos del día. Hay dos formas de tratar cada elemento:

Forma	Cómo funciona	Cuándo usarla
Batch Mode	Se activa en los ajustes del componente que recibe la lista. El componente procesa todos los elementos a la vez y devuelve una lista con todos los resultados.	Cuando cada elemento se trata por separado con un solo componente, por ejemplo resumir cada correo.
Loop y Loop End	Loop entrega los elementos de uno en uno a los pasos que conectes, y Loop End marca el final de esos pasos para pasar al siguiente.	Cuando hay que repetir varios pasos en orden con cada elemento, por ejemplo redactar y enviar un correo a cada contacto.

Ver Procesar listas.

Combinar información

Cuando la información llega de varios pasos y hay que juntarla:

Componente	Para qué
Prompt	Escribir un texto con huecos entre llaves, como `{cliente}` o `{pedido}`, que se rellenan con lo que llega de otros componentes. Es la forma habitual de preparar lo que se le pasa a un modelo.
Parse Data	Convertir registros en texto legible siguiendo una plantilla.
Combine Text	Unir dos textos con un separador.
Merge Data	Juntar registros de varias fuentes en una sola lista, uno detrás de otro o emparejados por un campo común.

Un agente también puede combinar información: si consulta dos herramientas, no te devuelve los dos resultados por separado, sino una sola respuesta redactada con ambos.

Reutilizar un flujo dentro de otro

Si tienes un flujo que hace bien una tarea, puedes usarlo dentro de otros en lugar de repetirlo:

Componente	Cómo se usa
Sub Project flow	Inserta otro flujo como un paso más: le pasa los datos de entrada y devuelve su resultado.
Project flow as Tool	Convierte otro flujo en una herramienta que un agente puede usar cuando la necesite.

Así los flujos principales quedan más cortos y cada tarea se mantiene en un solo sitio.

Cuando algo falla

Si un componente falla durante una ejecución, se marca en el lienzo con un triángulo rojo y el motivo queda guardado en la ejecución. Para encontrarlo:

En el playground, mira en Ejecuciones qué recibió y qué devolvió cada paso.
Fuera del editor, busca la ejecución en Reg. de Ejecuciones y ábrela para ver el detalle.

Ver Lo que indica cada componente y Registro de ejecuciones.