Pagine

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

Per ogni flusso, definisci molte pagine, che combinate possono gestire una conversazione completa sui temi per cui è progettato il flusso. In un determinato 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 turno di conversazione, la pagina corrente rimarrà invariata o passerà a un'altra pagina.

Configura ogni pagina per raccogliere dall'utente finale informazioni pertinenti per lo stato della conversazione 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 Inizia del diagramma rappresenta la pagina di inizio del flusso Ordine di cibo. Una volta completato, passa al flusso Confirmation (Conferma).

Esempio di diagramma con più flussi.

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:

Diagramma del ciclo di vita di una pagina.

I dettagli di questa procedura sono i seguenti:

  1. Se voce fulfillment esiste per la pagina, viene chiamata. Eventuali risposte statiche fornite dall'erogazione vengono aggiunte alla coda di risposta.

    Se la risposta parziale è attivata, gli agenti conversazionali (Dialogflow CX) svuotano la coda di risposta e inviano tutti i messaggi in coda come risposta parziale all'autore della chiamata dell'API di streaming.

    Se il completamento ha un webhook, questo viene chiamato e potrebbe aggiungere altre risposte alla coda. Queste risposte aggiuntive non attivano un svuotamento immediato della coda di risposta.

  2. Se la pagina contiene parametri di modulo, questi potrebbero essere precompilati:

  3. Se uno o più gestori di stato in ambito, vengono valutate in base regole degli ordini di valutazione del gestore. Ciò può includere percorsi, gestori di eventi o gestori di richieste di conferma richiamati dall'iterazione del loop precedente. Se viene chiamato un gestore dello stato, puoi verificarsi una o entrambe le seguenti condizioni:

    • Se esiste un'implementazione per l'handler, viene chiamata. Eventuali risposte statiche fornite dall'erogazione vengono aggiunte alla coda di risposta. Se sono attivati, vengono eseguiti anche la risposta parziale e l'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, un prompt del parametro del modulo viene aggiunto alla coda di risposta:

    • La pagina abbia un modulo.
    • Mancano alcuni parametri obbligatori del modulo da compilare.
    • Un gestore dei prompt non è stato seguito nel passaggio 3.
    • La risposta parziale e il webhook vengono eseguiti se sono abilitati.

  5. I messaggi rimanenti della coda di risposta vengono inviati all'utente finale e l'agente attende l'input dell'utente finale.

  6. Se input utente finale fornisce un parametro di richiesta, per riempire 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 determinato turno di conversazione e mette in primo piano gli elementi di Generatore di agenti correlati per ogni passaggio. Nella nell'esempio seguente, input utente finale ha inserito "Vorrei noleggiare un'auto" attiva cinque le fasi di esecuzione e transizione:

  1. Il visualizzatore dei passaggi di esecuzione ti porta alla pagina iniziale della conversazione per il primo passaggio. In questo caso, si tratta della home page predefinita. Passaggio 1 dell'esecuzione della pagina.

  2. Il percorso di transizione per l'intent car_rental.reservation_create viene attivato. Il visualizzatore dei passaggi delle esecuzioni mette in primo piano questo percorso, dove puoi vedere che il target della transizione è la pagina Pickup Location. Passaggio 2 di esecuzione della pagina.

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

  4. L'agente valuta l'inserimento della pagina Pickup Location. La il completamento è vuoto, quindi non succede nulla. Passaggio 4 dell'esecuzione della pagina.

  5. 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. Passaggio 5 dell'esecuzione della pagina.

Puoi anche annullare l'ultima frase e provare qualcos'altro per testare diverse transizioni di pagina.

Annulla l'espressione.

Crea una pagina

Per creare una pagina:

Console

  1. Apri la console di Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona l'agente.
  4. Seleziona un flusso per la pagina nella sezione Flussi.
  5. Fai clic sull'icona Aggiungi nella sezione Pagine.
  6. Inserisci un nome visualizzato per la 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 che viene visualizzato.
  10. Fai clic su Salva.

API

Visualizza il metodo create per il tipo Page.

Seleziona un protocollo e una versione per il riferimento pagina:

Protocollo V3 V3beta1
REST Risorsa pagina Risorsa 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

  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 che viene 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 della pagina:

Protocollo V3 V3beta1
REST Risorsa 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 pagina.
  • Completamento dell'inserimento (noto anche come dialogo di inserimento): si tratta del compilamento da chiamare quando la pagina diventa inizialmente attiva.
  • Parametri: Questi sono i valori dei parametri in una pagina modulo che acquisiscono input strutturati dall'utente finale.
  • Route: Questi gestori degli stati 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:

Per accedere alle impostazioni della pagina:

Console

  1. Apri la console di Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona l'agente.
  4. Passa il mouse sopra la pagina nella sezione Pagine.
  5. Fai clic sul pulsante Opzioni .
  6. Seleziona Impostazioni pagina.
  7. Sfogliare o modificare 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 della pagina:

Protocollo V3 V3beta1
REST Risorsa 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

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

API

Visualizza il metodo delete per il tipo Page.

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

Indietro
Flussi
Avanti
Gestori di stato