Uso dei parametri negli agenti AI avanzati

Add-on

AI agents - Advanced

In agenti AI - Avanzati, i parametri sono informazioni che puoi raccogliere e usare per personalizzare i workflow agenti AI . In particolare, puoi sfruttare i parametri nei blocchi condizionali, nei segmentie nelle integrazioni API.

Questo articolo include i seguenti argomenti:

Parametri disponibili
Operatori disponibili

Parametri disponibili

I parametri possono provenire da tre origini:

Parametri della piattaforma CRM
Parametri dei dati di sessione
Parametri di integrazione back-end

Parametri della piattaforma CRM

Le piattaforme CRM in genere memorizzano informazioni sui clienti come nome e indirizzo email. Queste informazioni possono essere recuperate dalla piattaforma CRM e salvate per l’uso in blocchi condizionali.

Per recuperare informazioni dalla piattaforma CRM , aggiungi un’azione associata all’evento “Conversazione iniziata” per raccogliere i dati dal tuo CRM quando inizia una conversazione. Le informazioni verranno raccolte per ogni nuova conversazione e applicate a tutti i dialoghi all’interno del tuo agenti AI.

Parametri dei dati di sessione

I dati di sessione si riferiscono alle informazioni fornite dai clienti durante una sessione di messaggistica con l’ agenti AI. Aggiungi un’azione a livello di blocco a un flusso di dialogo per recuperare i dati della sessione e salvarli come valore di parametro.

Questi parametri di sessione sono raccolti per impostazione predefinita:

Parametro	Esempio di caso d’uso
{{lastDetectedLanguage}}	Fornisci la risposta del sistema in lingua non supportata nella lingua dell’utente.
{{active_language}}	Crea risposte specifiche per la lingua. Come valore del parametro, devi usare l’ID della lingua, non il nome. Puoi trovare l’ID nelle Impostazioni > Impostazioni agenti AI > Lingue e selezione di una lingua.
{{chatTranscript}}	Allega la trascrizione della conversazione a un ticket per l’escalation via email.
{{lastVisitorMessage}}	Ripeti le parole del cliente, spesso in una risposta predefinita, come ad esempio: “Temo di non sapere nulla di {{lastVisitorMessage}} ancora.”
{{integrationId}}	Indirizza i messaggi in ingresso agli agenti AI pertinenti con regole di indirizzamento basate sull’origine (`integrationId`) del messaggio in ingresso. Visualizza a schermo intero
{{confidence_score}}	Basa la risposta sulla soglia di affidabilità del riconoscimento dello scopo. `Confidence_score` viene arrotondato per eccesso o per difetto a numeri interi (interi). Visualizza a schermo intero
{{lastResolution}}	Imposta un flusso di dialogo diverso in base all’ultimo stato di soluzione personalizzato: `Undefined`, `Informed`, `Resolved`, `Not Resolved`, `Escalated To Agent`, o `Escalated via Email`e invialo al tuo CRM come tag al momento dell’escalation.

Quando crei parametri di sessione personalizzati con un’azione, non usare lo stesso nome di uno di questi parametri di sistema. Verrà generato un errore e i dati non verranno recuperati.

Anche le entità sono considerate parametri dei dati di sessione. Il nome dell’entità è il nome del parametro. Tutte le informazioni acquisite tramite le entità vengono memorizzate come dati di sessione fino a due ore dopo l’inattività della conversazione.

Parametri di integrazione back-end

L’ agenti AI può anche recuperare informazioni da un’integrazione API personalizzata per creare flussi di dialogo personalizzati.

Operatori disponibili

La tabella seguente elenca gli operatori disponibili, ciascuno dei quali rientra in uno dei tipi seguenti:

Stringa: Parola
Booleano: Vero o falso
Array/elenco: Elenco separato da virgole
Intero: Numero intero
Mobile: Numero decimale

Operatore	Usa per	Esempio	Tipo di parametro previsto	Tipo di valore condizione
`is / Is not`	Valori singoli	`country` `is` `Germany`	stringa	stringa o numero intero
`Is / Is not (boolean)`	Dichiarazioni vere o false	`loggedIn` `Is` `True`	booleano	booleano
`In / Not in`	Una condizione OR con più valori separati da una virgola	`country` `In` `Germany, Japan, Finland`	stringa	array
`Array includes / does not include`	Ricerca di un valore particolare in un elenco di valori memorizzati come array nella sessione	`tags_Array` `Array` `Includes item` `VIP`	array	stringa
`Text includes / does not include`	Ricerca di una sottostringa, come il prefisso internazionale in un URL, in base ai dati testuali nella sessione	`URL text` `Includes` `fr`	stringa	stringa
`Exists / Does not exist`	Verifica della presenza di un parametro nella sessione, senza un valore specifico	`email` `Exists` `country: ''` , `null`o completamente non definito	qualsiasi	N/D
`Starts with / Does not start with`	Valori di stringa singola	`country` `Starts with` `united`	stringa	stringa
`Greater than` `Greater than or equal` `Less than` `Less than or equal`	Tutti i tipi di numeri (interi e float), con riconoscimento del contenuto e azioni, incluso il valore Supera un valore impostato Supera o è uguale a un valore impostato È inferiore a un valore impostato È minore o uguale a un valore impostato	`Number` `Greater than or equal` `9`	intero o float	intero o float
`Else`	Il fallback, deve sempre essere aggiunto come ultima condizione	N/D	qualsiasi cosa	N/D

Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.

Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.