Risposte

Gli intent hanno un gestore di risposte integrato che può restituire risposte dopo la corrispondenza dell'intent. Questa funzionalità supporta solo risposte statiche, anche se puoi utilizzare riferimenti ai parametri in queste risposte per renderle piuttosto dinamiche. Ciò è utile per riepilogare le informazioni fornite dall'utente finale. Ad esempio, la tua risposta intent potrebbe essere: "Ok, ho prenotato una stanza per te il giorno $date".

In alcuni casi, questo è tutto ciò di cui hai bisogno. Nei casi in cui il codice debba eseguire alcune azioni o generare una risposta più dinamica, utilizza una delle opzioni di risposta dinamica riportate di seguito. Gli agenti in genere 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, sintesi vocale e così via), alcuni dei quali specifici per la piattaforma.

Se definisci più di una variante della risposta per un intent, l'agente selezionerà una risposta in modo casuale. Dovresti aggiungere diverse varianti della risposta per rendere l'agente più colloquiale.

Quando crei un agente, devi fornire dati di risposta per ogni intent. Quando utilizzi l'API o il fulfillment per interagire con Dialogflow, tecnicamente potresti non dover fornire dati sulle risposte, perché entrambi questi metodi possono generare dinamicamente qualsiasi risposta. Tuttavia, se vuoi utilizzare il simulatore per testare o definire intent che hanno una risposta semplice, devi fornire i dati della risposta.

Come regola generale, le risposte di intent dovrebbero richiedere all'utente finale di fornire un'espressione che corrisponda a un altro intent. Le tue risposte devono anche guidare l'utente finale nel fornire dati specifici. Ad esempio, una domanda come "In che città sei nata?" è meglio di una domanda più aperta come "Dove sei nato?".

Dove trovare questi dati

Durante la creazione di un agente, è più comune utilizzare Dialogflow ES Console (consulta la documentazione, apri la console). Le istruzioni riportate di seguito sono incentrate sull'utilizzo della console. Per accedere ai dati della risposta dell'intent:

  1. Vai alla console Dialogflow ES.
  2. Seleziona un agente.
  3. Seleziona Intent nel menu della barra laterale a sinistra.
  4. Seleziona un intent.
  5. Scorri verso il basso fino alla sezione Risposte.

Se stai creando un agente utilizzando l'API anziché la console, consulta la documentazione di riferimento per gli intent. I nomi dei campi API sono simili a quelli dei campi della console. Le istruzioni riportate di seguito evidenziano 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 piattaforma di integrazione specifica. Se non usi un'integrazione, tutte le tue risposte possono usare la piattaforma predefinita. Se utilizzi le integrazioni, ogni integrazione può avere una risposta unica oppure può essere configurata in modo da utilizzare la risposta predefinita.

Per ulteriori informazioni sulle risposte specifiche per piattaforma, consulta Messaggi di risposta avanzati.

Crea risposte integrate

Per creare risposte integrate:

  1. Seleziona Predefinita o una piattaforma specifica.
  2. Se il tipo di risposta che ti interessa (ad esempio Risposta di testo) non è già elencato, fai clic su Aggiungi risposte e seleziona il tipo di risposta.
  3. Inserisci le informazioni richieste per la risposta.
  4. Fai clic su Salva.

Risposte dinamiche con fulfillment

Utilizzando l'evasione degli ordini, puoi creare risposte dinamiche. Per ulteriori informazioni, consulta i documenti di evasione degli ordini.

Risposte dinamiche con l'API

Utilizzando l'API, puoi creare risposte dinamiche. Per ulteriori informazioni, consulta la panoramica delle API.

Caratteri speciali

Alcuni caratteri speciali richiedono l'escape nella risposta.

Per utilizzare il simbolo del dollaro $ o il simbolo del numero # in una risposta, aggiungi le parentesi graffe {} intorno al contenuto che segue immediatamente il simbolo. Ad esempio:

  • ${100} restituisce $100
  • ${$number} restituisce $100, dove $number è un riferimento di parametro con valore 100
  • #{hello} restituisce #hello

Per utilizzare le parentesi graffe {} in una risposta, usa le parentesi graffe doppie. Ad esempio:

  • {{hello}} restituisce {hello}

Gestione dei valori parametro vuoti

Se l'intent ha un parametro che può risolversi in un valore vuoto, devi fornire almeno una variante di risposta che non lo utilizzi.

Ad esempio, se l'intent ha due parametri (p1 e p2) ed 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.