Flows

As caixas de diálogo complexas envolvem frequentemente vários tópicos de conversa. Por exemplo, um agente de entrega de pizzas pode ter encomenda de comida, informações do cliente e confirmação como tópicos distintos. Cada tópico requer várias interações de conversa para que um agente adquira as informações relevantes do utilizador final.

Os fluxos são usados para definir estes tópicos e os caminhos de conversa associados. Cada agente tem um fluxo denominado Fluxo de início predefinido. Este fluxo único pode ser tudo o que precisa para um agente simples. Os agentes mais complicados podem exigir fluxos adicionais, e os diferentes membros da equipa de programação podem ser responsáveis pela criação e manutenção destes fluxos. Por exemplo, os fluxos de um agente de entrega de pizzas podem ter o seguinte aspeto:

Exemplo de diagrama de vários fluxos.

Fluxo de início predefinido

Quando cria um agente, o fluxo de início predefinido é criado automaticamente. Para um agente simples, pode usar este fluxo como o seu único fluxo. Para agentes mais complexos, pode adicionar mais fluxos, e o fluxo de início predefinido pode ser usado como um ponto de entrada simples para a conversa.

Quando usar a API, pode fazer referência ao fluxo de início predefinido com o seguinte ID do fluxo:

00000000-0000-0000-0000-000000000000

Página de início do fluxo

Cada fluxo tem uma página especial denominada Início na consola. Quando um fluxo é selecionado na consola, a página inicial é apresentada como um nó no gráfico. Quando um fluxo se torna ativo inicialmente, esta página torna-se a página atual e ativa.

Uma página de início não tem parâmetros nem mensagens de respostas como as páginas normais. No entanto, pode enviar uma mensagem através de uma das seguintes abordagens:

Faça referência à página inicial nos pedidos de API

Para fazer referência à página inicial de um fluxo em pedidos de API de tempo de execução, use START_PAGE como um ID da página.

Para fazer alterações em tempo de design a uma página inicial através da API, use os métodos da API 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 Interface do Flow Interface do Flow
C++ FlowsClient Não disponível
C# FlowsClient Não disponível
Ir FlowsClient Não disponível
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Não disponível Não disponível
Python FlowsClient FlowsClient
Ruby Não disponível Não disponível

Crie um fluxo

Para criar um fluxo:

Consola

  1. Abra a consola do Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud.
  3. Selecione o seu agente.
  4. Clique no botão Adicionar na secção Fluxos.
  5. Selecione Criar fluxo.
  6. Introduza um nome a apresentar para o fluxo.
  7. Clique no fluxo que acabou de criar.

API

Consulte 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 Interface do Flow Interface do Flow
C++ FlowsClient Não disponível
C# FlowsClient Não disponível
Ir FlowsClient Não disponível
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Não disponível Não disponível
Python FlowsClient FlowsClient
Ruby Não disponível Não disponível

Dados de fluxo

Para aceder aos dados de um fluxo:

Consola

  1. Abra a consola do Dialogflow CX.
  2. Escolha o projeto do Google Cloud para o agente.
  3. Encontre o agente na lista.
  4. Clique no nome a apresentar do agente.
  5. Clique no fluxo na secção Fluxos.
  6. As páginas do fluxo são preenchidas na secção Páginas. Consulte o guia de páginas para ver informações sobre a edição de páginas.
  7. Clique no fluxo no gráfico.
  8. É apresentado um painel de edição de fluxo. Use este painel para procurar e editar dados adicionais do fluxo.
  9. Clique em Guardar para guardar as alterações.

API

Para fluxos, consulte o get e o 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 Interface do Flow Interface do Flow
C++ FlowsClient Não disponível
C# FlowsClient Não disponível
Ir FlowsClient Não disponível
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Não disponível Não disponível
Python FlowsClient FlowsClient
Ruby Não disponível Não disponí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 de página Recurso de página
RPC Interface de página Interface de página
C++ PagesClient Não disponível
C# PagesClient Não disponível
Ir PagesClient Não disponível
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP Não disponível Não disponível
Python PagesClient PagesClient
Ruby Não disponível Não disponível

Os seguintes dados estão associados aos fluxos:

Para mais informações sobre como os dados são aplicados a vários níveis, consulte os níveis de aplicação de dados.

Definições do fluxo

As seguintes definições estão disponíveis para fluxos:

  • Nome a apresentar: Um nome legível para o fluxo.
  • Descrição: Uma descrição do fluxo.
  • Definições de ML As definições de ML de fluxo também são acedidas e descritas nas definições de ML do agente.
  • Deteção automática de idioma A deteção automática de idioma permite-lhe especificar os idiomas do utilizador final que os agentes conversacionais (Dialogflow CX) devem reconhecer e nos quais devem responder automaticamente. Consulte a documentação sobre a deteção automática de idiomas para ver detalhes.
  • Bloqueio de fluxo: Não é possível editar um fluxo bloqueado, incluindo as seguintes alterações aos respetivos recursos subordinados:

    1. Não é possível criar, editar nem eliminar páginas.
    2. Não é possível criar, editar nem eliminar versões.
    3. Não é possível criar, editar nem eliminar grupos de rotas ao nível do fluxo.
    4. Não é possível eliminar grupos de encaminhamento ao nível do agente referenciados por um fluxo bloqueado ou qualquer página num fluxo bloqueado, mas ainda podem ser editados.
  • Definições avançadas de voz: Estas definições avançadas de voz podem substituir opcionalmente as mesmas definições de voz do agente.

  • Definições de adaptação da voz: Definições de adaptação da voz ao nível do fluxo com instruções mais detalhadas na adaptação manual da voz.

  • Parâmetros de entrada: parâmetros do manual de procedimentos da tarefa que são disponibilizados ao fluxo.

  • Parâmetros de retorno: Parâmetros que o fluxo devolve a um manual de tarefas.

Para mais informações sobre como os dados são aplicados a vários níveis, consulte os níveis de aplicação de dados.

Para aceder às definições do fluxo:

Consola

  1. Abra a consola do Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud.
  3. Selecione o seu agente.
  4. Passe o cursor do rato sobre o fluxo na secção Fluxos.
  5. Clique no botão de opções .
  6. Selecione Definições do fluxo.
  7. Procurar ou editar definições.
  8. Clique em Guardar para guardar as alterações.

API

Consulte 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 Interface do Flow Interface do Flow
C++ FlowsClient Não disponível
C# FlowsClient Não disponível
Ir FlowsClient Não disponível
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Não disponível Não disponível
Python FlowsClient FlowsClient
Ruby Não disponível Não disponível

Elimine um fluxo

Para eliminar um fluxo:

Consola

  1. Abra a consola do Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud.
  3. Selecione o seu agente.
  4. Passe o cursor do rato sobre o fluxo na secção Fluxos.
  5. Clique no botão de definições
  6. Selecione Eliminar.

API

Consulte 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 Interface do Flow Interface do Flow
C++ FlowsClient Não disponível
C# FlowsClient Não disponível
Ir FlowsClient Não disponível
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Não disponível Não disponível
Python FlowsClient FlowsClient
Ruby Não disponível Não disponível

Forme um fluxo

Para formar um fluxo:

Consola

  1. Abra a consola do Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud.
  3. Selecione o seu agente.
  4. Clique em Definições do agente.
  5. Abra o separador ML.
  6. Para formar um único fluxo, clique em Formar na linha correspondente.
  7. Para formar vários fluxos, selecione-os com as caixas de verificação e, de seguida, clique em Formar modelo de PNL do fluxo selecionado.

API

Consulte 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 Interface do Flow Interface do Flow
C++ FlowsClient Não disponível
C# FlowsClient Não disponível
Ir FlowsClient Não disponível
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Não disponível Não disponível
Python FlowsClient FlowsClient
Ruby Não disponível Não disponível

Exporte um fluxo

Pode exportar um fluxo de duas formas:

  • Exportação de dados: Esta opção exporta o seu fluxo como dados não processados, para que possa ser importado para qualquer agente. Quando exporta um fluxo, os recursos referenciados pelo fluxo (intuições, entidades, webhooks) também são exportados. Quando seguir os passos abaixo, escolha o formato de dados dados não processados.

  • Exportação de diagrama (pré-visualização): esta opção exporta o seu fluxo como um diagrama visual. O formato de exportação é XML do draw.io, pelo que pode importar o diagrama no Lucidchart, no diagrams.net ou em qualquer outra ferramenta de diagramas que possa importar o formato do draw.io. Quando seguir os passos abaixo, escolha o formato de dados XML.

Pode 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 aos quais o fluxo de destino faz referência, além dos fluxos referenciados por fluxos referenciados subsequentes, sem profundidade máxima. Durante a importação, todos os fluxos exportados são importados e as transições entre estes fluxos são preservadas.

Para exportar um fluxo:

Consola

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

API

Consulte 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 Interface do Flow Interface do Flow
C++ FlowsClient Não disponível
C# FlowsClient Não disponível
Ir FlowsClient Não disponível
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Não disponível Não disponível
Python FlowsClient FlowsClient
Ruby Não disponível Não disponível

Importe um fluxo

Quando 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 juntamente com os dados específicos do fluxo. Se o agente de destino tiver recursos globais com os mesmos nomes a apresentar encontrados no agente de origem, os agentes conversacionais (Dialogflow CX) fornecem um resumo destes recursos, juntamente com três opções para resolver os conflitos destes recursos:

  • Substituir recursos existentes: 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 recursos originais: os recursos do agente de destino permanecem inalterados.

Para importar um fluxo:

Consola

  1. Abra a consola do Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud.
  3. Selecione o seu agente.
  4. Clique no botão Adicionar na secção Fluxos.
  5. Selecione Fluxo de importação.
  6. Siga as instruções para concluir.

API

Consulte 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 Interface do Flow Interface do Flow
C++ FlowsClient Não disponível
C# FlowsClient Não disponível
Ir FlowsClient Não disponível
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Não disponível Não disponível
Python FlowsClient FlowsClient
Ruby Não disponível Não disponível