Creare e configurare gli agenti AI

Per ulteriori informazioni, vedere Configurare le sezioni Configurare l'agente AI con script e Configurare l'agente AI autonomo nella Guida all'amministrazione di AI Agent Studio Webex.

Configurare gli agenti AI nel flusso

È possibile utilizzare un nodo agente AI per rispondere a query specifiche da un corpus o da una Knowledge Base. Puoi anche abilitare le conversazioni a più turni. L'agente AI può porre domande di follow-up, comprendere il contesto e fornire risposte personalizzate.

Devi semplicemente trascinare e rilasciare il nodo dell'agente AI sul tuo generatore di flussi visivi per iniziare. Questo nodo consente di utilizzare agenti di intelligenza artificiale autonomi e con script configurati all'interno di Webex AI Agent Studio.

Configurare variabili di input e output nel nodo agente AI

Il nodo Agente AI contiene due metodi:

• Messaggio di processo: consente di inviare messaggi utente all'agente selezionato e di ottenere risposte dall'agente.

• Chiudi sessione: consente di chiudere una sessione nell'agente AI. In alcuni scenari, potrebbe essere necessario chiudere una sessione dell'agente AI esistente e avviarne una nuova. Può essere ottenuto utilizzando un metodo specifico all'interno del nodo AI Agent. Ad esempio, se una sessione rimane inattiva per un periodo specificato, il sistema chiude automaticamente la sessione per ottimizzare le risorse.

1. Nel metodo Process Message configurare le seguenti variabili di input:

   • Tipo di agente: il tipo di agente utilizzato nel flusso, ad esempio tramite script o autonomo.

   • Agente: l'agente che elabora il messaggio dell'utente e ottiene una risposta.

     Puoi visualizzare gli agenti AI a cui hai accesso in Webex AI Agent Studio. Per ulteriori informazioni sulla gestione di utenti e agenti in Webex AI Agent Studio, vedere Ruoli utente.

   • Messaggio: il nome della variabile contenente il messaggio del cliente in arrivo inviato all'agente AI scelto

   • Lingua: se l'agente AI scelto è multilingue, è possibile scegliere la lingua del messaggio in arrivo nell'elenco a discesa Lingua. L'elenco a discesa viene compilato in base alle lingue nelle impostazioni dell'agente AI.

     Nota: questo elenco a discesa viene disabilitato per gli agenti con una sola lingua.

   • Canale: il nome del canale da cui il sistema riceve il messaggio del cliente.

   • Identificatore utente: fornisce l'identificatore univoco dell'utente per il canale scelto.

   • Parametri personalizzati (facoltativo): è possibile passare informazioni aggiuntive sul cliente a Webex AI Agent Studio come coppia di valori chiave. Associamo queste informazioni al profilo dell'utente e le utilizziamo per conversazioni successive. Ad esempio, è possibile specificare se un utente è un nuovo cliente o un cliente esistente.

     Le chiavi passate come parametri personalizzati sono accessibili come ${consumerData.extra_params.<your_key>} nelle risposte dell'agente.

     Attualmente, i parametri personalizzati sono supportati solo per l'agente AI con script attraverso i canali digitali.

   • Parametri messaggio (facoltativo): è possibile passare ulteriori informazioni sullo scambio corrente a Webex AI Agent Studio come coppia di valori chiave.

     Questo messaggio non viene memorizzato ed è disponibile solo per l'uso nella successiva risposta dell'agente. Le chiavi passate come parametri messaggio sono accessibili come ${extra_params.<your_key>} nelle risposte dell'agente.

2. Configurare le variabili di output seguenti nel metodo Process Message:

   • TextResponse: l'output di testo configurato all'interno dell'agente AI funziona solo se non è presente alcun altro tipo di elementi ricchi o speciali. Inoltre, per più elementi di testo nella risposta, viene restituito il primo elemento di testo.

   • FullResponse: la risposta completa con tutti gli elementi avanzati e i messaggi multipli presenti nell'output dell'agente.

   • Datastore: un JSON/dict di tutte le variabili di sessione definite dall'utente all'interno dell'agente

   • TransactionId: ID transazione per la richiesta in Webex AI Agent Studio

   • SessionId: ID sessione/conversazione in Webex AI Agent Studio

   • ConsumerId: ID cliente in Webex AI Agent Studio

   • MessageMetadata: i metadati associati alla risposta corrente dell'agente configurato

   • SessionMetadata: i metadati associati alla sessione per la risposta corrente dell'agente configurato

     Attualmente, MessageMetadata e SessionMetadata sono supportati solo per l'agente AI con script attraverso i canali digitali.

   • ResponsePayload: il payload di risposta completo di Webex AI Agent Studio

3. Configurare le seguenti variabili di input nel metodo Chiudi sessione:

   • Agente: l'agente che elabora il messaggio dell'utente e ottiene una risposta.

     Puoi visualizzare gli agenti AI a cui hai accesso in Webex AI Agent Studio. Per ulteriori informazioni sulla gestione di utenti e agenti in Webex AI Agent Studio, vedere Ruoli utente.

   • ID sessione: la sessione dell'agente AI viene chiusa. L'ID sessione è disponibile come variabile di output del metodo Process message.

Risultati dei nodi

È possibile visualizzare l'elenco dei possibili risultati del nodo per questo nodo. È possibile personalizzare le etichette dei nodi utilizzando l'icona Modifica (matita). Il nodo esce attraverso uno degli spigoli del nodo corrispondente al risultato del nodo. Ogni nodo dell'agente AI corrisponde a un risultato del nodo. Ecco un elenco dei risultati dei nodi.

• Errore (rosso): indica quanto segue:

  • onError: quando l'agente non ha risposto con un messaggio.

  • onInvalidCustomerID: quando manca un identificatore del cliente.

  • onInvalidMessage: quando manca il valore del messaggio.

• Successo (verde): indica quanto segue:

  • onSuccess: quando l'agente risponde con un messaggio.

  • onAgentHandover: quando l'agente solleva una richiesta di consegna agli agenti.

• Timeout (giallo/ambra): indica quanto segue:

  • onTimeOut: quando l'agente non risponde da non più di 15 secondi.