Versões e ambientes

É possível criar várias versões do agente e publicá-las em ambientes separados.

Ao editar um agente, você está editando o rascunho de agente. Sempre que quiser, salve o rascunho de agente como uma versão de agente, que é um snapshot do agente que não pode ser alterado.

Ao salvar o rascunho de agente, ele será publicado no ambiente padrão. Se você criar várias versões de agentes, poderá publicá-las em ambientes personalizados. É possível criar uma variedade de ambientes personalizados para:

  • testes;
  • desenvolvimento;
  • produção;
  • etc.

Tráfego de produção

Sempre use versões de agente no tráfego de produção

Sempre que um desenvolvedor da equipe faz uma alteração, o rascunho de agente é atualizado. É fácil interromper um rascunho de agente involuntariamente, principalmente se várias pessoas tiverem acesso de gravação a ele. Além disso, um rascunho de agente editado recentemente pode ser inconsistente com o modelo treinado, porque o treinamento pode ter um atraso ou exigir uma execução manual.

Use sempre as versões do agente que estiverem no tráfego de produção. É necessário testar os rascunhos de agente antes de promovê-los a versões de produção, e eles podem ser revertidos para uma versão anterior no caso de problemas.

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

Se você alterar uma versão de agente no ambiente de produção enquanto as sessões estão ativas, isso pode causar erros no agente em algumas sessões ativas. Esses erros podem acontecer se as versões anteriores e novas forem inconsistentes entre si de uma forma que atrapalhe o estado da sessão. Por isso, planeje mudar as versões durante o tempo de inatividade ou fora dos horários de pico.

Publicar uma versão em um novo ambiente

Siga estas etapas para publicar um rascunho de agente em uma versão e criar um ambiente personalizado:

Console

  1. Acesse o Console do Dialogflow ES.
  2. Selecione seu agente perto da parte superior do menu da barra lateral esquerda.
  3. Clique no botão de configurações ao lado do nome do agente.
  4. Clique na guia Environments.
  5. Clique em Publish a version.
  6. Insira uma descrição (opcional) e clique em Next.
  7. Selecione +New Environment.

  8. Digite o nome do ambiente.

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

  10. Selecione as configurações de conversão de texto em voz do ambiente.

  11. Clique em Publish.

  12. As informações do ambiente passarão a ser listadas na seção Custom environments.

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. Forneça a versão do agente que você acabou de criar no campo agentVersion.

Reverter um ambiente para uma versão anterior

Siga estas etapas para reverter um ambiente para uma versão anterior do agente:

Console

  1. Clique em um ambiente na seção Custom environments.
  2. Será aberta uma caixa de diálogo com as configurações do ambiente.
  3. Clique no botão para ver uma versão publicada anteriormente na seção Publishing History.
  4. Clique em Revert to this version.
  5. O histórico de publicação será atualizado.

API

Chame o método patch/update para o tipo de ambiente se quiser atualizar um ambiente. Forneça a versão do agente que você criou anteriormente ao campo agentVersion.

Carregar uma versão anterior como rascunho

Carregar uma versão anterior como rascunho substitui o agente no ambiente padrão por uma versão selecionada.

Para carregar uma versão anterior do rascunho:

Console

  1. Acesse o Console do Dialogflow ES.
  2. Selecione seu agente perto da parte superior do menu da barra lateral esquerda.
  3. Clique no botão de configurações ao lado do nome do agente.
  4. Clique na guia Environments.
  5. Clique em Ver todas as versões na seção Rascunho.
  6. Clique no botão de opção de uma versão que você queira carregar para rascunho.
  7. Clique em Load to Draft.
  8. Clique em Yes, I'm sure.
  9. Atualize as guias abertas do navegador do console para que sejam atualizadas com os dados mais recentes do agente.

API

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

  • Use - como o ID do ambiente para especificar o ambiente padrão.
  • allowLoadToDraftAndDiscardChanges: definido como verdadeiro
  • No campo agentVersion, forneça a versão do agente que substituirá o agente.

Exportar uma versão

Para exportar uma versão, primeiro é necessário carregá-la para rascunho e depois exportar o agente.

Testar o agente em um ambiente

A API pode ser usada para testar seu agente em qualquer um dos ambientes personalizados. Chame o método de detecção de intent, mas altere o URL do endpoint inserindo environments/environment-name/users/-/ entre agent e sessions.

Por exemplo, o endpoint a seguir usa o ambiente "development" com um usuário não especificado:

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

Configurações específicas do ambiente

O fulfillment e a conversão de texto em voz são configurados pelo ambiente. Por isso, o agente usará as configurações do ambiente para definir esses recursos.

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

Google Assistente

Se você estiver usando ambientes de lançamento do Actions on Google, consulte as limitações do controle de versões da biblioteca de fulfillment do Dialogflow.

Mega-agente

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

Limitações

Considere as seguintes limitações:

  • Número máximo de ambientes por agente: 10
  • Número máximo de versões por agente: 1.000