Fluxos

Caixas de diálogo complexas geralmente envolvem vários tópicos de conversa. Por exemplo, um agente de entrega de pizza pode ter pedido, informações do cliente e confirmação como os diferentes tópicos. Cada tópico requer várias rodadas de conversa para que um agente consiga as informações relevantes do usuário final.

Os fluxos são usados para definir esses tópicos e os caminhos de conversa associados. Cada agente tem um fluxo chamado fluxo inicial padrão. Esse fluxo único pode ser tudo o que você precisa para um agente simples. Agentes mais complexos podem exigir fluxos adicionais, e diferentes membros da equipe de desenvolvimento podem ser responsáveis por criar e manter esses fluxos. Por exemplo, os fluxos de um agente de entrega de pizza podem ser semelhantes a:

Os fluxos do Dialogflow CX têm uma finalidade semelhante à dos subagentes para mega-agentes do Dialogflow ES. Os fluxos oferecem melhor controle de conversas e não geram custos extras.

Fluxo inicial padrão

Quando você cria um agente, o Fluxo de início padrão é criado automaticamente. Em um agente simples, é possível usar esse fluxo como seu único fluxo. Para agentes mais complexos, é possível adicionar mais fluxos, e o fluxo de início padrão pode ser usado como um ponto de entrada simples para a conversa.

Observação: não é possível excluir o fluxo de início padrão.

Ao usar a API, faça referência ao fluxo inicial padrão com o seguinte ID de fluxo:

00000000-0000-0000-0000-000000000000

Página inicial de fluxo

Todo fluxo tem uma página especial chamada Iniciar no console. Quando um fluxo é selecionado no console, a página inicial é mostrada como um nó no gráfico. Quando um fluxo se torna inicialmente ativo, essa página se torna a página ativa atual.

Uma página inicial não tem mensagens de parâmetros ou respostas, como páginas normais. No entanto, é possível enviar uma mensagem usando uma das seguintes abordagens:

• Propagação de intents
• Use uma condição true simples em uma rota que tenha uma resposta de fulfillment ou uma meta de transição para uma página normal com fulfillment de entrada.
• Eventos personalizados

Ao usar a API, é possível referenciar a página inicial de um fluxo com o seguinte ID da página:

START_PAGE

Criar um fluxo

Para criar um fluxo:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Clique no botão de adição na seção Flows.
5. Selecione Criar fluxo.
6. Informe o nome de exibição do seu fluxo.
7. Clique no fluxo que você acabou de criar.

API

Veja o método create para o tipo Flow. Acessar a referência da API Flow

Selecione um protocolo e uma versão para a referência do fluxo:

Protocolo	V3	V3beta1
REST	Recurso de fluxo	Recurso de fluxo
RPC (remote procedure call)	Interface de navegação	Interface de navegação
C++	FlowsClient.	Indisponível
C#	FlowsClient.	Indisponível
Go	FlowsClient.	Indisponível
Java	FlowsClient.	FlowsClient.
Node.js	FlowsClient.	FlowsClient.
PHP	Indisponível	Indisponível
Python	FlowsClient.	FlowsClient.
Ruby	Indisponível	Indisponível

Fechar

Dados de fluxo

Para acessar os dados de um fluxo:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha o projeto do Google Cloud para o agente.
3. Encontre o agente na lista.
4. Clique no nome de exibição do agente.
5. Clique no fluxo na seção Fluxos.
6. As páginas do fluxo são preenchidas na seção Páginas. Consulte o guia de páginas para ver informações sobre como editar páginas.
7. Clique no fluxo no gráfico.
8. Um painel de edição de fluxo é exibido. Use esse painel para procurar e editar dados de fluxo adicionais.
9. Clique em Salvar para salvar as alterações.

API

Para fluxos, consulte get e patch/update para o tipo Flow. Acessar a referência da API Flow

Selecione um protocolo e uma versão para a referência do fluxo:

Protocolo	V3	V3beta1
REST	Recurso de fluxo	Recurso de fluxo
RPC (remote procedure call)	Interface de navegação	Interface de navegação
C++	FlowsClient.	Indisponível
C#	FlowsClient.	Indisponível
Go	FlowsClient.	Indisponível
Java	FlowsClient.	FlowsClient.
Node.js	FlowsClient.	FlowsClient.
PHP	Indisponível	Indisponível
Python	FlowsClient.	FlowsClient.
Ruby	Indisponível	Indisponível

Fechar

Para páginas, consulte os métodos get e patch/update para o tipo Page. Acessar a referência da API Page

Selecione um protocolo e uma versão para a referência da página:

Protocolo	V3	V3beta1
REST	Recurso da página	Recurso da página
RPC (remote procedure call)	Interface da página	Interface da página
C++	PagesClient.	Indisponível
C#	PagesClient.	Indisponível
Go	PagesClient.	Indisponível
Java	PagesClient.	PagesClient.
Node.js	PagesClient.	PagesClient.
PHP	Indisponível	Indisponível
Python	PagesClient.	PagesClient.
Ruby	Indisponível	Indisponível

Fechar

Os seguintes dados estão associados a fluxos:

• Páginas: a lista de páginas que compõem o fluxo.
• Rotas: todas essas rotas podem ser chamadas quando a página inicial do fluxo está ativa. Rotas com um requisito de intent podem ser seguidas quando outras páginas do fluxo estão ativas. Para saber detalhes, consulte Escopo do gerenciador de estado e Rotas no nível do fluxo.
• Manipuladores de eventos: esses manipuladores podem ser chamados quando o fluxo está ativo. Para ver detalhes, consulte Gerenciadores de eventos no nível do fluxo

Para mais informações sobre como os dados são aplicados em níveis variados, consulte os níveis de aplicativos de dados.

Configurações de fluxo

As configurações a seguir estão disponíveis para fluxos:

• Nome de exibição: um nome legível para o fluxo.
• Descrição: uma descrição do fluxo.
• Configurações de ML As configurações do Flow ML também são acessadas e descritas nas configurações do ML do agente.
• Configurações de fala avançadas: essas configurações de fala podem, opcionalmente, substituir as mesmas configurações de fala do agente.

Para mais informações sobre como os dados são aplicados em níveis variados, consulte os níveis de aplicativos de dados.

Para acessar as configurações de fluxo:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Passe o cursor do mouse sobre o fluxo na seção Fluxos.
5. Clique no botão de opções .
6. Selecione Configurações de fluxo.
7. Procure ou edite as configurações.
8. Clique em Salvar para salvar as alterações.

API

Veja os métodos get e patch/update para o tipo Flow. Acessar a referência da API Flow

Selecione um protocolo e uma versão para a referência do fluxo:

Protocolo	V3	V3beta1
REST	Recurso de fluxo	Recurso de fluxo
RPC (remote procedure call)	Interface de navegação	Interface de navegação
C++	FlowsClient.	Indisponível
C#	FlowsClient.	Indisponível
Go	FlowsClient.	Indisponível
Java	FlowsClient.	FlowsClient.
Node.js	FlowsClient.	FlowsClient.
PHP	Indisponível	Indisponível
Python	FlowsClient.	FlowsClient.
Ruby	Indisponível	Indisponível

Fechar

Excluir um fluxo

Para excluir um fluxo:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Passe o cursor do mouse sobre o fluxo na seção Fluxos.
5. Clique no botão de configurações.
6. Selecione Excluir.

API

Veja o método delete para o tipo Flow. Acessar a referência da API Flow

Selecione um protocolo e uma versão para a referência do fluxo:

Protocolo	V3	V3beta1
REST	Recurso de fluxo	Recurso de fluxo
RPC (remote procedure call)	Interface de navegação	Interface de navegação
C++	FlowsClient.	Indisponível
C#	FlowsClient.	Indisponível
Go	FlowsClient.	Indisponível
Java	FlowsClient.	FlowsClient.
Node.js	FlowsClient.	FlowsClient.
PHP	Indisponível	Indisponível
Python	FlowsClient.	FlowsClient.
Ruby	Indisponível	Indisponível

Fechar

Treinar um fluxo

Para treinar um fluxo:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Clique em Configurações do agente.
5. Abra a guia ML.
6. Para treinar um único fluxo, clique em Train na linha correspondente.
7. Para treinar vários fluxos, marque as caixas de seleção e clique em Train selected flow NLU model.

API

Veja o método train para o tipo Flow. Acessar a referência da API Flow

Selecione um protocolo e uma versão para a referência do fluxo:

Protocolo	V3	V3beta1
REST	Recurso de fluxo	Recurso de fluxo
RPC (remote procedure call)	Interface de navegação	Interface de navegação
C++	FlowsClient.	Indisponível
C#	FlowsClient.	Indisponível
Go	FlowsClient.	Indisponível
Java	FlowsClient.	FlowsClient.
Node.js	FlowsClient.	FlowsClient.
PHP	Indisponível	Indisponível
Python	FlowsClient.	FlowsClient.
Ruby	Indisponível	Indisponível

Fechar

Exportar um fluxo

É possível exportar um fluxo de duas maneiras:

• Exportação de dados: exporta o fluxo como dados brutos, para que possa ser importado para qualquer agente. Quando você exporta um fluxo, os recursos referenciados pelo fluxo (intents, entidades, webhooks) também são exportados. Ao seguir as etapas abaixo, escolha o formato de dados brutos.

• Exportação de diagrama (visualização): exporta seu fluxo como um diagrama visual. O formato de exportação é XML em draw.io. Assim, é possível importar o diagrama em Lucidchart, diagrams.net ou qualquer outra ferramenta de diagrama que possa importar o formato draw.io. Ao seguir as etapas abaixo, escolha o formato de dados XML.

  Observação: a exportação de diagrama não está disponível para agentes que usam CMEK.

É possível exportar um fluxo com as seguintes opções:

• Incluir fluxos referenciados: exporta o fluxo atual e os fluxos a que ele se refere (tem transições). Durante a importação, todos os fluxos exportados serão importados, e as transições entre eles serão preservadas.

Para exportar um fluxo, faça o seguinte:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Passe o cursor do mouse sobre o fluxo na seção Fluxos.
5. Clique no botão de opções .
6. Selecione Fluxo de exportação.
7. Siga as instruções para concluir.

API

Veja o método export para o tipo Flow. Acessar a referência da API Flow

Selecione um protocolo e uma versão para a referência do fluxo:

Protocolo	V3	V3beta1
REST	Recurso de fluxo	Recurso de fluxo
RPC (remote procedure call)	Interface de navegação	Interface de navegação
C++	FlowsClient.	Indisponível
C#	FlowsClient.	Indisponível
Go	FlowsClient.	Indisponível
Java	FlowsClient.	FlowsClient.
Node.js	FlowsClient.	FlowsClient.
PHP	Indisponível	Indisponível
Python	FlowsClient.	FlowsClient.
Ruby	Indisponível	Indisponível

Fechar

Importar um fluxo

Quando você importa um fluxo de um agente de origem para um agente de destino, os recursos globais referenciados pelo fluxo (intents, entidades, webhooks) são importados com os dados específicos do fluxo. Se o agente de destino tiver recursos globais com os mesmos nomes de exibição encontrados no agente de origem, o Dialogflow fornecerá um resumo desses recursos, além de três opções para resolver os conflitos desses recursos:

• Substituir recursos atuais: os recursos do agente de origem substituirão os recursos do agente de destino.
• Importar como novos recursos: os recursos do agente de origem serão adicionados com um sufixo distinto no nome.
• Manter os recursos originais: os recursos do agente de destino não serão alterados.

Para importar um fluxo, faça o seguinte:

Console

1. Abra o Console do Dialogflow CX.
2. Escolha seu projeto do Google Cloud.
3. Selecione seu agente.
4. Clique no botão de adição na seção Flows.
5. Selecione Fluxo de importação.
6. Siga as instruções para concluir.

API

Veja o método import para o tipo Flow. Acessar a referência da API Flow

Selecione um protocolo e uma versão para a referência do fluxo:

Protocolo	V3	V3beta1
REST	Recurso de fluxo	Recurso de fluxo
RPC (remote procedure call)	Interface de navegação	Interface de navegação
C++	FlowsClient.	Indisponível
C#	FlowsClient.	Indisponível
Go	FlowsClient.	Indisponível
Java	FlowsClient.	FlowsClient.
Node.js	FlowsClient.	FlowsClient.
PHP	Indisponível	Indisponível
Python	FlowsClient.	FlowsClient.
Ruby	Indisponível	Indisponível

Fechar