Histórico de versões do agente
O Histórico de versões permite acompanhar todas as alterações feitas em um agente ao longo do tempo e restaurar configurações anteriores sempre que necessário.
Esse recurso é essencial para segurança, auditoria e correção rápida de erros no Whizz Studio.
Quando usar o histórico de versões
Use o histórico de versões quando você precisar:
Ver quando e o que foi alterado no agente
Restaurar uma configuração anterior (rollback)
Auditar mudanças feitas por diferentes usuários
Investigar problemas após uma alteração recente
Pré-requisitos
Antes de começar, verifique se você possui:
Acesso ao Whizz Studio
Um agente que já tenha sido salvo/publicado ao menos uma vez
⚠️ O histórico só começa a ser registrado após a primeira edição salva do agente.
Como acessar o histórico de versões
Passo 1: Abrir o agente para edição
Acesse Whizz Studio > Agentes
Localize o agente desejado
Clique em Editar no card do agente
Passo 2: Abrir o histórico de versões
Na tela de edição do agente, localize o botão Histórico de versões na barra superior
Clique no botão
Uma barra lateral será aberta com a lista de versões disponíveis
O que aparece no histórico
Cada versão registrada no histórico apresenta as seguintes informações:
Data e hora da alteração
Tipo de alteração realizada
Usuário responsável pela mudança (quando disponível)
Esses dados ajudam a entender o contexto de cada modificação antes de tomar qualquer ação.
Navegando entre versões
Ver detalhes de uma versão
Na lista do histórico, clique sobre uma versão específica
Os detalhes daquela alteração serão exibidos na tela
Use essa visualização para confirmar exatamente o que foi modificado.
Restaurar uma versão anterior (rollback)
⚠️ Atenção: ao restaurar uma versão, todas as configurações atuais do agente serão substituídas.
Para restaurar uma versão anterior:
Encontre a versão desejada no histórico
Clique em Restaurar
Confirme a ação
O agente será automaticamente revertido para aquela versão
Boas práticas ao usar o histórico
O que recomendamos ✅
Revise a versão antes de restaurar
Teste o agente após qualquer rollback
Documente alterações importantes fora da plataforma
Use descrições claras ao salvar alterações (quando disponível)
O que evitar ❌
Restaurar versões sem avaliar impacto
Fazer muitas alterações seguidas sem testar
Ignorar o histórico ao investigar comportamentos inesperados
Casos de uso mais comuns
Situação:
“Fiz uma alteração e o agente começou a responder incorretamente.”
Como resolver:
Abra o histórico de versões
Localize a versão anterior à alteração problemática
Restaure essa versão
Teste o agente novamente
Situação:
“Preciso saber quem alterou o agente recentemente.”
Como resolver:
Acesse o histórico de versões
Navegue até a data desejada
Verifique o usuário e o tipo de alteração
Situação:
“Quero entender o que mudou entre duas versões.”
Como resolver:
Acesse o histórico
Analise os detalhes de cada versão
Compare manualmente as configurações
Limitações do histórico de versões
Alguns pontos importantes a considerar:
Retenção: o tempo de armazenamento das versões é de 100 versões, depois disso, as versões iniciais serão sobrepostas pelas novas.
Restauração: ao restaurar uma versão, somente os dados do agente será restaurado, conexões com base de conhecimento e API são mantidos no agente.
Precisa de ajuda?
Se você encontrar um problema que não esteja documentado aqui, entre em contato com nosso time de suporte.