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:

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: o fluxo inicial padrão não pode ser excluído.

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

Página de referência inicial em solicitações de API

Para referenciar a página inicial de um fluxo em solicitações de API de execução, use START_PAGE como um ID da página.

Para fazer mudanças no design de uma página inicial usando a API, use os métodos get e patch/update da API 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 fluxo	Interface de fluxo
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

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 fluxo	Interface de fluxo
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 fluxo	Interface de fluxo
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 diferentes níveis, consulte os níveis de aplicação 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.
• Detecção automática de idioma A detecção automática de idioma permite especificar em quais idiomas os agentes de conversação (Dialogflow CX) precisam reconhecer e responder automaticamente. Consulte a documentação sobre a detecção automática de idiomas para mais detalhes.

• Bloqueio de fluxo: um fluxo bloqueado não pode ser editado, incluindo as seguintes mudanças nos recursos filhos:

  1. Não é possível criar, editar ou excluir páginas.
  2. Não é possível criar, editar ou excluir versões.
  3. Não é possível criar, editar nem excluir grupos de trajetos no nível do fluxo.
  4. Os grupos de rotas no nível do agente referenciados por um fluxo bloqueado ou qualquer página em um fluxo bloqueado não podem ser excluídos, mas ainda podem ser editados.
  Observação: não será possível mudar essa configuração se a trava estiver ativada no nível do agente.

• Configurações de fala avançadas: essas configurações de fala avançadas podem substituir as mesmas configurações de fala do agente.

• Configurações de adaptação de fala: configurações de adaptação de fala no nível do fluxo com instruções mais detalhadas em adaptação de fala manual.

Para mais informações sobre como os dados são aplicados em diferentes níveis, consulte os níveis de aplicação 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 fluxo	Interface de fluxo
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 fluxo	Interface de fluxo
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 fluxo	Interface de fluxo
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

Há duas maneiras de exportar um fluxo:

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

• Exportação de diagrama (pré-visualização): exporta seu fluxo como um diagrama visual. O formato de exportação é XML do draw.io. Portanto, você pode importar o diagrama no Lucidchart, diagrams.net ou qualquer outra ferramenta de diagrama que possa importar o formato do 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 o CMEK.

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

• Incluir fluxos referenciados: exporta o fluxo de destino e todos os níveis de fluxos referenciados. Os fluxos referenciados incluem os fluxos que o fluxo de destino está referenciando, além dos fluxos referenciados por fluxos referenciados subsequentes, sem profundidade máxima. 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 fluxo	Interface de fluxo
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 junto 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, os agentes de conversação (Dialogflow CX) vão fornecer um resumo desses recursos, com três opções para resolver os conflitos:

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

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 fluxo	Interface de fluxo
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