Nodo Router - Routing Multi-Ramo Condizionale in ConvyAI Agentic Flow
Overview
Il nodo Router valuta un insieme di condizioni indipendenti, ciascuna associata a un proprio ramo di uscita. A differenza del nodo If, più condizioni possono essere vere contemporaneamente - attivando rami paralleli. Un flag configurabile consente di passare alla modalità prima condizione valida, in cui la valutazione si ferma alla prima condizione vera.
Posizionamento
Il nodo Router ha un ingresso e un'uscita per condizione. In modalità default, più uscite possono essere attive contemporaneamente. In modalità prima condizione valida, al massimo una uscita viene attivata per esecuzione.
Condizioni e uscite
Ogni condizione ha un ramo dedicato. La label predefinita di ogni ramo è condition-{contatore} ed è personalizzabile. L'ordine delle condizioni è modificabile tramite drag&drop nel pannello di configurazione.
Gli operatori supportati per tipo sono gli stessi del nodo If.
Modalità di valutazione
| Modalità | Comportamento |
|---|---|
| Default (flag disattivo) | Tutte le condizioni vengono valutate indipendentemente. Ogni condizione vera attiva il proprio ramo; più rami possono essere eseguiti in parallelo. |
| Prima condizione valida (flag attivo) | Le condizioni vengono valutate nell'ordine configurato. Solo la prima condizione vera attiva il proprio ramo; le successive vengono ignorate. |
Output
Il nodo Router non produce dati di output propri. Passa in trasparenza l'output dell'ultimo nodo non condizionale a monte. In caso di Router 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.
If vs Router
| If | Router | |
|---|---|---|
| Uscite | Esattamente 2 (true / false) | Uno per condizione |
| Attivazione rami simultanea | No | Sì (modalità default) |
| Modalità prima condizione | N/A | Disponibile tramite flag |
| Caso d'uso | Decisione binaria | Routing multi-criterio |
Concetti chiave
| Termine | Definizione |
|---|---|
| Modalità prima condizione valida | Comportamento del Router in cui solo la prima condizione vera (nell'ordine configurato) attiva il proprio ramo. |