Flussi

Le conversazioni complesse spesso coinvolgono più argomenti. Ad esempio, un addetto alla consegna di pizza potrebbe avere ordine di cibo, informazioni sul cliente e conferma come argomenti distinti. Ogni argomento richiede più turni di conversazione per consentire a un agente di acquisire le informazioni pertinenti dall'utente finale.

I flussi vengono utilizzati per definire questi argomenti e i percorsi di conversazione associati. Ogni agente ha un flusso chiamato Flusso di inizio predefinito. Questo singolo flusso potrebbe essere tutto ciò che ti serve per un agente semplice. Gli agenti più complessi potrebbero richiedere flussi aggiuntivi e diversi membri del team di sviluppo possono essere responsabili della creazione e della manutenzione di questi flussi. Ad esempio, i flussi di un addetto alla consegna di pizza potrebbero essere i seguenti:

Esempio di diagramma con più flussi.

Flusso di inizio predefinito

Quando crei un agente, viene creato automaticamente il Flusso di inizio predefinito. Per un agente semplice, puoi utilizzare questo flusso come unico flusso. Per agenti più complessi, puoi aggiungere altri flussi e il flusso di avvio predefinito può essere utilizzato come semplice punto di contatto per la conversazione.

Quando utilizzi l'API, puoi fare riferimento al flusso di inizio predefinito con il seguente ID flusso:

00000000-0000-0000-0000-000000000000

Pagina di inizio del flusso

Ogni flusso ha una pagina speciale denominata Inizia nella console. Quando un flusso è selezionato nella console, la pagina iniziale viene visualizzata come un nodo nel grafico. Quando un flusso diventa inizialmente attivo, questa pagina diventa la pagina attiva corrente.

Una pagina iniziale non ha parametri o messaggi di risposta come le normali pagine. Tuttavia, puoi inviare un messaggio utilizzando uno dei seguenti approcci:

Fare riferimento alla home page nelle richieste API

Per fare riferimento alla pagina iniziale di un flusso nelle richieste dell'API di runtime, utilizza START_PAGE come ID pagina.

Per apportare modifiche a una pagina iniziale in fase di progettazione tramite l'API, utilizza i metodi dell'API get e patch/update per il tipo Flow.

Seleziona un protocollo e una versione per il riferimento del flusso:

Protocollo V3 V3beta1
REST Risorsa di flusso Risorsa di flusso
RPC Interfaccia di Flow Interfaccia di Flow
C++ FlowsClient Non disponibile
C# FlowsClient Non disponibile
Vai FlowsClient Non disponibile
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponibile Non disponibile
Python FlowsClient FlowsClient
Ruby Non disponibile Non disponibile

crea un flusso

Per creare un flusso:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Fai clic sul pulsante di aggiunta nella sezione Fluidi.
  5. Seleziona Crea flusso.
  6. Inserisci un nome visualizzato per il flusso.
  7. Fai clic sul flusso appena creato.

API

Consulta il metodo create per il tipo Flow.

Seleziona un protocollo e una versione per il riferimento del flusso:

Protocollo V3 V3beta1
REST Risorsa di flusso Risorsa di flusso
RPC Interfaccia di Flow Interfaccia di Flow
C++ FlowsClient Non disponibile
C# FlowsClient Non disponibile
Vai FlowsClient Non disponibile
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponibile Non disponibile
Python FlowsClient FlowsClient
Ruby Non disponibile Non disponibile

Dati sul flusso

Per accedere ai dati di un flusso:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il progetto Google Cloud per l'agente.
  3. Trova l'agente nell'elenco.
  4. Fai clic sul nome visualizzato dell'agente.
  5. Fai clic sul flusso nella sezione Fluidi.
  6. Le pagine del flusso vengono compilate nella sezione Pagine. Per informazioni sulla modifica delle pagine, consulta la guida alle pagine.
  7. Fai clic sul flusso nel grafico.
  8. Viene visualizzato un riquadro di modifica del flusso. Utilizza questo riquadro per sfogliare e modificare altri dati del flusso.
  9. Fai clic su Salva per salvare le modifiche.

API

Per i flussi, consulta get e patch/update per il tipo Flow.

Seleziona un protocollo e una versione per il riferimento del flusso:

Protocollo V3 V3beta1
REST Risorsa di flusso Risorsa di flusso
RPC Interfaccia di Flow Interfaccia di Flow
C++ FlowsClient Non disponibile
C# FlowsClient Non disponibile
Vai FlowsClient Non disponibile
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponibile Non disponibile
Python FlowsClient FlowsClient
Ruby Non disponibile Non disponibile
Per le pagine, consulta i metodi get e patch/update 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

I seguenti dati sono associati ai flussi:

Per ulteriori informazioni su come vengono applicati i dati a livelli diversi, consulta i livelli di applicazione dei dati.

Impostazioni del flusso

Per i flussi sono disponibili le seguenti impostazioni:

Per ulteriori informazioni su come vengono applicati i dati a livelli diversi, consulta i livelli di applicazione dei dati.

Per accedere alle impostazioni del flusso:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Passa il mouse sopra il flusso nella sezione Flussi.
  5. Fai clic sul pulsante Opzioni .
  6. Seleziona Impostazioni flusso.
  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 Flow.

Seleziona un protocollo e una versione per il riferimento del flusso:

Protocollo V3 V3beta1
REST Risorsa di flusso Risorsa di flusso
RPC Interfaccia di Flow Interfaccia di Flow
C++ FlowsClient Non disponibile
C# FlowsClient Non disponibile
Vai FlowsClient Non disponibile
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponibile Non disponibile
Python FlowsClient FlowsClient
Ruby Non disponibile Non disponibile

Eliminare un flusso

Per eliminare un flusso:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Passa il mouse sopra il flusso nella sezione Flussi.
  5. Fai clic sul pulsante Impostazioni .
  6. Seleziona Elimina.

API

Consulta il metodo delete per il tipo Flow.

Seleziona un protocollo e una versione per il riferimento del flusso:

Protocollo V3 V3beta1
REST Risorsa di flusso Risorsa di flusso
RPC Interfaccia di Flow Interfaccia di Flow
C++ FlowsClient Non disponibile
C# FlowsClient Non disponibile
Vai FlowsClient Non disponibile
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponibile Non disponibile
Python FlowsClient FlowsClient
Ruby Non disponibile Non disponibile

Addestrare un flusso

Per addestrare un flusso:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Fai clic su Impostazioni agente.
  5. Apri la scheda ML.
  6. Per addestrare un singolo flusso, fai clic su Addestra nella riga corrispondente.
  7. Per addestrare più flussi, selezionali con le caselle di controllo, poi fai clic su Addestra il modello NLU del flusso selezionato.

API

Consulta il metodo train per il tipo Flow.

Seleziona un protocollo e una versione per il riferimento del flusso:

Protocollo V3 V3beta1
REST Risorsa di flusso Risorsa di flusso
RPC Interfaccia di Flow Interfaccia di Flow
C++ FlowsClient Non disponibile
C# FlowsClient Non disponibile
Vai FlowsClient Non disponibile
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponibile Non disponibile
Python FlowsClient FlowsClient
Ruby Non disponibile Non disponibile

Esportare un flusso

Puoi esportare un flusso in due modi:

  • Esportazione dei dati: consente di esportare il flusso come dati non elaborati, in modo che possa essere importato in qualsiasi agente. Quando esporti un flusso, vengono esportate anche le risorse a cui fa riferimento il flusso (intent, entità, webhook). Quando segui i passaggi riportati di seguito, scegli il formato dei dati non elaborati.

  • Esportazione del diagramma (Anteprima): esporta il flusso come diagramma visivo. Il formato di esportazione è draw.io XML, quindi puoi importare il diagramma in Lucidchart, diagrams.net o in qualsiasi altro strumento per diagrammi che possa importare il formato draw.io. Quando segui i passaggi riportati di seguito, scegli il formato dei dati XML.

Puoi esportare un flusso con le seguenti opzioni:

  • Includi flussi a cui si fa riferimento: esporta il flusso target e tutti i livelli dei flussi a cui si fa riferimento. I flussi a cui si fa riferimento includono i flussi a cui fa riferimento il flusso di destinazione, oltre ai flussi a cui fanno riferimento i flussi a cui si fa riferimento successivamente, senza profondità massima. Durante l'importazione, verranno importati tutti i flussi esportati e le transizioni tra questi flussi verranno conservate.

Per esportare un flusso:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Passa il mouse sopra il flusso nella sezione Flussi.
  5. Fai clic sul pulsante Opzioni .
  6. Seleziona Esegui esportazione flusso.
  7. Segui le istruzioni per completare l'operazione.

API

Consulta il metodo export per il tipo Flow.

Seleziona un protocollo e una versione per il riferimento del flusso:

Protocollo V3 V3beta1
REST Risorsa di flusso Risorsa di flusso
RPC Interfaccia di Flow Interfaccia di Flow
C++ FlowsClient Non disponibile
C# FlowsClient Non disponibile
Vai FlowsClient Non disponibile
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponibile Non disponibile
Python FlowsClient FlowsClient
Ruby Non disponibile Non disponibile

Importare un flusso

Quando importi un flusso da un agente di origine a un agente di destinazione, le risorse globali a cui fa riferimento il flusso (intent, entità, webhook) vengono importate insieme ai dati specifici del flusso. Se l'agente di destinazione ha risorse globali con gli stessi nomi visualizzati nell'agente di origine, Conversational Agents (Dialogflow CX) fornisce un riepilogo di queste risorse, insieme a tre opzioni per risolvere i conflitti relativi a queste risorse:

  • Sostituisci le risorse esistenti: le risorse dell'agente di origine sovrascriveranno le risorse dell'agente di destinazione.
  • Importa come nuove risorse: le risorse degli agenti di origine verranno aggiunte con un suffisso distintivo nel nome.
  • Mantieni le risorse originali: le risorse dell'agente di destinazione rimarranno invariate.

Per importare un flusso:

Console

  1. Apri la console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Fai clic sul pulsante di aggiunta nella sezione Fluidi.
  5. Seleziona Importa flusso.
  6. Segui le istruzioni per completare l'operazione.

API

Consulta il metodo import per il tipo Flow.

Seleziona un protocollo e una versione per il riferimento del flusso:

Protocollo V3 V3beta1
REST Risorsa di flusso Risorsa di flusso
RPC Interfaccia di Flow Interfaccia di Flow
C++ FlowsClient Non disponibile
C# FlowsClient Non disponibile
Vai FlowsClient Non disponibile
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponibile Non disponibile
Python FlowsClient FlowsClient
Ruby Non disponibile Non disponibile