Versões e ambientes

Pode criar várias versões dos fluxos de agentes, manuais de procedimentos e ferramentas, e implementá-las em ambientes de publicação separados.

Quando edita um fluxo, um manual ou uma ferramenta, está a editar o rascunho. Pode guardar o rascunho como uma versão em qualquer altura. Uma versão é um instantâneo imutável dos dados do fluxo, do manual de soluções ou da ferramenta e dos dados do agente associados. Para fluxos, isto inclui intenções, entidades, webhooks, páginas e grupos de rotas. Para os guias interativos, isto inclui apenas exemplos.

Quando guarda um rascunho, este é implementado no ambiente predefinido. Quando cria versões específicas, pode implementá-las em ambientes personalizados. Pode criar uma variedade de ambientes personalizados, como:

  • testes
  • programação
  • produção

Além disso, pode criar webhooks específicos do ambiente para isolar o ambiente de produção dos ambientes de desenvolvimento e teste.

Práticas recomendadas para tráfego de produção

Use sempre versões para o tráfego de produção

Um rascunho é atualizado sempre que um programador da sua equipa faz uma alteração. É possível interromper um rascunho involuntariamente, especialmente se várias pessoas tiverem acesso de escrita ao agente. Além disso, um rascunho editado recentemente pode ser inconsistente com o modelo preparado, porque a preparação pode ter um atraso ou exigir execução manual.

Deve usar sempre versões para o seu tráfego de produção. Os recursos de rascunho devem ser testados antes de serem promovidos para versões de produção. Além disso, pode reverter para uma versão anterior se forem detetados problemas.

Use sempre webhooks específicos do ambiente

Quando faz atualizações ao seu agente, tem frequentemente atualizações interdependentes ao código do webhook. Durante o desenvolvimento e os testes destas alterações, quer o seguinte:

  • Para testar as atualizações do agente em relação às atualizações do código do webhook.
  • Para evitar implementar o código do webhook na produção até ter concluído os testes.

A utilização de webhooks específicos do ambiente atinge ambos os objetivos.

Considere possíveis erros do agente ao alterar versões

Se alterar uma versão no seu ambiente de produção enquanto as sessões estão ativas, pode causar erros do agente para algumas sessões ativas. Estes erros podem ocorrer se as versões anterior e nova forem inconsistentes entre si de uma forma que interrompa o estado da sessão. Devido a isto, deve planear alterar as versões durante o tempo de inatividade ou as horas de menor procura.

Carregue uma versão para rascunho

Em qualquer altura, pode carregar uma versão para rascunho, para que seja editável e usada pelo ambiente predefinido.

O carregamento de uma versão do fluxo para rascunho pode atualizar vários recursos num agente, incluindo recursos ao nível do agente, como intenções e entidades. Quando carrega uma versão para rascunho com a consola ou a API, pode escolher se os recursos ao nível do agente vão ser substituídos.

Da mesma forma, restaurar uma versão de um manual de estratégias para rascunho substitui o manual de estratégias existente no rascunho e os respetivos exemplos. Além disso, a restauração de uma ferramenta substitui a ferramenta existente no rascunho.

Gerir versões

Para gerir as suas versões:

Consola

Para listar as versões atuais de um fluxo:

  1. Abra a consola do Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud .
  3. Selecione o seu agente.
  4. Clique no separador Recursos partilhados.
  5. Clique em Versões.
  6. Os fluxos de agentes são apresentados. Selecione uma.
  7. As versões são apresentadas para o fluxo selecionado.

Para listar as versões atuais de um manual de estratégias:

  1. Abra a consola do Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud .
  3. Selecione o seu agente.
  4. Selecione o guia interativo
  5. Clique em Histórico de versões.
  6. Clique em Ver histórico de versões.
  7. As versões são apresentadas para o manual selecionado.

Para listar as versões atuais de uma ferramenta:

  1. Abra a consola do Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud .
  3. Selecione o seu agente.
  4. Selecione a ferramenta
  5. Clique em Histórico de versões.
  6. Clique em Ver histórico de versões.
  7. As versões são apresentadas para a ferramenta selecionada.

As seguintes informações são apresentadas para cada recurso:

  • Nome a apresentar: o nome a apresentar da versão.
  • ID da versão: o ID da versão.
  • Tipo de NLU: o tipo de NLU para a versão do fluxo.
  • Data/hora de criação: a data e a hora em que a versão foi criada.
  • Estado: o estado de preparação. Uma versão do fluxo não está pronta para utilização até que o estado seja marcado como Pronto.

Para criar uma nova versão, clique no botão Criar e indique o Nome a apresentar e a Descrição da versão.

Para carregar uma versão específica do fluxo como o fluxo de rascunho:

  1. Mantenha o ponteiro sobre uma linha de versão.
  2. Clique no botão da opção .
  3. Clique na opção Carregar para rascunho.
  4. É disponibilizada uma opção para substituir os dados ao nível do agente durante o carregamento.

Para eliminar uma versão específica de um fluxo:

  1. Mantenha o ponteiro sobre uma linha de versão.
  2. Clique no botão da opção .
  3. Clique na opção Eliminar versão.

API

Veja os métodos para o tipo Version.

Selecione um protocolo e uma versão para a referência da versão:

Protocolo V3 V3beta1
REST Recurso de versão Recurso de versão
RPC Interface de versão Interface de versão
C++ VersionsClient Não disponível
C# VersionsClient Não disponível
Go VersionsClient Não disponível
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP Não disponível Não disponível
Python VersionsClient VersionsClient
Ruby Não disponível Não disponível

Compare versões do fluxo

Depois de criar versões do fluxo, pode usar a ferramenta comparar versões para ver uma comparação lado a lado entre as versões do fluxo ou a versão de rascunho. Esta funcionalidade não está disponível para manuais de estratégias. Para comparar versões:

Consola

  1. Mantenha o ponteiro sobre uma linha de versão.
  2. Clique no botão da opção .
  3. Clique na opção Comparar versões.
  4. Selecione outra versão do fluxo ou rascunho do fluxo para comparação.
  5. É apresentada uma comparação lado a lado.

API

Consulte o método compareVersions para o tipo Version.

Selecione um protocolo e uma versão para a referência da versão:

Protocolo V3 V3beta1
REST Recurso de versão Recurso de versão
RPC Interface de versão Interface de versão
C++ VersionsClient Não disponível
C# VersionsClient Não disponível
Go VersionsClient Não disponível
Java VersionsClient VersionsClient
Node.js VersionsClient VersionsClient
PHP Não disponível Não disponível
Python VersionsClient VersionsClient
Ruby Não disponível Não disponível

Faça a gestão dos ambientes

Para gerir os seus ambientes de agentes:

Consola

Para listar os ambientes atuais de um agente:

  1. Abra a consola do Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud .
  3. Selecione o seu agente.
  4. Clique no separador Recursos partilhados.
  5. Clique em Ambientes.
  6. Os ambientes de agente são apresentados numa lista.

Para criar um novo ambiente, clique no botão Criar e faculte as informações.

Para selecionar versões de fluxo, de manual de soluções e de ferramentas, e configurar um ambiente, clique num ambiente e faculte informações.

Para ver o histórico de edições de um ambiente, clique no botão de histórico junto ao lado direito de um ambiente na lista.

Para copiar um nome de recurso do ambiente que inclua o ID do ambiente, clique no botão de cópia junto ao lado direito de um ambiente na lista.

Para eliminar um ambiente, clique no botão eliminar junto ao lado direito de um ambiente na lista.

API

Veja os métodos para o tipo Environment.

Selecione um protocolo e uma versão para a referência do ambiente:

Protocolo V3 V3beta1
REST Recurso do ambiente Recurso do ambiente
RPC Interface do ambiente Interface do ambiente
C++ EnvironmentsClient Não disponível
C# EnvironmentsClient Não disponível
Go EnvironmentsClient Não disponível
Java EnvironmentsClient EnvironmentsClient
Node.js EnvironmentsClient EnvironmentsClient
PHP Não disponível Não disponível
Python EnvironmentsClient EnvironmentsClient
Ruby Não disponível Não disponível

Especifique o ambiente para chamadas de sessão

Através do simulador da consola ou da API, pode especificar um ambiente quando fizer chamadas de sessão de tempo de execução. Se não for especificado um ambiente, é usado o ambiente predefinido.

Consola

Quando usar o simulador de consola, selecione a opção Testar agente no ambiente, e, de seguida, selecione um ambiente.

API

Para especificar um ambiente para detectIntent, streamingDetectIntent, matchIntent e chamadas REST de entidades de sessão; altere o URL inserindo environments/environment-id entre os parâmetros de caminho agent e sessions.

Por exemplo, o URL seguinte usa o ID do ambiente:6db409d7-57ac-41d7-83bd-89b8768e2745

https://dialogflow.googleapis.com/v3/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent

Especifique versões do fluxo para chamadas de sessão

Usando o simulador da consola ou a API, pode especificar um conjunto de versões do fluxo quando fizer chamadas de sessão de tempo de execução. Não é necessariamente preciso fazer referência às versões do fluxo selecionadas em nenhum ambiente.

Consola

Quando usar o simulador de consola, selecione a opção Testar agente com versões de fluxo específicas, e, em seguida, selecione as versões de fluxo.

API

Para especificar versões do fluxo para detectIntent, streamingDetectIntent, matchIntent e chamadas REST de entidades de sessão; forneça as versões do fluxo escolhidas no campo query_parameters.flow_versions do pedido.

Anterior
Como usar vários projetos
Avançar
Níveis de aplicação de dados