Valide a configuração completa do seu agente com inteligência artificial
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.
💡 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:
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.
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
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.
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.