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.

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 (em inglês).
  2. Selecione seu agente próximo à 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.