A funcionalidade Revisar agente com IA permite que usuários do Whizz Studio validem a configuração completa de um agente de forma assistida, utilizando inteligência artificial para identificar inconsistências, conflitos e oportunidades de melhoria em todos os campos do agente.
A configuração adequada de um agente é fundamental para o seu desempenho no atendimento, pois envolve aspectos como:
Coerência entre habilidades customizadas
Ausência de conflitos com as regras do System Prompt
Preenchimento correto de persona, contexto de negócio e restrições
Instruções complementares claras e bem estruturadas
Quando esses princípios não são aplicados, podem ocorrer problemas como respostas incoerentes, duplicidade de intenções entre habilidades e comportamento imprevisível do agente no atendimento.
Para reduzir esses riscos antes da publicação, o Whizz Studio oferece um validador global que analisa todos os campos em conjunto e retorna um diagnóstico orientado à correção, não apenas à identificação do erro, guiando o usuário para uma configuração mais adequada.
⏱ Tempo estimado: A revisão completa leva entre 2 e 3 minutos para ser concluída.
Como funciona a revisão com IA
Durante a edição de um agente no Whizz Studio, o usuário pode acionar a revisão completa do agente a qualquer momento, recebendo um diagnóstico detalhado com sugestões acionáveis.
O processo acontece em quatro etapas principais:
Acionamento do botão "Revisar agente"
Análise completa de todos os campos via IA
Exibição do diagnóstico com sugestões por campo
Aplicação individual das sugestões pelo usuário
Esse fluxo garante que o usuário mantenha controle total sobre as alterações, sem que nenhuma mudança seja aplicada automaticamente.
Como usar
1. Acessar o botão "Revisar agente"
O botão "Revisar agente" está localizado no canto superior direito da tela de configuração do agente, ao lado do Histórico de versões e do botão Testar agente.
O botão "Revisar agente" está disponível a qualquer momento durante a edição, no canto superior direito.
💡 Disponível para todos os agentes: O botão está visível para todos os tipos de agente criados no Whizz Studio — vendas, pós-venda, qualificação e customizados.
Ao clicar no botão, o sistema inicia automaticamente o processo de análise. Não é necessário salvar o agente previamente.
2. Processo de revisão
Após acionar a revisão, uma modal é exibida com indicadores de progresso animados, representando as etapas da análise em andamento:
Estado de carregamento durante a análise. Cada etapa representa uma dimensão diferente da revisão.
O tempo estimado para conclusão é de 2 a 3 minutos. Durante esse período, o usuário pode acompanhar o progresso pela barra de dots na parte inferior da modal.
3. Resultado da revisão
Após a conclusão da análise, a modal é atualizada e exibe o resultado completo da revisão, estruturado da seguinte forma:
Resumo do diagnóstico
No topo da modal, um bloco de resumo apresenta uma visão geral da configuração do agente, destacando os principais pontos de atenção identificados e o impacto esperado após os ajustes.
Resultado da revisão: resumo do diagnóstico no topo, seguido dos cards de sugestão agrupados por área.
Cards de sugestão por campo
Abaixo do resumo, as sugestões são apresentadas em cards organizados por área (ex.: Habilidades, Instruções complementares, Restrições). Cada card contém:
Grau de severidade: Alto, Médio ou Baixo
Tipo do problema: Formatação, Duplicidade, Contradição, Completude
Campo ou habilidade afetada: identificador no canto superior direito do card
Descrição do problema: explicação do que foi identificado
Sugestão de correção: bloco em verde com orientação clara de como ajustar
Comparação Antes / Depois: visualização do conteúdo original e da versão sugerida
Exemplo de cards: campo de contexto de negócio vazio (Alto / Formatação) e instruções complementares desorganizadas (Médio / Formatação).
Cada card apresenta a comparação visual entre o conteúdo original (Antes) e a versão sugerida pela IA (Depois).
4. Aplicar sugestões
Cada sugestão pode ser aplicada individualmente, de forma independente. O usuário decide quais ajustes deseja aceitar, mantendo controle total sobre a configuração do agente.
O botão "Aplicar" está disponível em cada card individualmente. Nenhuma alteração é aplicada sem ação explícita do usuário.
Ao clicar em "Aplicar", o campo correspondente é atualizado imediatamente
Sugestões não aplicadas são simplesmente ignoradas
O usuário pode continuar editando manualmente os campos após aplicar sugestões
5. Concluir a revisão
Ao final da modal, o botão "Concluir" fecha o painel de revisão e retorna o usuário à tela de edição do agente.
Todas as alterações já aplicadas são preservadas
O agente permanece testável normalmente no simulador
Novas revisões podem ser realizadas a qualquer momento
Aviso na publicação sem revisão
Caso o usuário tente publicar o agente sem ter realizado a revisão, um aviso é exibido na tela de publicação, reforçando a importância de revisar antes de colocar o agente em produção
📋 Importante: O aviso é apenas informativo e não bloqueia a publicação. O usuário pode optar por publicar sem revisar ou retornar para executar a validação.
Benefícios
Diagnóstico completo
Todos os campos do agente são analisados em conjunto, identificando conflitos que passariam despercebidos em revisões manuais.
Feedback orientado à correção
A IA não apenas identifica o problema — ela indica exatamente como o campo deveria ser preenchido.
Agilidade na configuração
Usuários sem experiência em prompt engineering recebem orientação clara e acionável, reduzindo o tempo de ajuste.
Controle total do usuário
Nenhuma alteração é aplicada automaticamente. Cada sugestão exige confirmação explícita antes de ser efetivada.
Considerações
Disponível para todos os tipos de agentes criados no Whizz Studio.
O conteúdo original de nenhum campo é perdido durante a revisão.
Todas as alterações passam por confirmação explícita do usuário.
O agente permanece testável no simulador após a revisão, independentemente das sugestões aplicadas.
Instruções complementares são analisadas apenas para agentes de qualificação e customizados.