Agent Studio - Router Tool (AI Router e Conditional Router)

Il Router di Agent Studio ti permette di controllare come le conversazioni si spostano tra i nodi all'interno di Agent Studio. Come suggerisce il nome, un router dirige il Workflow da un nodo all'altro in base a logiche o condizioni specifiche. Questo articolo spiega come usare AI Router, Conditional Router e il routing senza condizioni per costruire percorsi conversazionali più intelligenti basati su intento, logica o transizioni sempre attive.

INDICE

Cos'è il Router Tool in Agent Studio?
Vantaggi principali del Router Tool in Agent Studio
Usare AI Router
Usare Conditional Router
Usare No Condition
Usare il Router all'interno dei Sequential Nodes
Come usare il Router Tool in Agent Studio
Esempio di flusso
Best Practices
Domande frequenti
Articoli correlati

Cos'è il Router Tool in Agent Studio?

Il Router di Agent Studio controlla come un agente si sposta da un nodo all'altro in base al contesto della conversazione o a una logica definita. Ti permette di creare percorsi flessibili all'interno del tuo grafo, in modo che il passo successivo venga scelto in base a ciò che dice l'utente, ai dati già acquisiti, oppure perché il flusso deve sempre continuare al nodo successivo.

Il Router supporta tre approcci di routing:

AI Router: usa l'intento espresso in linguaggio naturale per decidere quale percorso seguire.
Conditional Router: usa variabili salvate e regole logiche per determinare il nodo successivo.
No Condition: si sposta sempre al nodo successivo collegato senza valutare intento o logica.

Il Router può essere usato nei flussi agente e all'interno dei Sequential Nodes, consentendo a un processo lineare di ramificarsi quando necessario prima di continuare.

Vantaggi principali del Router Tool in Agent Studio

Branching più intelligente: instrada gli utenti in base a ciò che intendono dire, non solo a parole chiave fisse.
Maggiore controllo: usa variabili e regole logiche per portare i Contatti al passo successivo corretto.
Design del grafo più pulito: collega i nodi in modo più intenzionale invece di forzare tutto in un unico percorso.
Costruzione di flussi flessibile: combina AI routing, logica condizionale e routing sempre attivo nello stesso agente.
Migliore esperienza utente: aiuta i Contatti a raggiungere l'esito giusto più rapidamente, con meno passaggi inutili.
Supporto per automazioni più avanzate: aggiungi decisioni dinamiche all'interno di Agent Studio e dei Sequential Nodes.

Usare AI Router

AI Router è la scelta migliore quando il passo successivo dipende da ciò che l'utente intende dire in linguaggio naturale. Invece di verificare un valore esatto, l'AI analizza il messaggio dell'utente e lo abbina all'intento più appropriato tra quelli che hai definito.

Usa AI Router quando:

gli utenti possono rispondere in modi diversi che significano la stessa cosa
vuoi ramificare il flusso in base a interesse, sentiment o intento conversazionale
il percorso deve essere scelto dal linguaggio naturale anziché da una variabile memorizzata

Esempi di intenti:

L'utente vuole investire in argento
L'utente non vuole investire in argento

In questa configurazione, il Router valuta l'ultimo messaggio dell'utente e invia la conversazione al nodo collegato corrispondente.

Schermata 1 — Agent Studio - Router Tool (AI Router e Conditional Router)

Usare Conditional Router

Conditional Router è la scelta migliore quando il routing dipende da un valore noto già acquisito nella conversazione. È utile quando uno strumento, un campo di un Form, una scelta o un nodo precedente memorizza un valore che può essere valutato con logica.

Usa Conditional Router quando:

hai già una variabile salvata da valutare
il percorso dipende da un valore fisso come Sì, No, positivo o negativo
hai bisogno di un branching basato su regole esplicite invece dell'interpretazione dell'AI

Le route condizionali usano campi logici come:

Variable
Operator
Value

Esempio:

Variable: {{runtime.userChoice_eyro}}
Operator: equals (EQ)
Value: Yes

Quella route può inviare l'utente a un percorso di conferma, mentre un'altra condizione può instradarlo verso un nodo diverso.

Schermata 2 — Agent Studio - Router Tool (AI Router e Conditional Router)

Usare No Condition

No Condition è utile quando vuoi che il Router proceda sempre senza valutare intento o logica. Crea una route sempre attiva e funziona bene come collegamento tra passaggi in un flusso conversazionale più ampio.

Usa No Condition quando:

il nodo successivo deve sempre essere eseguito dopo quello corrente
vuoi una transizione semplice tra i nodi
un passaggio ha già raccolto le informazioni necessarie e deve ora continuare automaticamente

Quando abilitata, la route agisce come percorso sempre attivo verso il nodo successivo collegato.

Schermata 3 — Agent Studio - Router Tool (AI Router e Conditional Router)

Usare il Router all'interno dei Sequential Nodes

Il Router può essere usato anche all'interno dei Sequential Nodes, consentendo a un flusso prevalentemente lineare di ramificarsi quando necessario. È utile quando una sequenza deve continuare in ordine ma necessita comunque di una decisione basata sull'AI o sulla logica prima di procedere.

Questo approccio funziona bene quando:

una sequenza ha bisogno di un punto di decisione prima del passo successivo
la risposta di un utente deve reindirizzarlo verso esiti diversi
vuoi combinare flussi strutturati con routing dinamico

Schermata 4 — Agent Studio - Router Tool (AI Router e Conditional Router)

Come usare il Router Tool in Agent Studio

Una configurazione Router ben strutturata garantisce che le conversazioni si spostino in modo intelligente in base all'intento dell'utente o alla logica definita. Segui i passi qui sotto per configurare il routing basato su AI e su regole all'interno del tuo agente.

Dal menu di navigazione a sinistra, clicca su AI Agents e seleziona la scheda Agent Studio in cima alla pagina.
Crea un New Agent oppure clicca sul nome di un agente esistente per aprirlo.
Aggiungi un Trigger come Chat Message o Form Submitted, ecc.
Aggiungi un AI Agent e configuralo.
Dal pannello Flow Control sulla sinistra, trascina il nodo Router sul canvas per inserire un punto di decisione nel tuo flusso conversazionale.
Una volta posizionato, il pannello Edit Router si apre a destra, dove puoi scegliere la modalità di routing e iniziare a configurare come deve ramificarsi la conversazione.
Nel pannello di configurazione del Router, scegli tra AI Router e Conditional Router nella sezione "Router Type". Questa selezione determina se la decisione di routing sarà basata sul rilevamento dell'intento tramite AI o su logica basata su regole.
Configura il router:
- Per AI Router, aggiungi gli intenti che devono determinare ogni percorso. Ogni intento rappresenta un ramo che la conversazione può seguire quando l'AI rileva un intento corrispondente nel messaggio dell'utente.
- Per Conditional Router, aggiungi una o più condizioni usando la variabile, l'operatore e il valore corretti.
  
  Passa a Conditional Router se vuoi che le decisioni di routing si basino su dati strutturati invece dell'interpretazione del linguaggio naturale. Questa modalità valuta variabili e logica predefinita per determinare il passo successivo.
  
  Inserisci un Label chiaro per il ramo condizionale per identificarlo all'interno del grafo conversazionale. Questa etichetta appare sulla connessione del nodo e aiuta a mantenere organizzati i flussi complessi.
  
  Seleziona il Condition Type per definire come vengono valutate più regole. Scegli se tutte le condizioni devono corrispondere (AND) o se basta che una sola corrisponda (OR).
  
  Nell'editor delle condizioni, seleziona la Variable, scegli l'Operator appropriato e definisci il Value atteso. Questo indica al Router esattamente quali dati valutare prima di procedere lungo quel ramo.
- Per No Condition, abilita il toggle in modo che la route continui sempre al nodo successivo.
Collega ogni output della route al nodo di destinazione corretto nel tuo grafo.
Salva le impostazioni del Router.
Testa la conversazione per confermare che ogni route porti al passo successivo corretto.
Salva, Pubblica e Distribuisci il Workflow.

Esempio di flusso

Un esempio pratico rende più facile capire come diversi tipi di Router lavorano insieme in un unico agente. Il flusso qui sotto mostra come AI routing, routing sempre attivo e routing basato su condizioni possano supportare un percorso utente completo.

Esempio di flusso:

L'agente chiede all'utente del prezzo dell'argento e usa Web Search per fornire le informazioni.
L'agente chiede poi se l'utente vuole investire in argento.
Un AI Router valuta la risposta dell'utente:
- Se l'utente vuole investire, il flusso passa al nodo successivo.
- Se l'utente non vuole investire, il flusso viene instradato verso un nodo di ringraziamento.
Il nodo successivo acquisisce l'email dell'utente.
Una route No Condition sposta sempre il flusso verso un passaggio di conferma.
Un nodo Single Choice chiede se l'utente vuole procedere.
Un Conditional Router verifica la risposta salvata:
- Se il valore è uguale a Yes, il flusso passa al percorso di conferma.
- Se il valore è uguale a No, il flusso porta a un esito diverso.

Best Practices

Un design del routing solido rende il tuo agente più facile da mantenere e aiuta a ridurre gli errori durante i test. Label delle route chiari, logica intenzionale e casi di test realistici rendono più facile capire perché un utente ha raggiunto un percorso specifico.

Usa AI Router quando le risposte degli utenti possono variare nel lessico ma condividono lo stesso intento.
Usa Conditional Router quando la decisione dipende da un valore salvato.
Usa No Condition quando il flusso deve sempre continuare.
Mantieni i label delle route chiari in modo che ogni ramo sia facile da capire.
Testa ogni percorso prima di pubblicare il tuo agente.
Collega articoli di configurazione correlati quando una route dipende da variabili o altri strumenti.

Domande frequenti

D: Qual è la differenza tra AI Router e Conditional Router?

AI Router valuta l'intento in linguaggio naturale, mentre Conditional Router verifica un valore salvato usando logica come variabile, operatore e valore.

D: Quando devo usare No Condition?

Usa No Condition quando il flusso deve sempre spostarsi al nodo successivo collegato senza valutare intento o logica.

D: Posso usare il Router all'interno dei Sequential Nodes?

Sì. Il Router può essere usato all'interno dei Sequential Nodes in modo che un flusso lineare possa ramificarsi prima di continuare.

D: Ho bisogno di una variabile per AI Router?

No. AI Router usa la risposta in linguaggio naturale dell'utente e gli intenti che hai definito.

D: Ho bisogno di una variabile per Conditional Router?

Sì. Conditional Router funziona meglio quando il valore è già stato acquisito e memorizzato per la valutazione.

D: Cosa succede se nessun intento o condizione corrisponde?

Assicurati che ogni route sia collegata al nodo successivo corretto e includi un percorso di fallback dove necessario affinché la conversazione possa continuare come previsto.

D: Cosa devo fare se una route non porta al nodo atteso?

Rivedi la configurazione della route, verifica le connessioni dei nodi corretti e testa di nuovo la conversazione per verificare che l'intento o la condizione siano configurati correttamente.

D: Il Router aggiunge costi AI extra per i messaggi?

Solo le esecuzioni di AI Router vengono conteggiate nella fatturazione LLM. Le modalità Conditional e No Condition sono gratuite.

D: Cosa succede se nessun intento o condizione corrisponde?

Il flusso segue il ramo "Default". Se non è collegato nessun ramo, la conversazione termina con un'voce nel log degli errori.

D: Posso combinare AI routing e Conditional routing in un unico nodo?

Un singolo nodo Router supporta una sola modalità alla volta, ma puoi concatenare più Router uno dopo l'altro.

D: È necessario addestrare gli intenti?

No. L'LLM classifica al volo in base ai nomi degli intenti e al contesto della conversazione corrente.

D: Come faccio a fare debug di route errate?

Apri l'Execution Log → scheda Routing per vedere l'intento rilevato, il ragionamento e la confidenza, oppure la stringa della condizione valutata.

D: Il pannello flottante sostituirà tutti i pop-up in Agent Studio?

Sì, i futuri tipi di nodo useranno lo stesso pannello non modale per mantenere il canvas sempre visibile.