I dialoghi complessi spesso coinvolgono più argomenti di conversazione. Ad esempio, un addetto alle consegne di pizze potrebbe avere ordine di cibo, informazioni sul cliente e conferma come argomenti distinti. Ogni argomento richiede più turni conversazionali per consentire a un 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 chiamato Default Start Flow. 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 agente di consegna di pizze potrebbero avere il seguente aspetto:Flusso di avvio predefinito
Quando crei un agente, viene creato automaticamente il flusso di avvio predefinito. Per un agente semplice, puoi utilizzare questo flusso come unico flusso. Per gli 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 Inizia nella console. Quando un flusso viene selezionato nella console, la pagina iniziale viene visualizzata come un nodo nel grafico. Quando un flusso diventa attivo per la prima volta, 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 utilizzando uno dei seguenti approcci:
- Propagazione dell'intent
- Utilizza una condizione
true
semplice in una route che abbia una risposta di completamento o una destinazione di transizione a una pagina normale con completamento dell'inserimento. - Eventi personalizzati
Pagina iniziale di riferimento nelle richieste API
Per fare riferimento alla pagina iniziale di un flusso nelle richieste dell'API runtime, utilizza START_PAGE
come ID pagina.
Per apportare modifiche in fase di progettazione a una pagina iniziale 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 al 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 il tuo agente.
- Fai clic sul pulsante add Aggiungi nella sezione Flussi.
- Seleziona Crea flusso.
- Inserisci un nome visualizzato per il flusso.
- Fai clic sul flusso appena creato.
API
Consulta il metodo create
per il tipo Flow
.
Seleziona un protocollo e una versione per il riferimento al 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 |
Dati sul 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 di flusso.
- Fai clic su Salva per salvare le modifiche.
API
Per i flussi, vedi get
e patch/update
per il tipo Flow
.
Seleziona un protocollo e una versione per il riferimento al 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 |
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 |
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 delle pagine che compongono il flusso.
- Percorsi: Tutti questi percorsi possono essere chiamati quando la pagina iniziale del flusso è attiva. I percorsi con un requisito di intent possono essere seguiti quando altre pagine del flusso sono attive. Per i dettagli, vedi 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, vedi Gestori di eventi a livello di flusso
Per ulteriori informazioni su come vengono applicati i dati a vari livelli, consulta i 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 ti consente di specificare le lingue degli utenti finali che Conversational Agents (Dialogflow CX) deve riconoscere e in cui deve rispondere automaticamente. Per ulteriori dettagli, consulta la documentazione sul rilevamento automatico della lingua.
Blocco del flusso: Un flusso bloccato non può essere modificato, incluse le seguenti modifiche alle risorse figlio:
- Le pagine non possono essere create, modificate o eliminate.
- Versioni non possono essere create, modified, deleted.
- I gruppi di route a livello di flusso non possono essere creati, modificati o eliminati.
- I gruppi di route a livello di agente a cui fa riferimento un flusso bloccato o qualsiasi pagina di un flusso bloccato non possono essere eliminati, ma possono comunque essere modificati.
Impostazioni avanzate per la sintesi vocale: Queste impostazioni avanzate per la sintesi vocale possono facoltativamente sostituire le stesse impostazioni di sintesi vocale dell'agente.
Impostazioni di adattamento vocale: Impostazioni di adattamento vocale a livello di flusso con istruzioni più dettagliate in adattamento vocale manuale.
Parametri di input: Parametri del playbook delle attività che vengono resi disponibili per il flusso.
Parametri restituiti: Parametri che il flusso restituisce a un playbook di attività.
Per ulteriori informazioni su come vengono applicati i dati a vari livelli, consulta i livelli di applicazione dei dati.
Per accedere alle impostazioni del 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 Flussi.
- Fai clic sul pulsante more_vert Opzioni.
- Seleziona Impostazioni del flusso.
- Sfoglia o modifica le impostazioni.
- 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 al 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 |
Eliminare un flusso
Per eliminare 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 Flussi.
- Fai clic sul pulsante Impostazioni more_vert.
- Seleziona Elimina.
API
Consulta il metodo delete
per il tipo Flow
.
Seleziona un protocollo e una versione per il riferimento al 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 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
Consulta il metodo train
per il tipo Flow
.
Seleziona un protocollo e una versione per il riferimento al 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 |
Esportare 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 (intent, entità, webhook). Quando segui i passaggi riportati di seguito, scegli il formato dei dati 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 di 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 di riferimento: Esporta il flusso di destinazione e tutti i livelli dei flussi di riferimento. I flussi a cui viene fatto riferimento includono i flussi a cui fa riferimento il flusso di destinazione, oltre ai flussi a cui fanno riferimento i flussi a cui viene fatto riferimento successivi, senza una profondità massima. Durante l'importazione, tutti i flussi esportati verranno importati 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 il tuo agente.
- Passa il mouse sopra il flusso nella sezione Flussi.
- Fai clic sul pulsante more_vert Opzioni.
- Seleziona Esporta flusso.
- 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 al 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 |
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 trovati nell'agente di origine, Conversational Agents (Dialogflow CX) fornisce un riepilogo di queste risorse, insieme a tre opzioni per risolvere i conflitti per queste risorse:
- Sostituisci le risorse esistenti: le risorse dell'agente di origine sovrascriveranno quelle dell'agente di destinazione.
- Importa come nuove risorse: Le risorse dell'agente 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
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Fai clic sul pulsante add Aggiungi nella sezione Flussi.
- Seleziona Importa flusso.
- 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 al 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 |