Molte delle piattaforme di integrazione supportano messaggi di risposta avanzati specifici per la piattaforma. Questi messaggi possono essere utilizzati per fornire all'utente finale risposte che non siano solo testuali. Puoi scegliere tra una varietà di tipi di risposta. Ad esempio, puoi mostrare immagini, riprodurre audio o fornire pulsanti. Ogni piattaforma supporta un sottoinsieme dei tipi di risposta disponibili.
Dove trovare questi dati
Quando crei un agente, è più comune utilizzare la console di Dialogflow ES (consulta la documentazione, apri la console). Le istruzioni riportate di seguito si concentrano sull'utilizzo della console. Per accedere ai dati delle risposte degli intent:
- Vai alla console di Dialogflow ES.
- Seleziona un agente.
- Seleziona Intent nel menu della barra laterale a sinistra.
- Seleziona un intent.
- Scorri verso il basso fino alla sezione Risposte.
Se stai creando un agente utilizzando l'API anziché la console, consulta il riferimento agli intent. I nomi dei campi API sono simili ai nomi dei campi della console. Le istruzioni riportate di seguito evidenziano eventuali differenze importanti tra la console e l'API.
Aggiungere messaggi di risposta avanzati
La sezione Risposte contiene schede per ogni piattaforma, inclusa una piattaforma predefinita. Puoi definire le risposte per la piattaforma predefinita, che possono essere utilizzate su tutte le piattaforme.
Puoi definire le risposte per le schede specifiche della piattaforma, che funzionano solo sulle piattaforme corrispondenti. Puoi anche scegliere di utilizzare le risposte predefinite per una piattaforma specifica, in modo da non dover creare risposte testuali duplicate per tutte le piattaforme.
Per aggiungere messaggi di risposta avanzati:
- Seleziona la scheda della piattaforma che ti interessa. Se la scheda della piattaforma che ti interessa non viene visualizzata, fai clic sul pulsante Aggiungi add e selezionala.
- Fai clic sul pulsante Aggiungi risposte. Un menu a discesa mostra i tipi di risposta supportati dalla piattaforma.
- Scegli il tipo di risposta. Questi sono descritti di seguito.
- Inserisci i campi per il tipo di risposta selezionato.
- Aggiungi altre schede e risposte della piattaforma, se necessario. Puoi aggiungere fino a 10 messaggi ordinati in ogni scheda.
- Fai clic su Salva.
Puoi utilizzare riferimenti ai parametri nelle risposte per fare riferimento ai parametri forniti dall' utente finale o agli eventi in fase di runtime.
Risposte testuali
Per impostazione predefinita, le risposte testuali inviano una risposta testuale all'utente finale.
Se la sintesi vocale è abilitata per un agente o richiesta dalle richieste di rilevamento dell'intent, il testo fornito viene utilizzato per sintetizzare la voce e riprodurre l'audio. In questo caso, il testo fornito può facoltativamente utilizzare Speech Synthesis Markup Language (SSML).
I campi sono:
- Elenco di voci di testo o SSML
Quando inserisci una risposta, premi Maiusc + Invio per inserire un'interruzione di riga o semplicemente Invio per inserire un'altra risposta testuale.
Si applicano le seguenti limitazioni:
- Massimo 300 voci di testo per risposta testuale
Risposte con immagini
Le risposte con immagini inviano un'immagine all'utente finale. Contengono i seguenti campi:
- URL accessibile pubblicamente per l'immagine
Risposte con schede
Le risposte con schede inviano un'immagine, un titolo della scheda, un sottotitolo della scheda e pulsanti interattivi all'utente finale. Lo stile della scheda varia in base alla piattaforma.
Puoi configurare i pulsanti in modo che inviino l'utente finale a un URL o che inviino testo preconfigurato a Dialogflow come se l'utente finale avesse fornito un'espressione.
Alcuni campi sono facoltativi, a seconda della piattaforma:
- URL accessibile pubblicamente per un'immagine
- Card title
- Card subtitle
- Elenco di pulsanti con i seguenti campi:
- Titolo del pulsante
- Testo da inviare come espressione dell'utente finale o URL da aprire
Si applicano le seguenti limitazioni:
Massimo 10 schede per piattaforma e per lingua per un intent. Ad esempio, se il tuo agente supporta inglese, francese, piattaforma X e piattaforma Y, un intent può avere al massimo 40 schede:
- 10 schede in inglese per la piattaforma X
- 10 schede in inglese per la piattaforma Y
- 10 schede in francese per la piattaforma X
- 10 schede in francese per la piattaforma Y
Risposte rapide
Le risposte rapide inviano un pulsante all'utente finale. Puoi configurare i pulsanti in modo che inviino testo preconfigurato a Dialogflow come se l'utente finale avesse fornito un'espressione.
I campi sono:
- Titolo del pulsante
- Elenco di voci di testo da inviare come espressione dell'utente finale
Si applicano le seguenti limitazioni:
Massimo una risposta rapida per piattaforma e per lingua per un intent. Ad esempio, se il tuo agente supporta inglese, francese, piattaforma X e piattaforma Y, un intent può avere al massimo 4 risposte rapide:
- 1 risposta rapida in inglese per la piattaforma X
- 1 risposta rapida in inglese per la piattaforma Y
- 1 risposta rapida in francese per la piattaforma X
- 1 risposta rapida in francese per la piattaforma Y
Massimo 10 voci di testo per risposta rapida.
Massimo 20 caratteri per voce di testo.
Risposte di sintesi vocale
Le risposte di sintesi vocale vengono utilizzate per sintetizzare la voce dalle risposte testuali e riprodurre l'audio. Il testo fornito può facoltativamente utilizzare il Speech Synthesis Markup Language (SSML).
I campi sono:
- Testo o SSML
Si applicano le seguenti limitazioni:
- Supportato solo dall'inteaazione del gateway telefonico di Dialogflow
- Massimo 20 risposte di sintesi vocale per intent
Risposte di riproduzione audio
Le risposte di riproduzione audio vengono utilizzate per riprodurre file audio. I file audio vengono forniti in un bucket Cloud Storage.
I campi sono:
- URI dell'oggetto Cloud Storage nel formato
gs://bucket-name/object-name.
Si applicano le seguenti limitazioni:
- Supportato solo dall'inteaazione del gateway telefonico di Dialogflow
- Specifiche del file audio: un singolo canale (mono) di audio PCM lineare (2 byte / campione) a 8 kHz
- Massimo 20 risposte di riproduzione audio per intent
Risposte di trasferimento della chiamata
Le risposte di trasferimento della chiamata vengono utilizzate per trasferire il chiamante per un'integrazione di telefonia.
I campi sono:
- Il numero di telefono a cui trasferire.
Si applicano le seguenti limitazioni:
Supportato solo dall'inteaazione del gateway telefonico di Dialogflow
Sono supportati solo i numeri di telefono statunitensi
Risposte di payload personalizzato
Alcune piattaforme supportano una risposta di payload personalizzato per gestire risposte avanzate non standard. Questi payload personalizzati vengono forniti in formato JSON definito nella documentazione della piattaforma.
Puoi anche inviare un payload personalizzato alle integrazioni che sviluppi. Non verrà elaborato da Dialogflow, quindi devi gestirlo nella tua logica di business.
Puoi configurare un payload personalizzato per più piattaforme. Per configurarlo, utilizza la piattaforma predefinita e un formato JSON simile al seguente:
{
"facebook": {
"attachment": {
"type": "",
"payload": {}
}
},
"slack": {
"text": "",
"attachments": []
}
}
Tipi di risposta dell'Assistente Google
L'integrazione dell'Assistente Google fornisce molti tipi di messaggi di risposta. Per saperne di più, consulta il riferimento alle risposte dell'Assistente Google.
Altri tipi di risposta
Altri tipi di messaggi sono supportati da varie piattaforme. Puoi visualizzare l'elenco completo nel riferimento REST dei messaggi di risposta. Per saperne di più, consulta la documentazione sull'integrazione della piattaforma.