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:

Exemplo de diagrama com vários fluxos.

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.

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:

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

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

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

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.

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

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.

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
Para páginas, consulte os métodos get e patch/update para o tipo 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

Os seguintes dados estão associados a fluxos:

Para mais informações sobre como os dados são aplicados em vários 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 Com a detecção automática de idioma, é possível especificar em quais idiomas dos usuários finais os agentes de conversação (Dialogflow CX) devem reconhecer e responder automaticamente. Consulte a documentação de detecção automática de idioma 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 ou excluir grupos de rotas no nível do fluxo.
    4. 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.
  • Configurações avançadas de fala: essas configurações avançadas de fala 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.

  • Parâmetros de entrada: Parâmetros do playbook de tarefas que são disponibilizados para o fluxo.

  • Parâmetros de retorno: parâmetros que o fluxo retorna para um playbook de tarefas.

Para mais informações sobre como os dados são aplicados em vários 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.

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

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.

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

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.

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

Exportar um fluxo

É possível exportar um fluxo de duas maneiras:

  • Exportação de dados: exporta seu fluxo como dados brutos, para que ele 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 dados brutos.

  • Exportação de diagrama (prévia): exporta seu fluxo como um diagrama visual. O formato de exportação é XML do draw.io, assim você pode importar o diagrama para 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.

É 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.

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

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, além de três opções para resolver os conflitos desses recursos:

  • Substituir recursos atuais: os recursos do agente de origem vão substituir os do agente de destino.
  • Importar como novos recursos: Os recursos do agente de origem serão adicionados com um sufixo distinto no nome.
  • Manter 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.

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