Il Router di Agent Studio ti aiuta a controllare come le conversazioni si spostano tra i nodi in Agent Studio. Come suggerisce il nome, un router dirige il flusso di lavoro da un nodo al successivo in base a logica o condizioni specifiche. Questo articolo spiega come utilizzare AI Router, Router Condizionale e il routing Senza Condizioni per costruire percorsi di conversazione più intelligenti basati su intenti, logica o transizioni sempre attive.
- Cos'è il Router Tool in Agent Studio?
- Vantaggi principali del Router Tool in Agent Studio
- Usare AI Router
- Usare il Router Condizionale
- Usare Senza Condizioni
- Usare il Router all'interno dei Nodi Sequenziali
- Come usare il Router Tool in Agent Studio
- Esempio di flusso
- Best Practice
- 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 alla logica definita. Ti aiuta a creare percorsi flessibili all'interno del tuo grafo, in modo che il passaggio successivo venga scelto in base a ciò che l'utente dice, ai dati già acquisiti, o al fatto che il flusso debba sempre proseguire al nodo successivo.
Il Router supporta tre modalità di instradamento:
AI Router: Usa l'intento in linguaggio naturale per decidere quale percorso seguire.
Router Condizionale (Conditional Router): Usa variabili salvate e regole logiche per determinare il nodo successivo.
Senza Condizioni (No Condition): Si sposta sempre al nodo connesso successivo senza valutare intenti o logica.
Il Router può essere utilizzato nei flussi degli agenti e all'interno dei Nodi Sequenziali, permettendo a un processo lineare di ramificarsi quando necessario prima di continuare.
Vantaggi principali del Router Tool in Agent Studio
Ramificazione 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 spostare i contatti al passaggio 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 routing AI, logica condizionale e routing sempre attivo nello stesso agente.
Migliore esperienza utente: Aiuta i contatti a raggiungere il risultato corretto più rapidamente con meno passaggi non necessari.
Supporto per Automazioni più avanzate: Aggiungi decisioni dinamiche all'interno di Agent Studio e dei Nodi Sequenziali.
Usare AI Router
AI Router è la scelta migliore quando il passaggio 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 che hai definito.
Usa AI Router quando:
gli utenti potrebbero rispondere in modi diversi che significano la stessa cosa
vuoi ramificare in base all'interesse, al sentiment o all'intento conversazionale
il percorso deve essere scelto dal linguaggio naturale invece che da una variabile salvata
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 connesso corrispondente.
Usare il Router Condizionale
Il Router Condizionale è la scelta migliore quando l'instradamento dipende da un valore noto già acquisito nella conversazione. È utile quando uno strumento, un campo modulo, una scelta o un nodo precedente salva un valore che può essere valutato con logica.
Usa il Router Condizionale quando:
hai già una variabile salvata da valutare
il percorso dipende da un valore fisso come Sì, No, positivo o negativo
hai bisogno di ramificazione esplicita basata su regole invece che su interpretazione AI
Le route condizionali usano campi logici come:
Variabile (Variable)
Operatore (Operator)
Valore (Value)
Esempio:
Variabile:
{{runtime.userChoice_eyro}}Operatore:
equals (EQ)Valore:
Yes
Quella route può inviare l'utente a un percorso di proseguimento, mentre un'altra condizione può indirizzarlo a un nodo diverso.
Usare Senza Condizioni
Senza Condizioni è utile quando vuoi che il Router vada sempre avanti senza valutare intenti o logica. Crea una route sempre attiva e funziona bene come collegamento tra passaggi in un flusso di conversazione più ampio.
Usa Senza Condizioni quando:
il nodo successivo deve essere eseguito sempre dopo quello corrente
vuoi una transizione semplice tra 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 connesso successivo.
Usare il Router all'interno dei Nodi Sequenziali
Il Router può essere utilizzato anche all'interno dei Nodi Sequenziali, consentendo a un flusso prevalentemente lineare di ramificarsi quando necessario. Questo è utile quando una sequenza deve continuare in ordine ma ha ancora bisogno di una decisione basata su AI o logica prima di procedere.
Questo approccio funziona bene quando:
una sequenza ha bisogno di un punto di decisione prima del passaggio successivo
la risposta di un utente deve reindirizzarlo a risultati diversi
vuoi combinare flussi strutturati con routing dinamico
Come usare il Router Tool in Agent Studio
Una configurazione ben strutturata del Router garantisce che le conversazioni si spostino in modo intelligente in base all'intento dell'utente o alla logica definita. Segui i passaggi seguenti per configurare sia il routing basato su AI che quello basato su regole all'interno del tuo agente.
- Dal menu di navigazione a sinistra, clicca su AI Agents e poi seleziona la scheda Agent Studio in cima alla pagina.
- Crea un Nuovo Agente oppure clicca sul nome di un agente esistente per aprirlo.
- Aggiungi un Trigger (Trigger) come Messaggio in Chat o Modulo Inviato, ecc.
- Aggiungi un Agente AI e configuralo.
- Dal pannello Controllo Flusso (Flow Control) a sinistra, trascina il nodo Router sul canvas per inserire un punto di decisione nel flusso della tua conversazione.
- Una volta posizionato, il pannello Modifica Router si apre a destra, dove puoi scegliere la modalità di instradamento e iniziare a configurare come la conversazione deve ramificarsi.
- Nel pannello di configurazione del Router, scegli tra AI Router e Router Condizionale nella sezione "Tipo di Router (Router Type)". Questa selezione determina se la decisione di instradamento sarà basata sul rilevamento dell'intento 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 l'intento corrispondente nel messaggio dell'utente.
Per il Router Condizionale, aggiungi una o più condizioni usando la variabile, l'operatore e il valore corretti.
Passa al Router Condizionale se vuoi che le decisioni di instradamento siano basate su dati strutturati invece che sull'interpretazione del linguaggio naturale. Questa modalità valuta variabili e logica predefinita per determinare il passaggio successivo.
Inserisci un Etichetta (Label) chiara per il ramo della condizione in modo da identificarlo all'interno del grafo della conversazione. Questa etichetta appare sulla connessione del nodo e aiuta a mantenere organizzati i flussi complessi.
Seleziona il Tipo di Condizione (Condition Type) per definire come vengono valutate più regole. Scegli se tutte le condizioni devono corrispondere (AND) o se può corrispondere una singola condizione (OR).
Nell'editor delle condizioni, seleziona la Variabile (Variable), scegli l'Operatore (Operator) appropriato e definisci il Valore (Value) atteso. Questo indica al Router esattamente quali dati valutare prima di procedere lungo quel ramo.
Per Senza Condizioni, 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 verificare che ogni route porti al passaggio successivo corretto.
- Salva, Pubblica e Distribuisci (Deploy) 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 il routing AI, il routing sempre attivo e il routing basato su condizioni possano supportare un percorso utente completo.
Esempio di flusso:
L'agente chiede all'utente del prezzo dell'argento e usa la Ricerca Web (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 indirizzato a un nodo di ringraziamento.
Il nodo successivo acquisisce l'email dell'utente.
Una route Senza Condizioni sposta sempre il flusso a un passaggio di conferma.
Un nodo Scelta Singola (Single Choice) chiede se l'utente vuole procedere.
Un Router Condizionale verifica la risposta salvata:
Se il valore è Sì (Yes), il flusso si sposta al percorso di proseguimento.
Se il valore è No, il flusso si sposta a un risultato diverso.
Best Practice
Un buon design del routing rende il tuo agente più facile da mantenere e aiuta a ridurre gli errori durante i test. Etichette delle route chiare, 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 nelle parole ma condividono lo stesso intento.
Usa il Router Condizionale quando la decisione dipende da un valore salvato.
Usa Senza Condizioni quando il flusso deve sempre continuare.
Mantieni le etichette delle route chiare in modo che ogni ramo sia facile da capire.
Testa ogni percorso di route prima di pubblicare il tuo agente.
Collega ad articoli di configurazione correlati quando una route dipende da variabili o altri strumenti.
Domande frequenti
D: Qual è la differenza tra AI Router e Router Condizionale?
AI Router valuta l'intento in linguaggio naturale, mentre il Router Condizionale verifica un valore salvato usando logica come variabile, operatore e valore.
D: Quando dovrei usare Senza Condizioni?
Usa Senza Condizioni quando il flusso deve sempre spostarsi al nodo connesso successivo senza valutare intenti o logica.
D: Posso usare il Router all'interno dei Nodi Sequenziali?
Sì. Il Router può essere usato all'interno dei Nodi Sequenziali 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 il Router Condizionale?
Sì. Il Router Condizionale funziona meglio quando il valore è già stato acquisito e salvato per la valutazione.
D: Cosa succede se nessun intento o condizione corrisponde?
Assicurati che ogni route sia connessa al nodo successivo corretto e includi un percorso di fallback dove necessario in modo che la conversazione possa continuare come previsto.
D: Cosa devo fare se una route non va al nodo previsto?
Rivedi la configurazione della route, conferma le connessioni corrette dei nodi e testa nuovamente la conversazione per verificare che l'intento o la condizione sia impostato correttamente.