{"id":58,"date":"2020-11-06T11:47:02","date_gmt":"2020-11-06T11:47:02","guid":{"rendered":"https:\/\/docs.tellya.ai\/?post_type=ht_kb&p=58"},"modified":"2022-08-26T08:29:50","modified_gmt":"2022-08-26T08:29:50","slug":"variabili-connettori","status":"publish","type":"ht_kb","link":"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/variabili-connettori\/","title":{"rendered":"Variabili di sistema"},"content":{"rendered":"\n

L\u2019interazione tra il motore di NLU, la piattaforma Tellya e l\u2019utente 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\u2019utente o la risposta fornita dall\u2019agente virtuale), altre relative a componenti tecniche (ad esempio l\u2019identificativo della sessione).<\/p>\n\n\n\n

In numerose occasioni \u00e8 utile poter utilizzare tali valori come variabili all\u2019interno dei connettori e delle risposte dinamiche. Un esempio \u00e8 la configurazione del connettore Data Loss Prevention, affinch\u00e9 provveda ad oscurare solo i dati sensibili contenuti all\u2019interno della risposta fornita all\u2019utente.<\/p>\n\n\n\n

Ogni variabile viene richiamata tramite il carattere speciale \u201c$\u201d posto prima del nome stesso della variabile.<\/p>\n\n\n\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Variabile<\/th>\nDescrizione<\/th>\n<\/tr>\n<\/thead>\n
$sessionId<\/td>\nIdentificativo della sessione conversazionale<\/td>\n<\/tr>\n
$inputContexts<\/td>\nContesti posti in input al motore di NLU<\/td>\n<\/tr>\n
$userQuery<\/td>\nInput fornito dall\u2019utente<\/td>\n<\/tr>\n
$outputText<\/td>\nRisposte testuali fornite dall’agente virtuale<\/td>\n<\/tr>\n
$outputMessages<\/td>\nPayload completo di tutte le informazioni che costituiscono l’output di risposta<\/td>\n<\/tr>\n
$outputContexts<\/td>\nContesti generati in output dal motore di NLU<\/td>\n<\/tr>\n
$intentName<\/td>\nNome dell\u2019intento riconosciuto dal motore di NLU<\/td>\n<\/tr>\n
${contextName.parameterName}<\/td>\nRecupera il valore del parametro paramterName <\/em>contenuto all\u2019interno del contesto contextName<\/em><\/td>\n<\/tr>\n
${{outputParameters}}<\/td>\nRecupera il valore contenuto all\u2019interno del parametro parameterName<\/em>.<\/td>\n<\/tr>\n
$actionName<\/td>\nNome dell\u2019azione definita nel motore di NLU<\/td>\n<\/tr>\n
$userHistoryMessages<\/td>\nRecupera tutti i messaggi della sessione conversazionale corrente (formato JSON)<\/td>\n<\/tr>\n
$today<\/td>\nRecupera data e ora correnti<\/td>\n<\/tr>\n
$timestamp<\/td>\nRecupera il timestamp<\/td>\n<\/tr>\n
$originalUserQuery<\/td>\nRecupera l’interazione originale dell’utente<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n\n\n\n

Esempio di configurazione<\/h2>\n\n\n\n

Le variabili connettori possono ad esempio essere utilizzate durante la configurazione del connettore Data Loss Prevention (DLP), come mostrato in figura.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

In questo caso, ad ogni interazione, il connettore DLP, verificher\u00e0 all’interno della domanda posta in input dall’utente (richiamata con la variabile $userQuery) la presenza di eventuali dati da oscurare.<\/p>\n","protected":false},"excerpt":{"rendered":"

L\u2019interazione tra il motore di NLU, la piattaforma Tellya e l\u2019utente 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\u2019utente o la risposta fornita dall\u2019agente virtuale), altre relative a…<\/p>\n","protected":false},"author":2,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[22],"ht-kb-tag":[],"_links":{"self":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/58"}],"collection":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/comments?post=58"}],"version-history":[{"count":16,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/58\/revisions"}],"predecessor-version":[{"id":1418,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/58\/revisions\/1418"}],"wp:attachment":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/media?parent=58"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=58"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=58"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}