Le finestre di dialogo complesse 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 di conversazione per un agente per acquisire le informazioni pertinenti dall'utente finale.
Flussi vengono utilizzati per definire questi argomenti e i percorsi conversazionali associati. Ogni agente ha un flusso chiamato Flusso di inizio predefinito. Questo flusso singolo potrebbe essere tutto ciò di cui hai bisogno per un agente semplice. Gli agenti più complicati possono richiedere flussi aggiuntivi, e diversi membri del team di sviluppo possono essere responsabili della creazione e la gestione di questi flussi. Ad esempio, i flussi di un addetto alla consegna di pizza potrebbero essere i seguenti:
Flusso di inizio predefinito
Quando crei un agente, viene creato automaticamente il Flusso di inizio predefinito. Per un agente semplice, puoi usare questo flusso come unico flusso. Per gli agenti più complessi, puoi aggiungere altri flussi, e puoi utilizzare il flusso di avvio predefinito come semplice punto di accesso alla conversazione.
Quando si utilizza l'API, puoi fare riferimento all'avvio predefinito del flusso 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 nella console è selezionato un flusso, 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 pagine normali. Tuttavia, puoi inviare un messaggio adottando uno dei seguenti approcci:
- Propagazione di intent
- Utilizza una semplice
truecondizione in un percorso che abbia una risposta di adempimento o un target di transizione a una pagina normale con adempimento dell'inserimento. - Eventi personalizzati
Pagina iniziale di riferimento nelle richieste API
Per fare riferimento alla pagina iniziale di un flusso nelle richieste API runtime, usa START_PAGE come
ID pagina.
Per apportare modifiche in fase di progettazione a una pagina iniziale tramite l'API, utilizza get e
patch/update metodi dell'API 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 Flow | Interfaccia 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
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Fai clic sul pulsante di aggiuntaadd nella sezione Fluidi.
- 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 del flusso:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia 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 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 sulla modifica delle 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 del flusso:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di Flow | Interfaccia 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 |
get e patch/update 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 |
I seguenti dati sono associati ai flussi:
- Pagine: L'elenco di pagine che compongono il flusso.
- Percorsi: Tutte queste route possono essere chiamate quando la pagina iniziale per il flusso sia attivo. I percorsi con un requisito di intent possono essere seguiti quando sono attive altre pagine del flusso. Per maggiori dettagli, consulta Ambito dell'handler dello stato e Route a livello di flusso.
- Gestor di eventi: questi gestori possono essere chiamati quando il flusso è attivo. Per maggiori dettagli, vedi Gestori di eventi a livello di flusso
Per ulteriori informazioni su come i dati vengono applicati a diversi livelli, vedi livelli di applicazione dei dati.
Impostazioni del flusso
Per i flussi sono disponibili le seguenti impostazioni:
- Nome visualizzato: un nome leggibile per il flusso.
- Descrizione: una descrizione del flusso.
- Impostazioni ML Le impostazioni ML del flusso sono accessibili e descritte anche nelle impostazioni ML dell'agente.
- Rilevamento automatico della lingua Il rilevamento automatico della lingua consente di specificare le lingue dell'utente finale per gli agenti conversazionali (Dialogflow CX) dovrebbe riconoscere e rispondere automaticamente. Consulta le documentazione relativa al rilevamento automatico della lingua per maggiori dettagli.
Blocco flusso: un flusso bloccato non può essere modificato, incluse le seguenti modifiche alle risorse secondarie:
- Le pagine non possono essere creato, modificato, eliminato.
- Le versioni non possono essere creato, modificato, eliminato.
- Gruppi di percorsi a livello di flusso non può essere creato, modificato, eliminato.
- Gruppi di route a livello di agente a cui fanno riferimento un flusso bloccato o qualsiasi pagina in un flusso bloccato non possono possono essere eliminati, ma sarà comunque possibile modificarli.
Impostazioni avanzate per il parlato: se vuoi, queste impostazioni avanzate per il parlato possono sostituire le stesse impostazioni per il parlato dell'agente.
Impostazioni di adattamento vocale: Impostazioni di adattamento vocale a livello di flusso con istruzioni più dettagliate in adattamento vocale manuale.
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
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Passa il mouse sopra il flusso nella sezione Fluidi.
- Fai clic sulle 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 del flusso:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia di Flow | Interfaccia 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 |
Elimina un flusso
Per eliminare un flusso:
Console
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Passa il mouse sopra il flusso nella sezione Fluidi.
- Fai clic sul pulsante Impostazioni more_vert.
- Seleziona Elimina.
API
Visualizza 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 Flow | Interfaccia 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
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo 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, poi fai clic su Addestra il modello NLU del flusso selezionato.
API
Visualizza 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 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 esegui i passaggi riportati di seguito, scegli il formato dei dati non elaborati.
Esportazione del diagramma (Anteprima): viene esportato il flusso come diagramma visivo. Il formato di esportazione è XML draw.io, puoi quindi importare il diagramma Lucidchart diagrams.net, o qualsiasi altro strumento per i diagrammi in grado di importare il formato draw.io. Quando esegui i passaggi riportati di seguito, scegli il formato 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 a cui fanno riferimento i flussi di riferimento successivi, senza profondità massima. Durante l'importazione, verranno importati tutti i flussi esportati e le transizioni tra questi flussi verranno conservati.
Per esportare un flusso:
Console
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Passa il mouse sopra il flusso nella sezione Fluidi.
- Fai clic sulle 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 del flusso:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia 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, gli agenti conversazionali (Dialogflow CX) forniscono 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.
- Conserva le risorse originali: Le risorse dell'agente target 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 di aggiuntaadd nella sezione Fluidi.
- 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 del flusso:
| Protocollo | V3 | V3beta1 |
|---|---|---|
| REST | Risorsa di flusso | Risorsa di flusso |
| RPC | Interfaccia Flow | Interfaccia 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 |