Versões e ambientes

Pode criar várias versões do seu agente e publicá-las em ambientes separados.

Quando edita um agente, está a editar o agente de rascunho. Em qualquer altura, pode guardar o agente de rascunho como uma versão do agente, que é uma imagem instantânea imutável do seu agente.

Quando guarda o agente de rascunho, este é publicado no ambiente predefinido. Quando cria versões de agentes, pode publicá-las em ambientes personalizados. Pode criar uma variedade de ambientes personalizados para:

  • testes
  • programação
  • produção
  • etc.

Tráfego de produção

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

Um agente de rascunho é atualizado sempre que um programador da sua equipa faz uma alteração. É fácil danificar um agente de rascunho involuntariamente, especialmente se várias pessoas tiverem acesso de escrita ao agente. Além disso, um agente de 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 de agentes para o seu tráfego de produção. Os agentes de rascunho devem ser testados antes de serem promovidos a versões de produção. Além disso, pode reverter para uma versão anterior se forem detetados problemas.

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

Se alterar uma versão do agente no seu ambiente de produção enquanto as sessões estiverem 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.

Publique uma versão num novo ambiente

Para publicar um rascunho de agente numa versão e criar um ambiente personalizado:

Consola

  1. Aceda à consola do Dialogflow ES.
  2. Selecione o seu agente perto da parte superior do menu da barra lateral esquerda.
  3. Clique no botão de definições junto ao nome do agente.
  4. Clique no separador Ambientes.
  5. Clique em Publicar uma versão.
  6. Adicione uma descrição opcional e clique em Seguinte.

  7. Selecione +Novo ambiente.

  8. Introduza um nome do ambiente.

  9. Escolha o método de processamento para o ambiente.

  10. Selecione as definições de conversão de texto em voz para o ambiente.

  11. Clique em Publicar.

  12. As informações do ambiente são agora apresentadas na secção Ambientes personalizados.

API

  1. Chame o método create para o tipo de versão para criar uma nova versão do agente.
  2. Chame o método create para o tipo de ambiente para criar um novo ambiente. Indique a versão do agente que acabou de criar no campo agentVersion.

Reverta um ambiente para uma versão anterior

Pode reverter um ambiente para uma versão anterior do agente:

Consola

  1. Clique num ambiente na secção Ambientes personalizados.
  2. É apresentada a caixa de diálogo de definições do ambiente.
  3. Clique no botão da versão publicada anteriormente na secção Histórico de publicação.
  4. Clique em Reverter para esta versão.
  5. O histórico de publicação é atualizado.

API

Chame o método patch/update para o Tipo de ambiente para atualizar um ambiente. Indique a versão do agente que criou anteriormente no campo agentVersion.

Carregue uma versão anterior para rascunho

O carregamento de uma versão anterior para rascunho substitui o agente de rascunho no ambiente predefinido por uma versão do agente selecionada.

Para carregar uma versão anterior para rascunho:

Consola

  1. Aceda à consola do Dialogflow ES.
  2. Selecione o seu agente perto da parte superior do menu da barra lateral esquerda.
  3. Clique no botão de definições junto ao nome do agente.
  4. Clique no separador Ambientes.
  5. Clique em Ver todas as versões na secção Rascunho.
  6. Clique no botão da opção para uma versão que quer carregar para o rascunho.
  7. Clique em Carregar para rascunho.
  8. Clique em Sim, tenho a certeza.
  9. Atualize todos os separadores do navegador da consola abertos, para que sejam atualizados com os dados do agente mais recentes.

API

Chame o método patch/update para o tipo de ambiente com as seguintes entradas:

  • Use - como ID do ambiente para especificar o ambiente predefinido.
  • Defina allowLoadToDraftAndDiscardChanges como verdadeiro.
  • Para o campo agentVersion, forneça a versão do agente que vai substituir o agente de rascunho.

Exporte uma versão

Para exportar uma versão, primeiro tem de a carregar para o rascunho e, em seguida, exportar o agente.

Teste o seu agente num ambiente

Pode usar a API para testar o seu agente em qualquer um dos seus ambientes personalizados. Chame o método detect intent, mas altere o URL do ponto final inserindo environments/environment-name/users/-/ entre agent e sessions.

Por exemplo, o seguinte ponto final usa o ambiente "development" com um utilizador não especificado:

"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"

Definições específicas do ambiente

O processamento de pedidos e a conversão de texto em voz são configurados pelo ambiente, pelo que o agente usa as definições do ambiente para estas funcionalidades.

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

Assistente Google

Se estiver a usar os ambientes de lançamento das Ações no Google, consulte as limitações de controlo de versões da biblioteca de processamento de pedidos do Dialogflow.

Mega agente

Veja como funcionam as versões e os ambientes nos mega agentes.

Limitações

Aplicam-se as seguintes limitações:

  • Número máximo de ambientes por agente: 10
  • Número máximo de versões por agente: 1000
Anterior
Agentes pré-criados
Avançar
Agentes multilingues