É possível criar várias versões dos fluxos de agente e playbooks (também conhecidos como agentes da Vertex AI). e implantá-los em ambientes de veiculação separados.
Quando você edita um fluxo ou playbook, você estiver editando o rascunho. É possível salvar o rascunho como uma versão a qualquer momento. Uma versão é um snapshot imutável do fluxo ou dos dados do playbook e os dados associados do agente. Para fluxos, isso inclui intents, entidades, webhooks, páginas e grupos de rotas. Para playbooks, isso inclui são apenas exemplos.
Ao salvar um rascunho, ele é implantado no ambiente padrão. Quando você cria versões específicas, você pode implantá-los em ambientes personalizados. É possível criar vários ambientes personalizados, como:
- testando
- desenvolvimento;
- produção
Além disso, crie webhooks específicos do ambiente, para isolar o ambiente de produção de ambientes de desenvolvimento e teste.
Práticas recomendadas para o tráfego de Production
Sempre usar versões para o tráfego de produção
Um rascunho é atualizado sempre que um desenvolvedor da sua equipe faz uma alteração. É possível quebrar um rascunho de forma não intencional, especialmente se várias pessoas tiverem acesso de gravação ao agente. Além disso, um rascunho editado recentemente podem ser inconsistentes com o modelo treinado, porque o treinamento pode ter um atraso ou exigir execução manual.
Sempre use versões para o tráfego de produção. Os recursos de rascunho devem ser testados antes de promovê-los para versões de produção. É possível reverter para uma versão anterior caso algum problema seja descoberto.
Sempre usar webhooks específicos do ambiente
Ao fazer atualizações no agente, frequentemente há atualizações interdependentes no código do webhook. Durante o desenvolvimento e o teste dessas mudanças, faça o seguinte:
- Para testar as atualizações do agente em relação às atualizações do código do webhook.
- Para evitar a implantação do código do webhook na produção até que os testes sejam concluídos.
Usando Webhooks específicos do ambiente atinja as duas metas.
Considerar possíveis erros do agente ao alterar versões
Se você alterar uma versão 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 ocorrer se a versão nova e a anterior são inconsistentes entre si de maneira que interrompa o estado da sessão. Por isso, planeje a alteração das versões durante fora dos horários de pico.
Carregar uma versão de fluxo para rascunho
A qualquer momento, é possível carregar uma versão de fluxo para rascunho. Assim, ela será editável e usada pelo ambiente padrão. Esse recurso ainda não está disponível para playbooks.
Carregar uma versão de fluxo para rascunho pode atualizar vários recursos em um agente, incluindo recursos no nível do agente, como intents e entidades. Ao carregar uma versão como rascunho com o console ou a API, é possível escolher se os recursos no nível do agente serão substituídos.
Gerenciar versões
Para gerenciar suas versões:
Console
Para listar as versões atuais de um fluxo:
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Clique na guia Recursos compartilhados.
- Clique em Versões.
- Os fluxos de agente são listados. Selecione uma opção.
- As versões são listadas para o fluxo selecionado.
Para listar as versões atuais de um playbook:
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecionar o playbook
- Clique em Histórico de versões.
- Clique em Ver histórico de versões.
- As versões estão listadas para o playbook selecionado.
As informações a seguir são exibidas para cada recurso:
- Nome de exibição: o nome de exibição da versão.
- ID da versão: o ID da versão.
- Tipo PLN: o tipo PLN para a versão do fluxo.
- Carimbo de data/hora da criação: a data e a hora em que a versão foi criada.
- Status: o status do treinamento. Uma versão de fluxo não está pronta para ser usada até que o status seja marcado como Pronto.
Para criar uma nova versão, clique no botão Criar e forneça o Nome de exibição e Descrição da versão.
Para carregar uma versão de fluxo específica como fluxo de rascunho:
- Mantenha o ponteiro do mouse sobre uma linha de versão.
- Clique no botão de opção more_vert.
- Clique na opção Carregar para rascunho.
- Há uma opção para substituir os dados no nível do agente durante o carregamento.
Para excluir uma versão de fluxo específica:
- Mantenha o ponteiro do mouse sobre uma linha de versão.
- Clique no botão de opção more_vert.
- Clique na opção Excluir versão.
API
Veja os métodos para o tipo Version.
Selecione um protocolo e uma versão para referência da versão:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso de versão | Recurso de versão |
| RPC (remote procedure call) | Interface da versão | Interface da versão |
| C++ | VersionsClient | Indisponível |
| C# | VersionsClient | Indisponível |
| Go | VersionsClient | Indisponível |
| Java | VersionsClient | VersionsClient |
| Node.js | VersionsClient | VersionsClient |
| PHP | Indisponível | Indisponível |
| Python | VersionsClient | VersionsClient |
| Ruby | Indisponível | Indisponível |
Comparar versões de fluxo
Depois de criar versões de fluxo, use a ferramenta de comparação de versões para ver uma comparação lado a lado entre as versões de fluxo ou a versão de rascunho. Este recurso não está disponível para playbooks. Para comparar versões:
Console
- Mantenha o ponteiro do mouse sobre uma linha de versão.
- Clique no botão de opção more_vert.
- Clique na opção Comparar versões.
- Selecione outra versão do fluxo ou fluxo de rascunho para comparação.
- Uma comparação lado a lado é exibida.
API
Veja o método compareVersions para o tipo Version.
Selecione um protocolo e uma versão para referência da versão:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso de versão | Recurso de versão |
| RPC (remote procedure call) | Interface da versão | Interface da versão |
| C++ | VersionsClient | Indisponível |
| C# | VersionsClient | Indisponível |
| Go | VersionsClient | Indisponível |
| Java | VersionsClient | VersionsClient |
| Node.js | VersionsClient | VersionsClient |
| PHP | Indisponível | Indisponível |
| Python | VersionsClient | VersionsClient |
| Ruby | Indisponível | Indisponível |
Gerenciar ambientes
Para gerenciar os ambientes de agente:
Console
Para listar os ambientes atuais de um agente:
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Clique na guia Recursos compartilhados.
- Clique em Ambientes.
- Os ambientes de agente são listados.
Para criar um novo ambiente, clique no botão Criar e forneça informações.
Para selecionar versões de fluxo e playbook e configurar um ambiente, clicar em um ambiente e fornecer informações.
Para visualizar o histórico de edição de um ambiente, clique no botão de histórico history no 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 content_copy no lado direito de um ambiente na lista.
Para excluir um ambiente, clique no botão de exclusão delete no 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 de ambiente:
| Protocolo | V3 | V3beta1 |
|---|---|---|
| REST | Recurso de ambiente | Recurso de ambiente |
| RPC (remote procedure call) | Interface do ambiente | Interface do ambiente |
| C++ | EnvironmentsClient | Indisponível |
| C# | EnvironmentsClient | Indisponível |
| Go | EnvironmentsClient | Indisponível |
| Java | EnvironmentsClient | EnvironmentsClient |
| Node.js | EnvironmentsClient | EnvironmentsClient |
| PHP | Indisponível | Indisponível |
| Python | EnvironmentsClient | EnvironmentsClient |
| Ruby | Indisponível | Indisponível |
Especificar o ambiente para chamadas de sessão
O uso do método simulador do console ou a API, especifique um ambiente ao fazer chamadas de sessão de ambiente de execução. Se um ambiente não for especificado, o ambiente padrão será usado.
Console
Ao usar o simulador do console, Selecione a opção Testar agente no ambiente. e selecione um ambiente.
API
Para especificar um ambiente para detectIntent, streamingDetectIntent,
matchIntent e chamadas REST da entidade de sessão;
altere o URL inserindo environments/environment-id
entre os parâmetros de caminho agent e sessions.
Por exemplo, o URL a seguir usa 6db409d7-57ac-41d7-83bd-89b8768e2745.
ID do ambiente:
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
Especificar versões de fluxo para chamadas de sessão
O uso do método simulador do console ou a API, especifique um conjunto de versões de fluxo ao fazer chamadas de sessão de ambiente de execução. As versões de fluxo selecionadas não precisam necessariamente ser referenciados em qualquer ambiente.
Console
Ao usar o simulador do console, Selecione a opção Agente de teste com versões específicas de fluxo. e, em seguida, selecionar versões de fluxo.
API
Para especificar versões de fluxo para detectIntent, streamingDetectIntent,
matchIntent e chamadas REST da entidade de sessão;
forneça as versões de fluxo escolhidas no query_parameters.flow_versions
da solicitação.