Configurare l'evento personalizzato in ingresso in AI Agent Studio

1. Nella pagina di configurazione dell'agente AI, crea una nuova risposta in Responses Tab.
2. In Risposta predefinita, fare clic su +accanto al canale (Web) predefinito per aggiungere il canale vocale
3. Nel campo Nome evento in arrivo, definire il nome dell'evento ricevuto dall'agente.

Richiamare un evento personalizzato da Flow Designer

1. In Webex Contact Center Flow Designer configurare l'attività dell'agente virtuale V2 nel flusso.
2. Nelle impostazioni Stato evento , specificare i seguenti dettagli nelle colonne Nome evento - Dati evento:

   1. Immettere il nome dell'evento personalizzato configurato in Response Tab della pagina di configurazione dell'agente AI in AI Agent Studio.

   2. Immettere i dati personalizzati che si desidera passare da Flow Designer all'agente AI di cui è stato eseguito script.

Accesso ai dati degli eventi personalizzati in AI Agent Studio

È possibile accedere ai dati dell'evento (configurati in Flow Designer) nella sezione Risposta predefinita in cui è stato configurato l'evento in arrivo. Nella figura seguente è possibile osservare che il nome dell'evento personalizzato "custom_welcome" e il nome del negozio dei dati dell'evento vengono passati da Flow Designer ad AI Agent Studio.

Configurare eventi di uscita e payload personalizzati in AI Agent Studio

1. In AI Agent Studio, passare alla pagina di configurazione dell'agente AI di cui è stato eseguito script e passare a Risposta in cui si desidera che il controllo venga passato alla finestra di progettazione del flusso.

2. Aggiungere un evento personalizzato alla sezione Risposta predefinita.

3. Immettere il nome dell'evento e i dati del payload dell'evento nel JSON che si desidera vengano restituiti al flusso.

In questo esempio, gli slot raccolti vengono restituiti al flusso con l'evento di uscita personalizzato"order_details".

Accesso ai dati degli eventi personalizzati in Flow Designer

È possibile accedere all'evento personalizzato e al payload dalla sezione Variabili di output dell'attività Virtual Agent V2 .

Il nome dell'evento viene restituito nella variabile StateEventName e il payload Event viene restituito come Metadati , come illustrato nella figura seguente:

Aggiornare i valori di sistema in AI Agent Studio

È possibile aggiornare i valori di sistema quali contesto, intento e slot utilizzando un state_update di eventi speciale e un payload di eventi con i valori, come illustrato nell'esempio seguente:

{ "intent": "order_status", "slots": { "first_name": "John" } } 

Nell'esempio precedente, l'intento dell'agente di script è impostato su order_status, lo slot 'first_name' all'interno di tale intento è impostato su 'John' e un contesto chiamato 'track' viene aggiunto alla sessione.

Questo evento è utile per i casi d'uso in cui la conversazione dell'agente di script deve essere controllata dalla logica di flusso. Alcuni casi d'uso in cui questo è particolarmente utile includono:

• Richiedere nuovamente all'utente le informazioni se l'evasione del flusso non riesce

  Si consideri uno scenario in cui l'agente prenota un appuntamento per un utente. Dopo aver raccolto la data e l'ora, queste informazioni vengono inviate al flusso attraverso un evento personalizzato, che tenta quindi di prenotare l'appuntamento utilizzando un'attività di richiesta HTTPS. Se l'appuntamento viene rifiutato a causa di un conflitto di pianificazione, l'agente AI deve richiedere una fascia oraria alternativa. Per gestire questo problema, lo sviluppatore può utilizzare il payload dell'evento seguente:

  { "intent": "prenota appuntamenti", "slot": { "time": "" } }

  In questo caso, il valore raccolto per il tempo viene cancellato e l'agente AI richiede all'utente di fornirne uno nuovo. Gli sviluppatori possono impostare risposte condizionali per far sapere agli utenti che lo slot precedente non era disponibile e richiedere un nuovo orario.

• Passare a un intento diverso

  Si consideri uno scenario in cui un utente richiede di controllare il proprio saldo, ma come prerequisito, l'utente deve prima verificare la propria identità. Come parte del processo di richiesta del saldo, gli sviluppatori possono inviare un payload dell'evento per informare il flusso se l'utente è già stato verificato. Se verificato, il sistema può procedere al recupero del saldo; in caso contrario, il flusso può richiedere all'agente AI di avviare il processo di verifica dell'utente utilizzando il payload dell'evento seguente:

  { "intent": "verify user", }

  In questo stesso esempio, supponiamo che la verifica richieda la data di nascita e il codice PIN dell'utente. Del flusso ha già informazioni sulla data di nascita dell'utente tramite CJDS, che può essere passato come slot e solo il codice PIN può essere raccolto. Il payload dell'evento sarà simile al seguente:

  { "intent": "verify user", "slots": { "data di nascita": "26/06/1993" } }

• Introdurre o reimpostare il contesto in una conversazione

  Quando il contesto della conversazione deve essere aggiornato, gli sviluppatori possono includerlo nel payload dell'evento per l'evento state_update . Ad esempio, dopo che l'agente AI ha raccolto gli slot per l'intento "verifica utente", imposta il contesto della conversazione su "verifica". Se la verifica non riesce nel flusso, il contesto deve essere reimpostato per impedire all'utente di accedere agli intenti che richiedono il contesto di "verifica". Il payload dell'evento per questo scenario sarà simile al seguente:

  { "intent": "verify user", "slots": { "data di nascita": "", "pincode": "" }, "context": { "verify": 0 } }