I dialoghi complessi spesso coinvolgono più argomenti di conversazione. 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 conversazionali per consentire all'agente di acquisire le informazioni pertinenti dall'utente finale.
I flussi vengono utilizzati per definire questi argomenti e i percorsi conversazionali associati. Ogni agente ha un flusso denominato Flusso di avvio predefinito. Potrebbe bastare un unico flusso per un agente semplice. Gli agenti più complicati potrebbero richiedere flussi aggiuntivi e la creazione e la gestione di questi flussi possono essere gestite da diversi membri dei team di sviluppo. Ad esempio, i flussi di un addetto alla consegna di pizza potrebbero avere il seguente aspetto:
I flussi Dialogflow CX hanno uno scopo simile ai sub-agenti per i mega agenti Dialogflow ES. I flussi offrono un migliore controllo delle conversazioni e non prevedono costi aggiuntivi.
Flusso di avvio predefinito
Quando crei un agente, il flusso di avvio predefinito viene creato automaticamente. 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 ingresso alla conversazione.
Quando utilizzi l'API, puoi fare riferimento al flusso di avvio predefinito con il seguente ID flusso:
00000000-0000-0000-0000-000000000000
Pagina iniziale del flusso
Ogni flusso ha una pagina speciale denominata Avvia nella console. Quando selezioni un flusso nella console, la pagina iniziale viene visualizzata come nodo sul grafico. Quando un flusso diventa attivo inizialmente, questa pagina diventa la pagina corrente e attiva.
Una pagina iniziale non contiene messaggi relativi a parametri o risposte, come le pagine normali. Tuttavia, puoi inviare un messaggio utilizzando uno dei seguenti approcci:
- Propagazione dell'intent
- Utilizza una condizione
truesemplice in una route con una risposta di fulfillment o un target di transizione a una pagina normale con fulfillment di voci. - Eventi personalizzati
Pagina iniziale di riferimento nelle richieste API
Per fare riferimento alla pagina iniziale di un flusso nelle richieste API di runtime, utilizza START_PAGE come
ID pagina.
Per apportare modifiche in fase di progettazione a una pagina iniziale tramite l'API, utilizza i metodi API get e patch/update per il tipo Flow.
Seleziona un protocollo e una versione per il riferimento di Flow:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di flusso | Interfaccia di flusso |
| C++ | FlowsClient | Non disponibile |
| C# | FlowsClient | Non disponibile |
| Go | 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
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Fai clic sul pulsante Aggiungi add nella sezione Flussi.
- Seleziona Crea flusso.
- Inserisci un nome visualizzato per il flusso.
- Fai clic sul flusso appena creato.
API
Visualizza il metodo create per il tipo Flow.
Seleziona un protocollo e una versione per il riferimento di Flow:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di flusso | Interfaccia di flusso |
| C++ | FlowsClient | Non disponibile |
| C# | FlowsClient | Non disponibile |
| Go | FlowsClient | Non disponibile |
| Java | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | Non disponibile | Non disponibile |
| Python | FlowsClient | FlowsClient |
| Ruby | Non disponibile | Non disponibile |
Dati di flusso
Per accedere ai dati di un flusso:
Console
- Apri la console Dialogflow CX.
- Scegli il progetto Google Cloud per l'agente.
- Trova l'agente nell'elenco.
- Fai clic sul nome visualizzato dell'agente.
- Fai clic sul flusso nella sezione Flussi.
- Le pagine del flusso vengono compilate nella sezione Pagine. Consulta la guida alle pagine per informazioni su come modificare le pagine.
- Fai clic sul flusso nel grafico.
- Viene visualizzato un riquadro di modifica del flusso. Utilizza questo riquadro per sfogliare e modificare altri dati sul flusso.
- 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 di Flow:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di flusso | Interfaccia di flusso |
| C++ | FlowsClient | Non disponibile |
| C# | FlowsClient | Non disponibile |
| Go | FlowsClient | Non disponibile |
| Java | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | Non disponibile | Non disponibile |
| Python | FlowsClient | FlowsClient |
| Ruby | Non disponibile | Non disponibile |
get e patch/update per il tipo Page.
Seleziona un protocollo e la 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 |
| Go | PagesClient | Non disponibile |
| Java | PagesClient | PagesClient |
| Node.js | PagesClient | PagesClient |
| PHP | Non disponibile | Non disponibile |
| Python | PagesClient | PagesClient |
| Ruby | Non disponibile | Non disponibile |
Ai flussi sono associati i seguenti dati:
- Pagine: l'elenco di pagine che compongono il flusso.
- Route: tutte queste route possono essere chiamate quando la pagina iniziale del flusso è attiva. Le route con un requisito di intent possono essere seguite quando altre pagine del flusso sono attive. Per i dettagli, consulta Ambito del gestore di stato e Route a livello di flusso.
- Gestori di eventi: questi gestori possono essere chiamati quando il flusso è attivo. Per maggiori dettagli, consulta Gestori di eventi a livello di flusso
Per ulteriori informazioni su come i dati vengono applicati a vari livelli, consulta Livelli di applicazione dei dati.
Impostazioni del flusso
Per i flussi sono disponibili le seguenti impostazioni:
- Nome visualizzato: un nome leggibile del flusso.
- Descrizione: una descrizione del flusso.
- Impostazioni ML. Puoi inoltre accedere alle impostazioni di Flow ML e descritte nelle impostazioni ML dell'agente.
- Rilevamento automatico della lingua Il rilevamento automatico della lingua consente di specificare le lingue degli utenti finali che Dialogflow deve riconoscere e utilizzare automaticamente. Per i dettagli, consulta la documentazione sul rilevamento automatico della lingua.
- Impostazioni vocali avanzate: queste impostazioni vocali possono facoltativamente sostituire le stesse impostazioni vocali dell'agente.
- Impostazioni di adattamento vocale: impostazioni di adattamento vocale a livello di flusso con istruzioni più dettagliate nell' adattamento vocale manuale.
Per ulteriori informazioni su come i dati vengono applicati a vari livelli, consulta Livelli di applicazione dei dati.
Per accedere alle impostazioni del flusso:
Console
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Passa il mouse sopra il flusso nella sezione Flows.
- Fai clic sul pulsante delle opzioni more_vert.
- Seleziona Impostazioni flusso.
- Sfoglia o modifica le impostazioni.
- Fai clic su Salva per salvare le modifiche.
API
Visualizza i metodi get e patch/update per il tipo Flow.
Seleziona un protocollo e una versione per il riferimento di Flow:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di flusso | Interfaccia di flusso |
| C++ | FlowsClient | Non disponibile |
| C# | FlowsClient | Non disponibile |
| Go | FlowsClient | Non disponibile |
| Java | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | Non disponibile | Non disponibile |
| Python | FlowsClient | FlowsClient |
| Ruby | Non disponibile | Non disponibile |
Elimina un flusso
Per eliminare un flusso:
Console
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Passa il mouse sopra il flusso nella sezione Flows.
- Fai clic sul pulsante delle impostazioni more_vert.
- Seleziona Elimina.
API
Visualizza il metodo delete per il tipo Flow.
Seleziona un protocollo e una versione per il riferimento di Flow:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di flusso | Interfaccia di flusso |
| C++ | FlowsClient | Non disponibile |
| C# | FlowsClient | Non disponibile |
| Go | FlowsClient | Non disponibile |
| Java | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | Non disponibile | Non disponibile |
| Python | FlowsClient | FlowsClient |
| Ruby | Non disponibile | Non disponibile |
Addestra un flusso
Per addestrare un flusso:
Console
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Fai clic su Impostazioni agente.
- Apri la scheda ML.
- Per addestrare un singolo flusso, fai clic su Addestra nella riga corrispondente.
- Per addestrare più flussi, selezionali con le caselle di controllo, quindi fai clic su Addestra il modello NLU di flusso selezionato.
API
Visualizza il metodo train per il tipo Flow.
Seleziona un protocollo e una versione per il riferimento di Flow:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di flusso | Interfaccia di flusso |
| C++ | FlowsClient | Non disponibile |
| C# | FlowsClient | Non disponibile |
| Go | FlowsClient | Non disponibile |
| Java | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | Non disponibile | Non disponibile |
| Python | FlowsClient | FlowsClient |
| Ruby | Non disponibile | Non disponibile |
Esporta un flusso
Puoi esportare un flusso in due modi:
Esportazione dei dati: esporta 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 è disegno XML, quindi puoi importare il diagramma in Lucidchart, diagrams.net o in qualsiasi altro strumento per i diagrammi in grado di importare il formato disegno.io. Quando esegui i passaggi riportati di seguito, scegli il formato dei dati XML.
Puoi esportare un flusso con le seguenti opzioni:
- Includi flussi di riferimento: esporta il flusso di destinazione e tutti i livelli dei flussi di riferimento. I flussi di riferimento includono i flussi a cui fa riferimento il flusso target, oltre a quelli indicati nei successivi flussi di riferimento, senza profondità massima. Durante l'importazione, verranno importati tutti i flussi esportati e le transizioni tra questi flussi verranno mantenute.
Per esportare un flusso:
Console
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Passa il mouse sopra il flusso nella sezione Flows.
- Fai clic sul pulsante delle opzioni more_vert.
- Seleziona Esporta flusso.
- Segui le istruzioni per completare l'operazione.
API
Visualizza il metodo export per il tipo Flow.
Seleziona un protocollo e una versione per il riferimento di Flow:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di flusso | Interfaccia di flusso |
| C++ | FlowsClient | Non disponibile |
| C# | FlowsClient | Non disponibile |
| Go | FlowsClient | Non disponibile |
| Java | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | Non disponibile | Non disponibile |
| Python | FlowsClient | FlowsClient |
| Ruby | Non disponibile | Non disponibile |
Importa 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 dispone di risorse globali con gli stessi nomi visualizzati trovati nell'agente di origine, Dialogflow 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 dell'agente di origine verranno aggiunte con un suffisso distintivo nel nome.
- Conserva le risorse originali: le risorse dell'agente di destinazione rimarranno invariate.
Per importare un flusso:
Console
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Fai clic sul pulsante Aggiungi add nella sezione Flussi.
- Seleziona Flusso di importazione.
- Segui le istruzioni per completare l'operazione.
API
Visualizza il metodo import per il tipo Flow.
Seleziona un protocollo e una versione per il riferimento di Flow:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di flusso | Interfaccia di flusso |
| C++ | FlowsClient | Non disponibile |
| C# | FlowsClient | Non disponibile |
| Go | FlowsClient | Non disponibile |
| Java | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | Non disponibile | Non disponibile |
| Python | FlowsClient | FlowsClient |
| Ruby | Non disponibile | Non disponibile |