Intenti

L'intento è un componente fondamentale della piattaforma Webex AI Agent Studio che consente all'agente AI di comprendere e rispondere in modo efficace al tuo input. Rappresenta un'attività o un'azione specifica che si desidera eseguire durante una conversazione. È possibile definire tutti gli intenti che corrispondono alle attività che si desidera eseguire. L'accuratezza della classificazione degli intenti influisce direttamente sulla capacità dell'agente AI di fornire risposte pertinenti e utili. La classificazione dell'intento è il processo di identificazione dell'intento in base al tuo input, consentendo all'agente AI di rispondere in modo significativo e contestualmente pertinente. Per informazioni dettagliate su come creare intenti, consultate Creare un intento.

Intenti di sistema

  • Intento di fallback predefinito: le capacità di un agente AI sono intrinsecamente limitate dagli intenti progettati per riconoscere e rispondere. Sebbene un'azienda non sia in grado di anticipare tutte le possibili domande che potresti porre, l'intento di fallback predefinito può aiutare le conversazioni a essere sulla buona strada.

    Implementando un intento di fallback predefinito, gli sviluppatori di agenti di intelligenza artificiale possono garantire che l'agente di intelligenza artificiale gestisca correttamente query impreviste o fuori ambito, reindirizzando la conversazione agli intenti noti.

    Gli sviluppatori di agenti di intelligenza artificiale non devono aggiungere espressioni specifiche all'intento di fallback. L'agente può essere addestrato ad attivare automaticamente l'intento di fallback quando incontra domande note fuori ambito che altrimenti potrebbero essere erroneamente classificate in altri intenti.

    Ad esempio, in un agente di intelligenza artificiale bancario, i clienti potrebbero tentare di informarsi sui prestiti. Se l'agente AI non è configurato per gestire richieste relative al prestito, queste query possono essere incorporate come frasi di addestramento all'interno dell'intento di fallback predefinito. Quando un cliente chiede informazioni sui prestiti in qualsiasi momento della conversazione, l'agente AI riconosce che la query non rientra nei suoi intenti definiti e attiva la risposta di fallback. Ciò garantisce una risposta più appropriata.

    Intento di fallback:

    • Non dovrebbe avere slot ad esso associati.
    • Deve utilizzare la chiave del modello di fallback predefinita per la risposta.

  • Guida: questo intento è progettato per rispondere alle richieste dei clienti sulle capacità dell'agente di intelligenza artificiale. Quando i clienti non sono sicuri di ciò che possono realizzare o incontrano difficoltà durante una conversazione, spesso cercano assistenza chiedendo aiuto.

    Per impostazione predefinita, la risposta per l'intento della Guida è mappata alla chiave del modello di messaggio della Guida. Tuttavia, gli sviluppatori di agenti di intelligenza artificiale possono personalizzare la risposta o modificare la chiave del modello associata per fornire indicazioni più personalizzate e informative.

    Si consiglia di trasmettere le capacità dell'agente AI ad alto livello, fornendo ai clienti una chiara comprensione di ciò che possono fare dopo.

  • Parla con un agente: questo intento consente ai clienti di richiedere assistenza a un agente umano in qualsiasi fase della loro interazione con l'agente AI. Quando viene invocato questo intento, il sistema avvia automaticamente un trasferimento a un agente umano. Il modello di risposta predefinito per questo intento è il trasferimento dell'agente. Sebbene non vi siano restrizioni dell'interfaccia utente sulla modifica della chiave del modello di risposta, la sua modifica non influirà sull'esito del passaggio di consegne umano.

Intenti di conversazione

Tutti gli agenti AI appena creati includono quattro intenti predefiniti di conversazione per gestire i saluti comuni dei clienti, le espressioni di gratitudine, i feedback negativi e gli addii:

  • Saluti
  • Grazie
  • L'agente AI non è stato utile
  • Arrivederci
Questi intenti e le relative risposte sono disponibili per impostazione predefinita in ogni agente di intelligenza artificiale. Tuttavia, puoi personalizzarli o eliminarli per allinearli al tuo caso d'uso specifico e al flusso di conversazione desiderato.

Contesti

Il contesto rende le interazioni agente-cliente più semplici e concise. L'agente di intelligenza artificiale comprende facilmente frasi come "Voglio comprarlo" quando c'è abbastanza contesto per identificare a cosa si riferisce "quello". I contesti aiutano a ottenere chiarezza nelle interazioni con i clienti. Tali espressioni possono essere allineate con un intento se viene fornito il contesto appropriato.

Per abilitare gli intenti di follow-up e organizzare i modi per strutturare il flusso di una conversazione, ogni intento può essere configurato con il contesto di ingresso e il contesto di uscita. Questa variabile di contesto viene memorizzata per ogni sessione e lo stato di questa variabile cambia in base agli intenti richiamati nel corso di una sessione.

Contesto della voce

I contesti di immissione controllano se un intento può essere abbinato alla query dell'utente finale in base al contesto attivo della sessione. Quando il contesto è presente in una sessione, vengono applicate le seguenti regole per la corrispondenza delle intenzioni:

  • Un intento con contesti di immissione corrisponderà solo se il contesto attivo nella sessione contiene già tutti i valori del contesto di immissione richiesti. In altre parole, il contesto di ingresso di un intento deve essere un sottoinsieme del contesto attivo affinché possa essere abbinato.

  • Per tutti gli intenti che soddisfano la regola precedente, viene data preferenza agli intenti il cui contesto di input corrisponde più strettamente all'attivo se i punteggi di confidenza per più intenti sono gli stessi. In altre parole, il contesto di input verrà utilizzato per le partite parziali di spareggio.

Contesto di uscita

I contesti di uscita controllano i contesti attivi per una sessione. Un contesto di uscita contiene la stringa del valore del contesto e la durata di tale contesto. Quando un intento viene completato (tutti gli slot vengono riempiti e viene richiamata la risposta finale), i contesti di uscita configurati per tale intento diventano exit per la rispettiva durata. Gli sviluppatori possono configurare un massimo di 15 contesti di uscita per un determinato intento. È possibile aggiungere un contesto di uscita premendo il tasto invio/invio dopo aver digitato il contesto.

Entità

Le entità sono gli elementi costitutivi delle conversazioni. Sono elementi essenziali che l'agente AI estrae dalle espressioni degli utenti. Le entità rappresentano informazioni specifiche, come nomi di prodotti, date, quantità o qualsiasi altro gruppo significativo di parole. Identificando ed estraendo efficacemente le entità, l'agente AI può comprendere meglio l'intento dell'utente e fornire risposte più accurate e pertinenti. Per informazioni dettagliate su come creare un'entità, vedere Creare un'entità.

Tipi di entità

Webex AI Agent Studio offre 11 tipi di entità predefiniti per acquisire vari tipi di dati utente. È inoltre possibile creare una delle seguenti entità personalizzate.

Entità personalizzate

Queste entità sono configurabili e consentono agli sviluppatori di acquisire informazioni specifiche sui casi d'uso.

  • Elenco personalizzato: consente di definire elenchi di stringhe previste per acquisire punti dati specifici non coperti da entità predefinite. È possibile aggiungere più sinonimi a ciascuna stringa. Ad esempio, un'entità di dimensioni pizza personalizzata.

  • Regex: utilizzare espressioni regolari per identificare modelli specifici ed estrarre i dati corrispondenti. Ad esempio, una regex di numeri di telefono, come in 123-123-8789

  • Cifre: cattura input numerici a lunghezza fissa con elevata precisione, specialmente nelle interazioni vocali. Lo usiamo come alternativa ai tipi di entità Custom e Regex nelle interazioni non vocali. Ad esempio, definire una lunghezza di cinque per rilevare un numero di conto a cinque cifre.

  • Alfanumerico: cattura combinazioni di lettere e numeri, fornendo un riconoscimento accurato per gli input vocali e non vocali.

  • Forma libera: acquisizione di punti dati flessibili difficili da definire o convalidare.

  • Posizione sulla mappa (WhatsApp): estrai i dati sulla posizione condivisi da te sul canale WhatsApp.

Entità di sistema

Nome entitàDescrizioneInput di esempioOutput di esempio
DataAnalizza le date in linguaggio naturale in un formato di data standard"Luglio dell'anno prossimo"01/07/2020
OraAnalizza l'ora in linguaggio naturale in un formato di ora standard5 di sera17:00
E-mailRileva gli indirizzi e-mailScrivimi a info@cisco.com info@cisco.com
Numero di telefonoRileva il numero di telefono comuneChiamami al 98765432109876543210
Unità monetarieAnalizza valuta e importoVoglio 20$20$
OrdinaleRileva il numero ordinaleQuarto di dieci persone
CardinaleRileva il numero cardinaleQuarto di dieci persone10
GeolocalizzazioneRileva le posizioni geografiche (città, paesi, ecc.)Sono andato a nuotare nel Tamigi a Londra nel Regno UnitoLondra, Regno Unito
Nomi di personeRileva i nomi comuniBill Gates di MicrosoftBill Gates
QuantitàIdentifica le misure, in base al peso o alla distanzaSiamo a 5 km da Parigi5km
DurataIdentifica i periodi di tempo1 settimana di vacanza1 settimana

È possibile modificare le entità create dalla scheda entità. Il collegamento di entità a un intento annota le espressioni con le entità rilevate man mano che vengono aggiunte.

Ruoli dell'entità

I ruoli dell'entità sono cruciali quando è necessario raccogliere la stessa entità più volte all'interno di un singolo intento. Assegnando ruoli distinti alla stessa entità, puoi aiutare l'agente AI a comprendere ed elaborare l'input dell'utente in modo più accurato.

Ad esempio, per prenotare un volo con scalo, è possibile creare un'entità Aeroporto con tre ruoli: origine, destinazione e scalo. Annotando le espressioni di formazione con questi ruoli, l'agente AI può apprendere i modelli previsti e gestire senza problemi richieste di prenotazione complesse.

Solo Mindmeld (entità personalizzate e di sistema) e RASA (solo entità personalizzate) supportano i ruoli delle entità. Gli amministratori devono selezionare la casella di controllo Ruoli entità nelle impostazioni avanzate della finestra di dialogo Selettore motore AI per abilitare i ruoli entità.

Gli amministratori non possono passare da RASA o Mindmeld a Swiftmatch quando i ruoli dell'entità sono in uso. Rimuovi i ruoli dagli intenti per disabilitare i ruoli di entità dalle impostazioni avanzate del motore di intelligenza artificiale. Per altre informazioni, vedi Aggiornare le impostazioni del motore di intelligenza artificiale.

Risposte

Le risposte sono i messaggi che l'agente AI invia ai clienti in risposta alle loro domande o intenzioni. È possibile creare risposte che includono:

  • Testo: messaggi di testo normale per la comunicazione diretta.
  • Multimedia: immagini, elementi audio o video per migliorare l'esperienza utente.

Per informazioni dettagliate su come creare risposte, vedere Creare una risposta.

Risposte del sistema

Le seguenti risposte di sistema preconfigurate sono disponibili per l'agente AI di script. È possibile personalizzare i messaggi per le risposte di sistema predefinite. Tuttavia, non è possibile eliminare queste risposte.

  • Messaggio di benvenuto

  • Suggerimento di risposta

  • Messaggio parziale

  • Messaggio di fallback

  • Suggerimento di entità

  • Trasferimento dell'agente

Risposte di conversazione

È possibile personalizzare ed eliminare le seguenti risposte di conversazione limitata:

  • Arrivederci

  • Saluti

  • Messaggio di aiuto

  • Non utile

  • Grazie

I canali supportati per i quali è possibile configurare le risposte sono Web (predefinito), Apple Messages for Business, Messenger, RCS, SMS, Voice, WhatsApp.

Progettazione risposte

La finestra di progettazione delle risposte offre un'interfaccia intuitiva per la creazione di risposte senza richiedere conoscenze approfondite di codifica. L'opzione delle risposte condizionali consente di creare facilmente risposte per i non sviluppatori che l'agente AI fornisce ai clienti.

La finestra di progettazione delle risposte è progettata per garantire che l'esperienza utente si adatti al canale specifico con cui l'agente AI interagisce.

Tipi di risposta supportati per i canali

In Response Designer è possibile configurare risposte specifiche del canale per gli intenti. Per ulteriori informazioni su come configurare diversi tipi di risposta, vedere la sezione Configurare i tipi di risposta.

Tabella 1. Tipi di risposta per i canali
Tipo di rispostaDescrizioneCanali supportati
TestoLe risposte di testo semplici consentono più caselle di testo in un'unica risposta. Questa configurazione suddivide i messaggi lunghi in parti gestibili. È possibile aggiungere più opzioni di risposta alle risposte e il sistema ne sceglierà casualmente una da visualizzare, garantendo interazioni dinamiche.Tutti
CaroselloLe risposte multimediali consistono in una singola scheda o più schede visualizzate in formato carosello.Web (impostazione predefinita), Messenger
Risposta rapidaUna risposta predefinita che gli agenti AI utilizzano per rispondere rapidamente alle richieste dei clienti.Web (predefinito), SMS, Messenger, Apple Messages for Business, RCS
ImmagineUn tipo di risposta multimediale in cui è possibile configurare le immagini fornendo URL.Web (predefinito), Messenger, WhatsApp
VideoEsegue il rendering dei video nell'anteprima in base all'URL del video configurato.Web (impostazione predefinita), WhatsApp
AudioEsegue il rendering del file audio specificando l'URL audio. Mostra anche la durata del messaggio audio nell'output.Web (predefinito), WhatsApp, Webchat
FileMostra/riproduce il tipo di file in base all'URL del file configurato.WhatsApp
Pulsante RispondiOffre risposte rapide da una serie limitata di opzioni, come la scelta di un prodotto da restituire.

Ogni messaggio è composto da:

  • Intestazione: un campo facoltativo che può contenere 20 caratteri di testo, immagine, video o documento.
  • Corpo - un campo di testo obbligatorio che può contenere fino a 1024 caratteri.
  • Piè di pagina - un campo di testo opzionale che consente fino a 60 caratteri.
  • Pulsanti - massimo 3 pulsanti di testo con un limite di 20 caratteri.

WhatsApp
Messaggio elencoPresenta molteplici opzioni per una facile selezione dell'utente, adatte a vari usi come menu da asporto o cataloghi di prodotti. Per impostare un messaggio di elenco, compila le schede "configurazione" e "sezioni elenco". La schermata "configurazione" mostra il contenuto del messaggio che gli utenti vedranno sui loro dispositivi.

Ogni messaggio è composto da:

  • Intestazione: un campo di testo opzionale con un massimo di 60 caratteri.

  • Corpo - un campo di testo obbligatorio che può contenere fino a 1024 caratteri.

  • Piè di pagina - un campo di testo opzionale che consente fino a 60 caratteri.

  • Titolo dell'elenco: un campo pulsante con un massimo di 20 caratteri.

La sezione Elenco è composta da:

  • Titoli di sezione: campo di testo facoltativo utilizzato per categorizzare più righe con un massimo di 24 caratteri.

  • Titolo riga - campo di testo obbligatorio che viene inviato come scelta di selezione accompagnato da un pulsante di opzione con un massimo di 24 caratteri.

  • Descrizione riga: campo di testo facoltativo che fornisce un contesto aggiuntivo per gli elementi di riga con un massimo di 72 caratteri.

La configurazione di un messaggio di elenco sulla piattaforma richiederà un campo aggiuntivo: ID riga - identificatore univoco per ogni riga che ti aiuterà a identificare la scelta degli utenti.

WhatsApp
Elenco numeratoLa risposta rapida in WhatsApp è definita come elenco numerato. Quando gli utenti selezionano un numero dall'elenco di elementi, viene ricevuto il payload configurato per l'elemento.WhatsApp
Selezione elencoCon il selettore elenco, l'agente AI condivide un elenco di elementi con un cliente in base alla query. Ciò consente al cliente di selezionare gli articoli dalle opzioni fornite e rispondere con la selezione. Se la query del cliente corrisponde parzialmente, l'agente AI risponde con gli intenti che sono vicini alla query del cliente come opzioni. Le risposte alle corrispondenze parziali vengono visualizzate solo per l'opzione Selezione elenco nel canale Apple Messages for Business.Apple Messaggi per le aziende
Selettore tempoIl tipo di risposta selezione ora consente di impostare fasce orarie per la prenotazione di appuntamenti o riunioni. Ogni sezione necessita di un titolo, fuso orario e più slot. Una volta impostato per un intento, l'agente AI invia questi intervalli di tempo agli utenti affinché possano scegliere.Apple Messaggi per le aziende
SupportiQuesto modello supporta allegati in vari formati come jpeg, mp3, mp4, png, pdf e aac.Apple Messaggi per le aziende
Collegamento multimedialeL'URL del collegamento multimediale è incorporato nell'immagine o in un video che si trova in un fumetto di chat. Quando si fa clic su questo fumetto, il cliente viene reindirizzato al sito Web specificato nell'immagine o nel video.Apple Messaggi per le aziende
ModuloI messaggi Business Forms consentono di creare esperienze interattive complesse e multipagina per iOS e iPadOS utilizzando un singolo file JSON. Questa funzione aiuta le aziende a raccogliere dati dettagliati sui clienti attraverso un'interfaccia facile da usare all'interno di Apple Messaging. Consente varie interazioni senza che gli utenti debbano lasciare la chat.Apple Messaggi per le aziende
Evento personalizzatoFornisce un controllo su una conversazione durante l'interazione con l'agente di intelligenza artificiale di script.Voce

Elenco di variabili di risposta comuni

Utilizzare le variabili di risposta nella sezione Regole della finestra di progettazione delle risposte condizionali per definire le condizioni. Puoi anche usare le variabili di risposta nelle risposte dell'agente AI per personalizzare e arricchire le risposte dell'agente. Per ulteriori informazioni su come configurare le regole, vedere Creare una risposta.

Tabella 2. Variabili di risposta comuni
Nome variabile

Chiave variabile

Descrizione

Valore dell'entità

entity.<entity-name> OPPURE lastdfState.model_state.entities.<entity-name>.value

Utilizzare questa variabile per utilizzare il valore delle entità raccolte dagli utenti. Ad esempio, in un caso d'uso di prenotazione di appuntamenti in cui chiediamo all'utente la data preferita utilizzando un'entità denominata entità "Data". Date restituisce il valore fornito dall'utente.

Intento

intento O lastdfState.model_state.intent.name

Utilizzare questa variabile per restituire l'intento immesso dal cliente.

Negozio di eventi

eventStore

Utilizzare questa opzione per accedere al dizionario contenente tutti i parametri inviati nel payload degli eventi personalizzati tramite Webex Progettazione flussi di contact center.

Valori dell'archivio eventi

EventStore.<key>

Utilizzare questa opzione per accedere ai valori di chiavi specifiche inviate nei payload degli eventi personalizzati tramite Webex Contact Center Flow Designer.

Valore parametro aggiuntivo/parametro Message

extra_params.<key>

Utilizzare questa opzione per accedere alle informazioni passate in "Parametri messaggio" nel nodo Agente AI per gli agenti di script. Ad esempio, se una chiave 'user_plan' viene passata nel nodo dell'agente AI, è accessibile come extra_params.user_plan. Questi valori vengono mantenuti per un solo turno di messaggio, ovvero il valore della chiave può essere utilizzato solo nella risposta al messaggio che accompagna questi parametri del messaggio.

Parametri aggiuntivi

extra_params

Utilizzare questa opzione per accedere al dizionario contenente tutti i valori passati in 'Parametri messaggio' nel nodo Agente AI per gli agenti di script.

Data store consumer/Parametri cliente

consumerDataStore.extra_params

Utilizzare questa opzione per accedere al dizionario contenente tutti i parametri passati in "Parametri cliente" nel nodo Agente AI per gli agenti di script.

Archivio dati consumer/Valori dei parametri Customer

consumerDataStore.extra_params.<chiave>

Utilizzare questa opzione per accedere alle informazioni passate in "Parametri cliente" nel nodo Agente AI per gli agenti di script. Ad esempio, se una chiave 'user_name' viene passata nel nodo dell'agente AI, è accessibile come consumerDataStore.extra_params.nome_utente

Intento precedente/Ultimo intento attivo

lastdfState.previous_intent_model_state.intent.name

Utilizzare questa variabile per accedere al nome dell'intento attivo nella conversazione prima dell'intento corrente.

Matrice di contesto

lastdfState.context

Utilizzare questa opzione per accedere ai nomi di tutti i contesti presenti nella conversazione sotto forma di array.

Durata del contesto

LastdfState.context.<context-name>

Recupera il valore della durata di un contesto specifico.

TUID del cliente

consumerData.uid

Utilizzare questa variabile per accedere all'ID univoco del cliente nelle condizioni di risposta o nel contenuto dell'agente AI. Per i canali digitali, l'UID è configurato nel flusso e varia in base al canale.

Variabile archivio dati

dataStore.<key>

Utilizzare questa variabile per accedere alle variabili personalizzate archiviate a livello di sessione.

Trasferimento dell'agente tramite flag delle regole

messageStore.agent_handover_by_rules

Utilizzare questa variabile per verificare se la conversazione è stata consegnata a un essere umano in base a una qualsiasi delle regole di trasferimento dell'agente.

Chiave modello corrispondente

messageStore.templateKey

Utilizzare questa variabile per accedere al nome della risposta corrente.

Testo NLP

nlp.text

Utilizzare questa variabile per accedere alla query del cliente non elaborata.

Query elaborata

nlp.processed_query

Utilizzare questa variabile per accedere alla query del cliente elaborata.

ID transazione

transaction_id

Utilizzare questa variabile per accedere all'ID transazione.

Oltre a quanto sopra, esistono alcuni altri oggetti dati accessibili come variabili di risposta. Questi includono messageStore, newdfState e lastdfState che contengono metadati sulla risposta dell'agente. Gli sviluppatori possono stamparlo nelle loro risposte per accedere ai dettagli e utilizzare qualsiasi parametro di questi dizionari nelle loro risposte. Tuttavia, nella maggior parte dei casi d'uso, le variabili elencate nella tabella precedente sono sufficienti per creare il tuo agente.