Gli intent hanno un gestore delle risposte integrato che può restituire le risposte dopo la corrispondenza dell'intent. Questa funzionalità supporta solo le risposte statiche, anche se puoi utilizzare i riferimenti ai parametri per renderle in qualche modo dinamiche. Questo è utile per riepilogare le informazioni fornite dall'utente finale. Ad esempio, la risposta all'intent potrebbe essere simile alla seguente: "Ok, ho prenotato una camera per te il giorno $date".
In alcuni casi, è sufficiente. Se il codice deve eseguire un'azione o creare una risposta più dinamica, devi utilizzare una delle opzioni di risposta dinamica riportate di seguito. In genere, gli agenti utilizzano una combinazione di risposte statiche e dinamiche.
È possibile fornire più tipi di risposte. Il tipo di risposta di base è una risposta di testo. Sono disponibili altri tipi di risposte (immagini, audio, voce sintetizzata e così via), alcuni dei quali sono piattaforma-specifici.
Se definisci più di una variante di risposta per un'intenzione, il tuo agente ne selezionerà una a caso. Aggiungi diverse varianti di risposta per rendere il tuo agente più colloquiale.
Quando crei un agente, devi fornire i dati di risposta per ogni intent. Quando utilizzi l'API o il servizio di evasione per interagire con Dialogflow, tecnicamente potresti non dover fornire dati di risposta, perché entrambi questi metodi possono generare dinamicamente qualsiasi risposta. Tuttavia, se vuoi utilizzare il simulatore per i test o definire intent con una risposta semplice, devi fornire i dati di risposta.
Come regola generale, le risposte all'intent devono chiedere all'utente finale di fornire un'espressione che corrisponda a un altro intent. Le tue risposte devono anche guidare l'utente finale a fornire dati specifici. Ad esempio, una domanda come "In che città sei nato?" è meglio di una domanda più aperta come "Dove sei nato?".
Dove trovare questi dati
Quando crei un agente, è più comune utilizzare la console Dialogflow ES (visita la documentazione, apri la console). Le istruzioni riportate di seguito riguardano l'utilizzo della console. Per accedere ai dati delle risposte agli intent:
- Vai alla console Dialogflow ES.
- Seleziona un agente.
- Seleziona Intenti nel menu della barra laterale a sinistra.
- Seleziona un'intenzione.
- Scorri verso il basso fino alla sezione Risposte.
Se stai creando un agente utilizzando l'API anziché la console, consulta il riferimento Intent. I nomi dei campi dell'API sono simili a quelli della console. Le istruzioni riportate di seguito mettono in evidenza eventuali differenze importanti tra la console e l'API.
Piattaforme di risposta
Ogni risposta è definita per la piattaforma Predefinita (indicata come PLATFORM_UNSPECIFIED
nell'API) o per una specifica piattaforma di integrazione.
Se non utilizzi un'integrazione, tutte le risposte possono utilizzare la piattaforma predefinita.
Se utilizzi le integrazioni, ciascuna può avere una risposta univoca o può essere configurata per utilizzare la risposta predefinita.
Per ulteriori informazioni sulle risposte specifiche della piattaforma, consulta la sezione Messaggi di risposta avanzata.
Creare risposte predefinite
Per creare risposte predefinite:
- Seleziona Predefinito o una piattaforma specifica.
- Se il tipo di risposta desiderato (ad es. Risposta di testo) non è già presente nell'elenco, fai clic su Aggiungi risposte e seleziona il tipo di risposta.
- Inserisci le informazioni richieste per la risposta.
- Fai clic su Salva.
Risposte dinamiche con adempimento
Con l'utilizzo del completamento, puoi creare risposte dinamiche. Per ulteriori informazioni, consulta i documenti relativi all'evasione degli ordini.
Risposte dinamiche con l'API
Con l'API puoi creare risposte dinamiche. Per ulteriori informazioni, consulta la panoramica dell'API.
Caratteri speciali
Alcuni caratteri speciali richiedono l'uso del codice di escape nella risposta.
Per utilizzare il simbolo del dollaro $
o il simbolo numerico #
in una risposta,
aggiungi parentesi graffe {}
ai contenuti che seguono immediatamente il simbolo.
Ad esempio:
${100}
si risolve in$100
${$number}
si risolve in$100
, dove$number
è un riferimento a un parametro con un valore pari a 100#{hello}
si risolve in#hello
Per utilizzare le parentesi graffe {}
in una risposta, usa le parentesi graffe doppie.
Ad esempio:
{{hello}}
si risolve in{hello}
Gestione dei valori dei parametri vuoti
Se l'intent ha un parametro che può essere risolto in un valore vuoto, devi fornire almeno una variante di risposta che non utilizzi questo parametro.
Ad esempio, se l'intent ha due parametri (p1
e p2
)
e uno o entrambi potrebbero essere vuoti,
devi fornire almeno quattro varianti di risposta:
- Ok. Hai detto $p1 e $p2.
- Ok. Hai detto $p1.
- Ok. Hai detto $p2.
- Ok.