Utilizzo delle variabili per gestire le informazioni di conversazione

Quando i clienti rispondono al tuo assistente AI, forniscono informazioni su se stessi e sulle loro esigenze. Il tuo assistente AI memorizza queste informazioni, insieme ad altre relative alla conversazione, sotto forma di variabili. Il tuo assistente AI può utilizzare delle variabili per offrire un'esperienza più personalizzata e su misura, consentendo agli utenti di trovare rapidamente le soluzioni di cui hanno bisogno.

Le variabili sono uno strumento potente che puoi utilizzare per creare un assistente AI più efficiente. Le variabili rendono possibili tutti i seguenti vantaggi:

  • Personalizzazione. Le migliori esperienze con gli assistenti virtuali basati sull'intelligenza artificiale sono mirate e personalizzate per ogni cliente. Quando un assistente AI saluta un cliente dicendo: «Ciao, Frank! Bentornato", dice a Frank che ricorda il suo nome e che gli ha già parlato in passato. Memorizzando questo tipo di informazioni in variabili e poi richiamandole nei messaggi generati dal tuo assistente AI, puoi personalizzare la conversazione e contribuire a rendere il tuo assistente AI più simile a un essere umano.

  • Accelerazione. Nel corso di una conversazione, i clienti rispondono a domande e fanno scelte. Queste risposte dei clienti vengono memorizzate come variabili, che il tuo assistente AI potrà poi utilizzare per guidare la conversazione. Scegliendo i passaggi giusti e non facendo perdere tempo ai vostri clienti, potrete portarli il più rapidamente possibile alla soluzione giusta.

  • Modularità. Alcune informazioni possono essere utili per diversi scopi (ad esempio, il saldo del conto corrente di un cliente o le informazioni di contatto). Invece di recuperare o ricalcolare queste informazioni in più posizioni, è possibile farlo una sola volta, utilizzando una variabile per memorizzare il risultato e quindi accedervi ovunque sia necessario.

  • Privacy. La privacy dei dati dei clienti è fondamentale per tutte le aziende. Nel tuo assistente AI puoi mascherare le variabili per proteggere la privacy delle informazioni condivise. Quando si maschera una variabile per renderla privata, l 'assistente AI nasconde le informazioni riservate contenute nei dati inseriti dall'utente o nelle risposte dell 'assistente AI sostituendole con asterischi nei registri delle conversazioni.

La funzione di mascheramento delle informazioni riservate dei clienti è disponibile solo per le operazioni eseguite tramite l'assistente AI.

Quando la sessione di un utente scade durante una conversazione nell'integrazione della chat web, l 'assistente AI perde le variabili private mascherate. Questo perché la chat web non può copiare le variabili in una nuova sessione. Per ulteriori informazioni, consultare la sezione "Copia dello stato della sessione ".

Una variabile è semplicemente un contenitore con un nome che contiene un'informazione; facendo riferimento a questo contenitore tramite il suo nome, il tuo assistente IA può memorizzare o recuperare l'informazione durante l'esecuzione. Ad esempio, una variabile denominata account_balance potrebbe contenere il saldo corrente del conto del cliente, un valore che l 'assistente AI può aggiornare o recuperare all'occorrenza.

I dati memorizzati da una variabile sono caratterizzati dal tipo di dati che contiene, come un testo, un valore numerico, una data o anche un elenco di valori multipli. Le operazioni che si possono eseguire con una variabile variano a seconda del suo tipo di dati.

Variabili di azione e variabili di sessione

L'assistente AI supporta due categorie di variabili:

  • Variabili d'azione: Quando una fase raccoglie informazioni dal cliente, la risposta del cliente viene automaticamente memorizzata in una variabile d'azione. Si può pensare alle variabili d'azione come a una memoria a breve termine: esse persistono solo durante l'azione corrente.

Il nome di una variabile azione è sempre il nome del passo che definisce la risposta del cliente. (Non è possibile modificare il nome di una variabile d'azione) Per esempio, supponiamo di definire un passo che chieda "Quando sei nato?" e accetta un valore di data come risposta. La risposta del cliente viene memorizzata automaticamente in una variabile d'azione chiamata 'When were you born?, alla quale si può accedere da qualsiasi passaggio successivo della stessa azione.

È possibile rendere privata una variabile d'azione selezionando la casella di controllo Proteggi i dati raccolti in questa fase nelle impostazioni della risposta del cliente.

  • Variabili di sessione: Un valore che non è necessariamente legato a una particolare azione può essere memorizzato come variabile di sessione. Le variabili di sessione costituiscono una memoria a lungo termine: rimangono attive per tutta la durata dell'interazione dell'utente con l 'assistente AI, e il tuo assistente AI può farvi riferimento da qualsiasi azione.

È possibile creare una variabile di sessione per memorizzare il valore di una variabile azione, se si vuole mantenere il valore disponibile per altre azioni. È anche possibile definire una variabile di sessione in base a un'altra variabile di sessione o utilizzando un valore definito in un'espressione. Oltre alle variabili create dall'utente, l'assistente AI mette a disposizione una serie di variabili di sessione integrate per valori globali come l'ora e la data correnti.

Per nascondere le informazioni riservate del cliente nei registri di conversazione, è possibile selezionare la casella di controllo Proteggi i dati memorizzati in questa variabile quando si crea o si modifica una variabile di sessione.

Le variabili di sessione possono aiutarti a modularizzare il tuo assistente AI, poiché ti consentono di scrivere una singola azione che raccoglie le informazioni necessarie in più punti. Ad esempio, si potrebbe avere un'azione di saluto che raccoglie informazioni di base sul cliente e memorizza le risposte in variabili di sessione, a cui ogni azione può accedere.

Una variabile di sessione creata persiste solo durante una singola sessione. Al termine della sessione, il valore della variabile viene cancellato. La durata di una sessione dipende dal modo in cui i clienti accedono al tuo assistente IA e da come quest 'ultimo è configurato.

Creazione di una variabile di sessione

Per aggiungere una variabile di sessione a cui si può accedere da qualsiasi azione:

  1. Nella pagina Azioni, fare clic su Variabili > Create dall'utente. L'elenco mostra tutte le variabili di sessione che hai creato per il tuo assistente AI.

  2. Fare clic su Nuova variabile.

È anche possibile creare una nuova variabile di sessione dall'editor dei passi. Per ulteriori informazioni, vedere Memorizzazione di un valore in una variabile di sessione.

  1. Nel campo Nome, digitare un nome per la variabile di sessione.

Quando si aggiunge il nome, viene generato un ID. Eventuali spazi nel nome sono sostituiti da trattini bassi (_) nell'ID.

  1. Opzionale: Aggiungere un tipo per impostare il tipo di risposta della variabile. (Per ulteriori informazioni sui tipi di risposta, vedere Scelta del tipo di risposta)

Da questo campo è possibile selezionare una qualsiasi delle risposte salvate create. Per ulteriori informazioni sulle risposte salvate, vedere Salvataggio e riutilizzo delle risposte dei clienti.

Oltre ai tipi elencati, una variabile può essere creata anche come array. Per creare una variabile array, selezionare Any come tipo e, nel passaggio successivo, definire un valore iniziale che utilizzi l'espressione " [] per rappresentare un array vuoto.

  1. Opzionale: Aggiungere un valore iniziale per impostare il valore di partenza della variabile all'inizio di ogni sessione utente. Ad esempio, i tuoi clienti possono utilizzare un assistente basato sull'intelligenza artificiale per effettuare acquisti. Si potrebbe inizializzare una variabile "Pagamento dovuto" con un valore iniziale pari a 0, per poi aumentarlo man mano che il cliente ordina gli articoli.

Per specificare un oggetto complesso o una matrice come valore iniziale, o per calcolare il valore iniziale in base ad altre variabili, è possibile scrivere un'espressione. Per ulteriori informazioni sulla scrittura delle espressioni, consultare la sezione "Scrittura delle espressioni".

  1. Opzionale: Aggiungere una descrizione.

  2. Facoltativo: Selezionare la casella di controllo Proteggi i dati memorizzati in questa variabile nella sezione Privacy se la variabile di sessione contiene informazioni riservate.

  3. Fare clic su Applica.

Variabili integrate

Oltre alle variabili create dall'utente, l'assistente AI mette a disposizione una serie di variabili integrate a cui è possibile accedere da qualsiasi azione. In fase di esecuzione, queste variabili vengono impostate automaticamente con i valori appropriati. Ad esempio, la variabile di sessione "Ora corrente" fornisce sempre l'ora corrente nel fuso orario dell'utente, al momento dell'interazione con il cliente.

Per visualizzare queste variabili, fare clic su Variabili nella pagina Azioni.

  • La pagina "Set by assistant " mostra le variabili di sessione integrate che vengono fornite automaticamente per ogni assistente AI.

  • La pagina "Imposta per integrazione" mostra le variabili fornite automaticamente dall'integrazione che il cliente sta utilizzando per connettersi all'assistente AI. (Queste variabili non vengono impostate se non è collegata alcuna integrazione)

Impostato dall'assistente:

Tabella 1. Variabili impostate dall'assistente

Nome variabile

ID variabile

Descrizione

Esempi

Divagazione da

digressed_from

Ultima azione prima della digressione del cliente (o null se non è stata digressione)

Pagare la bolletta

Adesso

now

La data e l'ora correnti nel fuso orario dell'utente.

2021-08-11T11:28:02

Ora corrente

current_time

L'ora corrente nel fuso orario dell'utente.

11:28:02

Data corrente

current_date

La data corrente nel fuso orario dell'utente.

2021-08-11

Motivo di ripiego

fallback_reason

Il motivo per cui un utente viene indirizzato all'azione di ripiego

Convalida del passo fallita - Agente richiesto - Nessuna azione corrispondente

Non contano le partite di azione

no_action_matches_count

Rappresenta il conteggio dei tentativi consecutivi di ingresso non riconosciuti del cliente

3

Cronologia delle sessioni [ IBM Cloud ]

sessione_storia

I 24 messaggi più recenti della conversazione del cliente. Per ulteriori informazioni, vedere Cronologia delle sessioni

{u : 'book a flight', n : true}, {a : 'certo! da dove?]

Imposta per integrazione:

Tabella 2. Variabili definite dall'integrazione

Nome variabile

ID variabile

Descrizione

Esempio

Fuso orario

timezone

Il fuso orario dell'utente specificato dall'integrazione o dal client API. Il fuso orario predefinito (se non specificato dall'integrazione) è il Tempo universale coordinato.

America/New_York

Impostazioni internazionali

locale

Il locale dell'utente impostato dall'integrazione o dal client API. Il locale può influenzare la comprensione e la formattazione di date, orari e numeri.

en-gb

Nome canale

channel_name

Il nome del canale con cui l'utente sta interagendo.

Web chat

Memorizzazione di un valore in una variabile di sessione

Ogni azione può memorizzare un valore in una variabile di sessione, in modo che sia disponibile per altre azioni. Per memorizzare un valore in una variabile di sessione:

  1. All'interno di un passo, fare clic su Imposta valori variabili.

  2. Fare clic su Imposta nuovo valore.

  3. Nell'elenco a discesa Imposta, le scelte possibili sono:

Tabella 3. Impostare i valori delle variabili

Possibilità di scelta

Descrizione

Variabile di sessione

La variabile di sessione in cui si vuole memorizzare il valore. Il nuovo valore sostituisce qualsiasi valore precedente memorizzato.

Variabile di integrazione

La variabile di sessione in cui si vuole memorizzare il valore. Il nuovo valore sostituisce qualsiasi valore precedente memorizzato.

Espressione

Scrivere direttamente un'espressione senza scegliere prima una variabile. Per ulteriori informazioni, consultare la sezione "Scrittura delle espressioni".

+ Nuova variabile di sessione

È possibile creare una nuova variabile di sessione, che verrà aggiunta all'elenco delle variabili di sessione dell'assistente AI. Per ulteriori informazioni, consultare la sezione Creazione di una variabile di sessione.

  1. Nell'elenco a discesa A, le scelte variano a seconda del tipo di variabile che si sta impostando. Le scelte possibili includono:

Tabella 4. Impostare i valori delle variabili

Possibilità di scelta

Descrizione

Valore scalare per tipo

Impostare un valore specifico per ogni tipo di variabile. La scelta varia a seconda del tipo di variabile. Ad esempio, per una variabile data, la scelta è Inserisci una data e si può usare un selezionatore di date per impostare una data. Vengono visualizzate altre opzioni per booleano, conferma, valuta, data, testo libero, numero, percentuale e tempo.

Espressione

Scrivete un'espressione per definire il valore della variabile di sessione. Per ulteriori informazioni sulle espressioni, consultare la sezione "Scrittura delle espressioni".

Variabili dell'azione

Selezionare una variabile d'azione per utilizzare il valore di una risposta del cliente in un'altra fase. Le scelte elencate corrispondono al tipo di variabile che si desidera impostare.

Variabili della sessione

Selezionare un'altra variabile di sessione per utilizzarne il valore. Le scelte elencate corrispondono al tipo di variabile che si desidera impostare.

Assistenti variabili

Selezionare una variabile di sistema incorporata per utilizzarne il valore. Le scelte elencate corrispondono al tipo di variabile che si desidera impostare.

Variabili di integrazione

Se si imposta una variabile di integrazione, è possibile scegliere altre variabili di integrazione come valore.

  1. Per impostare più valori di variabili nello stesso passaggio, fare clic su Imposta nuovo valore.

Utilizzare le variabili per gestire il flusso di conversazione

Uno dei modi in cui è possibile utilizzare le variabili è quello di scegliere il percorso corretto della conversazione, in base alle risposte del cliente e ad altri valori disponibili in fase di esecuzione. È possibile farlo definendo condizioni di passo, che determinano se un passo specifico di un'azione viene eseguito in base a condizioni di runtime.

Definendo una condizione basata su una variabile di azione, è possibile controllare se un passaggio viene eseguito in base alla risposta del cliente a un passaggio precedente. È anche possibile creare condizioni di passo basate su variabili di sessione, che possono memorizzare informazioni da altre azioni.

Per ulteriori informazioni sulle condizioni di passaggio, vedere Definizione delle condizioni di passaggio.

Utilizzo di variabili per personalizzare la conversazione

Puoi anche inserire delle variabili nei messaggi del tuo assistente AI, facendo riferimento in modo dinamico alle informazioni raccolte durante la conversazione. Questo è utile per verificare le informazioni fornite dal cliente (ad esempio, You want to transfer $153.14 to your checking account. Is that correct?) e per personalizzare semplicemente la conversazione, rendendola più umana (Hi, John. How can I help you today?).

Per fare riferimento a una variabile nelle frasi pronunciate dal tuo assistente AI :

  1. Nel campo Assistente dice, iniziare a digitare il testo della risposta.

  2. Quando arrivi al punto in cui desideri inserire un riferimento a una variabile, digita il simbolo del dollaro ($) oppure fai clic sull'icona "Inserisci una variabile " (Inserire l'icona di una variabile). Verrà visualizzato un elenco con le variabili tra cui puoi scegliere.

  3. Fare clic su una variabile per aggiungere un riferimento ad essa nel testo.

Quando si fa riferimento a una variabile, questa viene visualizzata con un formato predefinito nella risposta dell 'assistente AI. Il formato della variabile potrebbe differire dal modo in cui il valore è memorizzato; ad esempio, un valore di 2021-08-11 data viene visualizzato come August 11, 2021 per impostazione predefinita.

I formati predefiniti sono i seguenti:

Tabella 5. Formati predefiniti per le variabili

Immettere

Formato

Esempi

Opzioni

A scelta dell'utente

Yes No

Numero

Solo numeri

1000

Data

dd MMM, yyyy

Jun 30, 2021

Ora

H:MM:SS (ora)

5:15:00 PM

Valuta

Solo numeri, nessun simbolo di valuta

20

Percentuale

Solo numero, nessun simbolo di percentuale

20

Testo libero

Come inserito dall'utente

Please check that the apples aren't bruised

Quando si crea una risposta per un assistente AI che include variabili, è necessario unire più parti (stringhe di testo e variabili). Una singola risposta non può essere composta da più di 30 parti concatenate (ad esempio, 15 variabili e 15 stringhe di testo).

Espressioni di riferimento

Se si vuole fare riferimento a un valore dinamico calcolato con un'espressione, è necessario assegnarlo prima a una variabile di sessione. (Per ulteriori informazioni su come fare, vedere Memorizzazione di un valore in una variabile di sessione) È quindi possibile fare riferimento alla variabile di sessione nel campo Assistant says.

Si noti che la <?...?> sintassi per fare riferimento alle espressioni nei risultati dell'assistente AI non è supportata nelle azioni.