Nodo If - Biforcazione Condizionale in ConvyAI Agentic Flow

Overview

Il nodo If valuta una condizione logica - semplice o composta - e instrada il flusso su una delle due uscite esclusive: true se la condizione è soddisfatta nella sua interezza, false altrimenti. L'operatore logico (AND/OR) è unico e si applica uniformemente a tutte le condizioni del nodo.

Per scenari che richiedono più di due percorsi di uscita o attivazione parallela di rami, usa il nodo Router.

Posizionamento

Il nodo If ha un ingresso e due uscite: true e false. Esattamente una uscita viene attivata per ogni esecuzione. I nodi If possono essere messi in cascata per costruire alberi decisionali a più livelli.

Condizioni e operatori

È possibile definire una o più condizioni. Tutte le condizioni vengono valutate con lo stesso operatore logico globale:

• AND - tutte le condizioni devono essere vere per attivare il ramo true.
• OR - almeno una condizione deve essere vera per attivare il ramo true.

Operatori per tipo di dato

Tipo di dato	Operatori disponibili
Stringa	uguale, diverso, esiste, non esiste, è vuota, non è vuota, inizia con, finisce con, contiene, regex
Numero	uguale, diverso, maggiore, minore, maggiore o uguale, minore o uguale, esiste, non esiste
Booleano	esiste, non esiste, true, false
Object	esiste, non esiste, è vuoto, non è vuoto
Array	esiste, non esiste, è vuoto, non è vuoto, lunghezza uguale, lunghezza diversa, lunghezza maggiore, lunghezza minore

Uscite

Ramo	Attivato quando
true	La condizione (o l'espressione composta) è vera.
false	La condizione è falsa.

Esattamente un ramo viene attivato per run.

Output

Il nodo If non produce dati di output propri. Passa in trasparenza l'output dell'ultimo nodo non condizionale a monte. In caso di nodi If in cascata, il passthrough corrisponde al primo nodo non condizionale nella catena a monte.

Comportamento in caso di errore

Se una condizione contiene una configurazione non coerente (tipo del valore incompatibile con il tipo della variabile, o variabile inesistente), l'esecuzione del flusso termina in errore.

Concetti chiave

Termine	Definizione
Operatore logico globale	AND o OR, applicato uniformemente a tutte le condizioni del nodo If.