L’interazione tra il motore di NLU, la piattaforma Tellya e l’utente finale comporta il passaggio tra i vari sistemi di un payload JSON contenente le informazioni relative a tale interazione, alcune legate alla conversazione (come ad esempio la domanda posta dall’utente o la risposta fornita dall’agente virtuale), altre relative a componenti tecniche (ad esempio l’identificativo della sessione).
In numerose occasioni è utile poter utilizzare tali valori come variabili all’interno dei connettori e delle risposte dinamiche. Un esempio è la configurazione del connettore Data Loss Prevention, affinché provveda ad oscurare solo i dati sensibili contenuti all’interno della risposta fornita all’utente.
Ogni variabile viene richiamata tramite il carattere speciale “$” posto prima del nome stesso della variabile.
| Variabile | Descrizione |
|---|---|
| $sessionId | Identificativo della sessione conversazionale |
| $inputContexts | Contesti posti in input al motore di NLU |
| $userQuery | Input fornito dall’utente |
| $outputText | Risposte testuali fornite dall’agente virtuale |
| $outputMessages | Payload completo di tutte le informazioni che costituiscono l’output di risposta |
| $outputContexts | Contesti generati in output dal motore di NLU |
| $intentName | Nome dell’intento riconosciuto dal motore di NLU |
| ${contextName.parameterName} | Recupera il valore del parametro paramterName contenuto all’interno del contesto contextName |
| ${{outputParameters}} | Recupera il valore contenuto all’interno del parametro parameterName. |
| $actionName | Nome dell’azione definita nel motore di NLU |
| $userHistoryMessages | Recupera tutti i messaggi della sessione conversazionale corrente (formato JSON) |
| $today | Recupera data e ora correnti |
| $timestamp | Recupera il timestamp |
| $originalUserQuery | Recupera l’interazione originale dell’utente |
Esempio di configurazione
Le variabili connettori possono ad esempio essere utilizzate durante la configurazione del connettore Data Loss Prevention (DLP), come mostrato in figura.
In questo caso, ad ogni interazione, il connettore DLP, verificherà all’interno della domanda posta in input dall’utente (richiamata con la variabile $userQuery) la presenza di eventuali dati da oscurare.