Versionamento de Agentes e Agente de Relatório 2.0

Este artigo documenta o funcionamento do versionamento de agentes e as regras de geração de relatórios após a atualização.

1. Versionamento de Agentes

Toda alteração salva em um agente passa a ser registrada como uma nova versão. Isso permite auditar mudanças, testar versões, visualizar a configuração em produção e restaurar configurações anteriores sem execução automática.

Criação de versões: Ao salvar qualquer configuração alterada, uma nova versão (ex.: v1, v2) é gerada. Salvar sem alterar nenhum campo não cria uma nova versão. O selo no cabeçalho indica a versão atual.
Aba Versões: Exibe o histórico contendo o número da versão, as seções alteradas (ex.: "Instrução" ou "Etapa 2) Formato e envio"), a data da modificação, o autor e a data em que o teste foi realizado.
Detalhes da versão (ícone de olho):
- O que mudou: Exibe a comparação (antes e depois) de cada campo editado.
- Formulário: Mostra a configuração completa da versão em modo de leitura.
- Resultado: Exibe o resultado gerado pelo teste correspondente àquela versão.
Testes anexados: O resultado do teste fica armazenado na própria versão geradora (aplicável a relatórios no Agente de Relatório e prévias no Monitoramento 2.0, Alerta e Conexão). O preview do agente indica a versão do resultado exibido, destacando em laranja quando o resultado pertencer a uma versão anterior.
Publicação e status: A versão publicada recebe o marcador "Em execução" e é utilizada nos agendamentos. Ao ser despublicada, seu status muda para "Última publicada". Agentes publicados têm a configuração protegida; é obrigatório despublicar o agente para editar ou restaurar versões.
Coluna Versão em Execuções: A aba de Execuções (para execuções agendadas, manuais ou testes) exibe qual versão foi utilizada no processamento.
Restaurar sem executar: Qualquer versão pode ser restaurada. O processo cria uma nova versão a partir da selecionada, importando o resultado do teste original. Nenhuma ação de execução é disparada e nenhuma versão anterior é excluída do histórico.

2. Agente de Relatório 2.0 (Ajuste por Edição)

Quando um agente já possui um relatório testado, uma alteração na configuração não gera um novo relatório do zero no teste seguinte. O sistema utiliza o relatório previamente aprovado e processa apenas as seções afetadas pela modificação.

Processamento parcial: Se a instrução de uma seção for alterada, apenas aquela seção será reescrita. As demais mantêm a estrutura já testada e os números são recalculados com os dados atualizados.
Consumo e tempo: Um ajuste pontual na configuração custa cerca de um terço do valor de um relatório gerado integralmente. O tempo de espera também é reduzido.
Identificação do método: O resultado da versão exibirá um selo indicando a forma de geração: "gerada por edição" ou "gerada do zero".

3. Comportamento de Links em Documentos

Links no PDF: Em relatórios gerados em Word, os links inseridos permanecem clicáveis durante a pré-visualização no formato PDF.

4. Transição e Regras de Compatibilidade

Nenhuma ação de migração é necessária por parte do usuário. Agentes já existentes registrarão sua primeira versão a partir do próximo salvamento. Até que ocorra o salvamento, a aba "Versões" exibirá a mensagem "Nenhuma versão ainda".
As execuções anteriores a esta atualização aparecerão com a coluna de versão em branco no histórico.
O recurso de "ajuste por edição" no Agente de Relatório exige uma versão anterior testada. Caso não exista teste prévio, o relatório será processado do zero.

5. Como acessar e utilizar as funções

Navegue até o menu Agentes e abra o agente desejado.
Acesse a aba Versões.
Para restaurar uma versão, despublique o agente (caso o status seja "Em execução") e clique no ícone de restauração na linha correspondente à versão.

Para visualizar o fluxo completo em produção (edição, teste, publicação, restauração e o ajuste do Agente de Relatório), consulte o vídeo de demonstração.

Agente de Relatório 2.0 (V1)

Dúvidas? Contate o suporte via plataforma.