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: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:
- Propagação de intenções
- Use uma
true
condição simples numa rota que tenha uma resposta de processamento ou um destino de transição para uma página normal com processamento de entrada. - Eventos personalizados
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
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Clique no botão Adicionar add na secção Fluxos.
- Selecione Criar fluxo.
- Introduza um nome a apresentar para o fluxo.
- 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
- Abra a consola do Dialogflow CX.
- Escolha o projeto do Google Cloud para o agente.
- Encontre o agente na lista.
- Clique no nome a apresentar do agente.
- Clique no fluxo na secção Fluxos.
- 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.
- Clique no fluxo no gráfico.
- É apresentado um painel de edição de fluxo. Use este painel para procurar e editar dados adicionais do fluxo.
- 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 |
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:
- Páginas: A lista de páginas que compõem o fluxo.
- Routes: Todas estas rotas podem ser chamadas quando a página inicial do fluxo está ativa. Os trajetos com um requisito de intenção podem ser seguidos quando outras páginas do fluxo estão ativas. Para ver detalhes, consulte os artigos Âmbito do controlador de estado e Rotas ao nível do fluxo.
- Controladores de eventos: estes controladores podem ser chamados quando o fluxo está ativo. Para obter detalhes, consulte o artigo Controladores de eventos ao nível do fluxo
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:
- Não é possível criar, editar nem eliminar páginas.
- Não é possível criar, editar nem eliminar versões.
- Não é possível criar, editar nem eliminar grupos de rotas ao nível do fluxo.
- 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
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Passe o cursor do rato sobre o fluxo na secção Fluxos.
- Clique no botão de opções more_vert.
- Selecione Definições do fluxo.
- Procurar ou editar definições.
- 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
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Passe o cursor do rato sobre o fluxo na secção Fluxos.
- Clique no botão de definições more_vert
- 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
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Clique em Definições do agente.
- Abra o separador ML.
- Para formar um único fluxo, clique em Formar na linha correspondente.
- 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
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Passe o cursor do rato sobre o fluxo na secção Fluxos.
- Clique no botão de opções more_vert.
- Selecione Exportar fluxo.
- 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
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Clique no botão Adicionar add na secção Fluxos.
- Selecione Fluxo de importação.
- 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 |