Una conversazione (sessione) Dialogflow CX può essere descritta e visualizzata come macchina a stato. Gli stati di una sessione CX sono rappresentati pagine.
Per ogni flow, devi definire molte pagine, in cui le pagine combinate possano gestire una conversazione completa agli argomenti per cui è stato progettato il flusso. In qualsiasi momento esattamente una pagina è la pagina corrente, la pagina corrente è considerata attiva e il flusso associato a quella pagina è considerato attivo. Ogni flusso ha uno speciale pagina iniziale. Quando un flusso diventa inizialmente attivo, la pagina iniziale diventa la pagina corrente. Per ogni svolta colloquiale, la pagina corrente rimarrà invariata o passerà a un'altra.
Configura ogni pagina in modo che raccolga informazioni dell'utente finale pertinenti per lo stato conversazionale rappresentato dalla pagina. Ad esempio, potresti creare le pagine (in blu) nello schema seguente per un flusso Ordinazione cibo di un addetto alla consegna di pizza. Il nodo Start del diagramma rappresenta la pagina iniziale del flusso Ordinazione di cibo. Una volta completato, passa al flusso Confirmation (Conferma).
Ciclo di vita di una pagina
Quando una pagina diventa attiva, l'agente segue diversi passaggi, che possono comportare completamento delle voci, precompilazione dei moduli, valutazione dei gestori dello stato, prompt di parametri del modulo, invio di messaggi di risposta all'utente finale e un cambio di pagina o un loop di ripetizione:
I dettagli di questa procedura sono i seguenti:
Se voce fulfillment esiste per la pagina, viene chiamata. Tutte le risposte statiche fornite dal completamento vengono aggiunte al coda di risposte.
Se risposta parziale è abilitata, Dialogflow svuota la coda delle risposte e invia tutte le risposte in coda come risposta parziale al chiamante dell'API per lo streaming.
Se il fulfillment ha un webhook, viene chiamato quest'ultimo, che potrebbe aggiungere risposte aggiuntive alla coda. Queste risposte aggiuntive non attivano lo svuotamento immediato della coda delle risposte.
Se la pagina contiene parametri di modulo, questi potrebbero essere precompilati:
- Qualsiasi set parametro di sessione con lo stesso nome di parametro modulo viene copiato nel parametro del modulo.
- Se percorso ha attivato una transizione a questa pagina, e il percorso contiene una corrispondenza intent, qualsiasi parametro di intent con lo stesso nome di parametro di modulo viene copiato nel parametro del modulo.
Se uno o più gestori di stato in ambito, vengono valutate in base regole degli ordini di valutazione del gestore. Può trattarsi di route, gestori di eventi o gestori di ripetizioni richiamati dall'iterazione precedente del loop. Se viene chiamato un gestore di stato, si può verificare una o entrambe le seguenti situazioni:
- Se esiste un fulfillment per il gestore, questo viene chiamato. Tutte le risposte statiche fornite dal completamento vengono aggiunte al coda di risposte. Parziale la risposta e il webhook vengono eseguiti anche se sono abilitati.
- Se esiste una pagina o un flusso di destinazione per il gestore, la sessione passa al target e la pagina diventa inattiva.
Se tutte le seguenti condizioni sono vere, un prompt del parametro del modulo viene aggiunto alla coda di risposta:
- La pagina contiene un modulo.
- Sono rimasti parametri obbligatori da compilare.
- Un gestore dei prompt non è stato seguito nel passaggio 3.
- La risposta parziale e il webhook vengono eseguiti se sono abilitati.
I restanti messaggi della coda di risposta vengono inviati all'utente finale, e l'agente attende l'input utente finale.
Se input utente finale fornisce un parametro del modulo richiesto, per riempire il parametro. Vai al passaggio 3.
Navigazione del ciclo di vita delle pagine
Passaggi di esecuzione del simulatore ti consente di passare da un passaggio all'altro per una specifica conversazione. e mette a fuoco gli elementi dello strumento per la creazione degli agenti in ogni passaggio. Nella nell'esempio seguente, input utente finale ha inserito "Vorrei noleggiare un'auto" attiva cinque le fasi di esecuzione e transizione:
Il visualizzatore dei passaggi di esecuzione ti porta alla pagina iniziale della conversazione per il primo passaggio. In questo caso si tratta della pagina iniziale predefinita.
Viene attivata la route di transizione per l'intent
car_rental.reservation_create
. Il visualizzatore dei passaggi delle esecuzioni mette in primo piano questo percorso, dove puoi vedere che il target della transizione è la paginaPickup Location
.L'agente accede alla pagina
Pickup Location
.L'agente valuta il completamento dell'accesso nella pagina
Pickup Location
. La il completamento è vuoto, quindi non succede nulla.L'agente cerca di raccogliere il parametro del modulo richiesto
pickup_location
e il messaggio iniziale di completamento del prompt per questo parametro viene mostrato per l'utente finale.
Puoi anche annullare l'ultima frase e provare qualcos'altro per testare diverse transizioni di pagina.
Crea una pagina
Per creare una pagina:
Console
- Apri la console Dialogflow CX.
- Scegli il progetto Google Cloud.
- Seleziona l'agente.
- Seleziona un flusso per la pagina nella sezione Flussi.
- Fai clic sull'icona Aggiungi add nella sezione Pagine.
- Inserisci un nome visualizzato per la pagina.
- Fai clic sulle impostazioni more_vert accanto al nome visualizzato della pagina.
- Seleziona Modifica.
- Inserisci i campi nel riquadro di modifica della pagina che viene visualizzato.
- Fai clic su Salva.
API
Visualizza il metodo create
per il tipo Page
.
Seleziona un protocollo e una versione per il riferimento della pagina:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa della pagina | Risorsa della pagina |
RPC | Interfaccia della pagina | Interfaccia della pagina |
C++ | PagesClient | Non disponibile |
C# | PagesClient | Non disponibile |
Vai | PagesClient | Non disponibile |
Java | PagesClient | PagesClient |
Node.js | PagesClient | PagesClient |
PHP | Non disponibile | Non disponibile |
Python | PagesClient | PagesClient |
Ruby | Non disponibile | Non disponibile |
Dati della pagina
Per accedere ai dati di una pagina:
Console
- Apri la console Dialogflow CX.
- Scegli il progetto Google Cloud per l'agente.
- Seleziona l'agente.
- Fai clic sul flusso nella sezione Flussi.
- Le pagine del flusso vengono compilate nella sezione Pagine.
- Fai clic sulle impostazioni more_vert accanto al nome visualizzato della pagina.
- Seleziona Modifica.
- Inserisci i campi nel riquadro di modifica della pagina che viene visualizzato.
- Fai clic su Salva per salvare le modifiche.
API
Visualizza i metodi get
e patch/update
per il tipo Page
.
Seleziona un protocollo e una versione per il riferimento della pagina:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa della pagina | Risorsa della pagina |
RPC | Interfaccia della pagina | Interfaccia della pagina |
C++ | PagesClient | Non disponibile |
C# | PagesClient | Non disponibile |
Vai | PagesClient | Non disponibile |
Java | PagesClient | PagesClient |
Node.js | PagesClient | PagesClient |
PHP | Non disponibile | Non disponibile |
Python | PagesClient | PagesClient |
Ruby | Non disponibile | Non disponibile |
I seguenti dati sono associati alle pagine:
- Nome visualizzato: Un nome leggibile per la tua pagina.
- Completamento della voce (noto anche come Finestra di dialogo della voce): Questo è il fulfillment da chiamare quando la pagina diventa attiva.
- Parametri: Questi sono i valori dei parametri in una pagina modulo che acquisiscono input strutturati dall'utente finale.
- Percorsi: Questi gestori di stato possono essere chiamati quando la pagina è attiva. Per maggiori dettagli, vedi Route dei gestori a livello di pagina
- Gruppi di route: Le route all'interno di questi gruppi può essere chiamato quando la pagina è attiva. Per maggiori dettagli, vedi Gruppi di route
- Gestori di eventi: Questi gestori di eventi possono essere chiamati quando la pagina è attiva. Per maggiori dettagli, vedi Gestori di eventi a livello di pagina
Impostazioni pagina
Per le pagine sono disponibili le seguenti impostazioni:
Impostazioni vocali avanzate: Queste impostazioni vocali avanzate può sostituire facoltativamente lo stesso impostazioni vocali per il flusso e impostazioni vocali dell'agente.
Impostazioni di adattamento vocale: Le impostazioni di adattamento vocale a livello di pagina possono facoltativamente sostituire le stesse impostazioni di adattamento vocale del flusso. Per istruzioni più dettagliate, consulta la adattamento vocale manuale.
Per accedere alle impostazioni della pagina:
Console
- Apri la console Dialogflow CX.
- Scegli il progetto Google Cloud.
- Seleziona l'agente.
- Passa il mouse sopra la pagina nella sezione Pagine.
- Fai clic sulle opzioni more_vert .
- Seleziona Impostazioni pagina.
- Sfoglia o modifica le impostazioni.
- Fai clic su Salva per salvare le modifiche.
API
Visualizza i metodi get
e patch/update
per il tipo Page
.
Seleziona un protocollo e una versione per il riferimento della pagina:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa della pagina | Risorsa della pagina |
RPC | Interfaccia della pagina | Interfaccia della pagina |
C++ | PagesClient | Non disponibile |
C# | PagesClient | Non disponibile |
Vai | PagesClient | Non disponibile |
Java | PagesClient | PagesClient |
Node.js | PagesClient | PagesClient |
PHP | Non disponibile | Non disponibile |
Python | PagesClient | PagesClient |
Ruby | Non disponibile | Non disponibile |
Eliminare una pagina
Per eliminare una pagina:
Console
- Apri la console Dialogflow CX.
- Scegli il progetto Google Cloud.
- Seleziona l'agente.
- Seleziona il flusso per la pagina nella sezione Flows.
- Fai clic sulle impostazioni more_vert accanto al nome visualizzato della pagina nella sezione Pagine.
- Seleziona Elimina.
API
Visualizza il metodo delete
per il tipo Page
.
Seleziona un protocollo e una versione per il riferimento della pagina:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa della pagina | Risorsa della pagina |
RPC | Interfaccia della pagina | Interfaccia della pagina |
C++ | PagesClient | Non disponibile |
C# | PagesClient | Non disponibile |
Vai | PagesClient | Non disponibile |
Java | PagesClient | PagesClient |
Node.js | PagesClient | PagesClient |
PHP | Non disponibile | Non disponibile |
Python | PagesClient | PagesClient |
Ruby | Non disponibile | Non disponibile |