Pagine

Una conversazione (sessione) di Dialogflow CX può essere descritta e visualizzata come una macchina a stati. Gli stati di una sessione sono rappresentati dalle pagine.

Per ogni flusso, definisci molte pagine, dove le pagine combinate possono gestire una conversazione completa sugli argomenti per cui è progettato il flusso. In un determinato momento, esiste una sola pagina corrente, la pagina corrente è considerata attiva e il flusso associato a quella pagina è considerato attivo. Ogni flusso ha una pagina iniziale speciale. Quando un flusso diventa attivo per la prima volta, la pagina iniziale diventa la pagina corrente. Per ogni turno di conversazione, la pagina corrente rimarrà invariata o verrà visualizzata un'altra pagina.

Configura ogni pagina per raccogliere informazioni dall'utente finale pertinenti per lo stato conversazionale rappresentato dalla pagina. Ad esempio, potresti creare le pagine (in blu) nel diagramma seguente per un flusso di Ordine di cibo di un addetto alle consegne di pizza. Il nodo Inizia del diagramma rappresenta la pagina iniziale del flusso Ordine di cibo. Al termine del flusso, si passa al flusso di Conferma.

Esempio di diagramma multiflusso.

Ciclo di vita di una pagina

Una volta che una pagina diventa attiva, l'agente segue diversi passaggi che possono comportare il completamento delle voci, la precompilazione dei moduli, la valutazione del gestore di stato, la richiesta di parametri del modulo, l'invio di messaggi di risposta all'utente finale e una modifica della pagina o un ciclo di ripetizione:

Diagramma del ciclo di vita della pagina.

I dettagli di questa procedura sono i seguenti:

  1. Se esiste una voce fulfillment per la pagina, viene chiamata. Tutte le risposte statiche fornite dall'evasione vengono aggiunte alla coda delle risposte.

    Se l'opzione Risposta parziale è abilitata, Dialogflow CX svuota la coda di risposte e invia tutti i messaggi in coda come risposta parziale al chiamante dell'API di streaming.

    Se l'evasione ha un webhook, questo viene chiamato e potrebbe aggiungere risposte aggiuntive alla coda. Queste risposte aggiuntive non attivano lo svuotamento immediato della coda di risposte.

  2. Se la pagina ha parametri del modulo, questi potrebbero essere precompilati:

  3. Se uno o più gestori di stato sono in ambito, vengono valutati in base alle regole di ordine di valutazione dei gestori. Ciò può comportare route, gestori di eventi o gestori di richieste di ripristino richiamati dall'iterazione precedente del ciclo. Se viene chiamato un gestore di stato, potrebbe verificarsi una o entrambe le seguenti situazioni:

    • Se esiste un fulfillment per l'intent, viene chiamato. Tutte le risposte statiche fornite dall'evasione vengono aggiunte alla coda delle risposte. Se sono attivate, vengono eseguite anche la risposta parziale e il webhook.
    • Se esiste un flusso o una pagina di destinazione per l'handler, la sessione passa alla destinazione e la pagina diventa inattiva.

  4. Se tutte le seguenti condizioni sono vere, alla coda di risposte viene aggiunto un prompt del parametro del modulo:

    • La pagina ha un modulo.
    • Devi ancora compilare i parametri obbligatori del modulo.
    • Un gestore di ripromozione non è stato seguito nel passaggio 3.
    • La risposta parziale e il webhook vengono eseguiti se sono attivati.

  5. I messaggi rimanenti della coda di risposte vengono inviati all'utente finale e l'agente attende l&#39input utentet dell'utente finale.

  6. Se l'input utente finale fornisce un parametro del modulo richiesto, compila il parametro. Vai al passaggio 3.

Navigazione nel ciclo di vita della pagina

Il visualizzatore dei passaggi di esecuzione del simulatore ti consente di passare da un passaggio all'altro per un turno di conversazione specifico e mette in evidenza gli elementi correlati di Agent Builder per ogni passaggio. Nell'esempio seguente, l&#39input utentee finale "Vorrei noleggiare un'auto" attiva cinque passaggi di esecuzione e transizione:

  1. Il visualizzatore dei passaggi di esecuzione ti porta alla pagina di avvio della conversazione per il primo passaggio. In questo caso, è la pagina iniziale predefinita. Passaggio 1 dell'esecuzione della pagina.

  2. Viene attivato il percorso di transizione per l'intent car_rental.reservation_create. Il visualizzatore dei passaggi di esecuzione mette in evidenza questo percorso, dove puoi vedere che la destinazione della transizione è la pagina Pickup Location. Passaggio 2 dell'esecuzione della pagina.

  3. L'agente accede alla pagina Pickup Location. Passaggio 3 dell'esecuzione della pagina.

  4. L'agente valuta il completamento della voce della pagina Pickup Location. L'evasione è vuota, quindi non succede nulla. Passaggio 4 dell'esecuzione della pagina.

  5. L'agente tenta di raccogliere il parametro del modulo richiesto pickup_location e all'utente finale viene mostrato il messaggio di completamento del prompt iniziale per questo parametro. Passaggio 5 dell'esecuzione della pagina.

Puoi anche annullare l'ultimo comando vocale e provare qualcos'altro per testare diverse transizioni di pagina.

Annulla l'ultima azione.

Crea una pagina

Per creare una pagina:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud .
  3. Seleziona il tuo agente.
  4. Seleziona un flusso per la pagina nella sezione Flussi.
  5. Fai clic sul pulsante Aggiungi nella sezione Pagine.
  6. Inserisci un nome visualizzato per la tua pagina.
  7. Fai clic sul pulsante delle impostazioni accanto al nome visualizzato della pagina.
  8. Seleziona Modifica.
  9. Inserisci i campi nel riquadro di modifica della pagina visualizzato.
  10. Fai clic su Salva.

API

Consulta il metodo create per il tipo Page.

Seleziona un protocollo e una versione per il riferimento alla 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
Go 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

  1. Apri la console Dialogflow CX.
  2. Scegli il progetto Google Cloud per l'agente.
  3. Seleziona il tuo agente.
  4. Fai clic sul flusso nella sezione Flussi.
  5. Le pagine del flusso vengono compilate nella sezione Pagine.
  6. Fai clic sul pulsante delle impostazioni accanto al nome visualizzato della pagina.
  7. Seleziona Modifica.
  8. Inserisci i campi nel riquadro di modifica della pagina visualizzato.
  9. Fai clic su Salva per salvare le modifiche.

API

Consulta i metodi get e patch/update per il tipo Page.

Seleziona un protocollo e una versione per il riferimento alla 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
Go 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 dell'inserimento (noto anche come Finestra di dialogo di inserimento): questo è il completamento da chiamare quando la pagina diventa attiva inizialmente.
  • Parametri: si tratta dei valori dei parametri in un modulo della pagina che acquisiscono l'input strutturato dell'utente finale.
  • Routes: Questi gestori di stato possono essere chiamati quando la pagina è attiva. Per maggiori dettagli, vedi Route del gestore a livello di pagina
  • Gruppi di route: le route all'interno di questi gruppi possono essere chiamate quando la pagina è attiva. Per maggiori dettagli, vedi Gruppi di itinerari
  • Gestori di eventi: Questi gestori di eventi potrebbero 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:

Per accedere alle impostazioni della pagina:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud .
  3. Seleziona il tuo agente.
  4. Passa il mouse sopra la pagina nella sezione Pagine.
  5. Fai clic sul pulsante Opzioni.
  6. Seleziona Impostazioni pagina.
  7. Sfoglia o modifica le impostazioni.
  8. Fai clic su Salva per salvare le modifiche.

API

Consulta i metodi get e patch/update per il tipo Page.

Seleziona un protocollo e una versione per il riferimento alla 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
Go 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

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud .
  3. Seleziona il tuo agente.
  4. Seleziona il flusso per la pagina nella sezione Flussi.
  5. Fai clic sul pulsante delle impostazioni accanto al nome visualizzato della pagina nella sezione Pagine.
  6. Seleziona Elimina.

API

Consulta il metodo delete per il tipo Page.

Seleziona un protocollo e una versione per il riferimento alla 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
Go PagesClient Non disponibile
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP Non disponibile Non disponibile
Python PagesClient PagesClient
Ruby Non disponibile Non disponibile

Indietro
Flussi
Avanti
Gestori di stato