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.
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
truesimples 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 inicial de referência em solicitações de API
Para fazer referência à página inicial de um fluxo nas solicitações da API de ambiente de execução, use START_PAGE como
ID da página.
Para fazer mudanças no tempo de design em uma página inicial usando a API, use os métodos de 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 Flow | Recurso Flow |
| RPC (remote procedure call) | Interface Flow | Interface Flow |
| 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 |
crie um fluxo
Para criar um fluxo:
Console
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Clique no botão de adição add na seção Flows.
- Selecione Criar fluxo.
- Informe o nome de exibição do seu fluxo.
- 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 Flow | Recurso Flow |
| RPC (remote procedure call) | Interface Flow | Interface Flow |
| 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
- Abra o Console do Dialogflow CX.
- Escolha o projeto do Google Cloud para o agente.
- Encontre o agente na lista.
- Clique no nome de exibição do agente.
- Clique no fluxo na seção Fluxos.
- 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.
- Clique no fluxo no gráfico.
- Um painel de edição de fluxo é exibido. Use esse painel para procurar e editar dados de fluxo adicionais.
- 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 Flow | Recurso Flow |
| RPC (remote procedure call) | Interface Flow | Interface Flow |
| 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 |
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:
- 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 aplicativo 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 do usuário final o Dialogflow deve reconhecer e responder automaticamente. Consulte a documentação sobre detecção automática de idiomas para mais detalhes.
- Configurações de fala avançadas: essas configurações de fala podem, opcionalmente, substituir as mesmas configurações de fala do agente.
- Configurações de adaptação de fala: configurações de adaptação de fala de nível de fluxo com instruções mais detalhadas em adaptação de fala manual.
Para mais informações sobre como os dados são aplicados em níveis variados, consulte os níveis de aplicativo de dados.
Para acessar as configurações de fluxo:
Console
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Passe o cursor do mouse sobre o fluxo na seção Fluxos.
- Clique no botão de opções more_vert.
- Selecione Configurações de fluxo.
- Procure ou edite as configurações.
- 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 Flow | Recurso Flow |
| RPC (remote procedure call) | Interface Flow | Interface Flow |
| 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
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Passe o cursor do mouse sobre o fluxo na seção Fluxos.
- Clique no botão de configuraçõesmore_vert.
- 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 Flow | Recurso Flow |
| RPC (remote procedure call) | Interface Flow | Interface Flow |
| 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
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Clique em Configurações do agente.
- Abra a guia ML.
- Para treinar um único fluxo, clique em Train na linha correspondente.
- 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 Flow | Recurso Flow |
| RPC (remote procedure call) | Interface Flow | Interface Flow |
| 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 o 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 de dados brutos.
Exportação de diagrama (Visualizar): exporta seu fluxo como um diagrama visual. O formato de exportação é draw.io XML, então é possível importar o diagrama em Lucidchart, diagrams.net ou em qualquer outra ferramenta de diagrama que possa importar o formato 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 dos fluxos referenciados. Os fluxos referenciados incluem aqueles a que o fluxo de destino está referenciando, além daqueles 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 esses fluxos serão preservadas.
Para exportar um fluxo, faça o seguinte:
Console
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Passe o cursor do mouse sobre o fluxo na seção Fluxos.
- Clique no botão de opções more_vert.
- Selecione Fluxo de exportação.
- 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 Flow | Recurso Flow |
| RPC (remote procedure call) | Interface Flow | Interface Flow |
| 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 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 algum recurso global com os mesmos nomes de exibição encontrados no agente de origem, o Dialogflow fornecerá um resumo desses recursos com três opções para resolver os conflitos desses recursos:
- Substituir os recursos existentes: 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
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Clique no botão de adição add na seção Flows.
- Selecione Fluxo de importação.
- 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 Flow | Recurso Flow |
| RPC (remote procedure call) | Interface Flow | Interface Flow |
| 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 |