Esta página foi traduzida pela API Cloud Translation.
Switch to English

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 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.

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:

  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.

Reverter um ambiente para uma versão anterior

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

  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.

Carregar uma versão anterior como rascunho

Para carregar uma versão anterior do rascunho:

  1. Clique em um ambiente na seção Custom environments.
  2. Clique no botão para ver uma versão publicada anteriormente na seção Publishing History.
  3. Clique em Load to Draft.
  4. Clique em Yes, I'm sure.

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.

Google Assistente

Se você estiver usando os ambientes de lançamento do Actions on Google, não use o editor de código in-line do Dialogflow, porque ele não é compatível com o controle de versão. Nesse caso, use um webhook personalizado.

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