O Detalhes da resposta é uma ferramenta de transparência do Whizz Studio que permite entender como e por que o agente gerou cada mensagem.
Ela mostra o passo a passo do processamento da Inteligência Artificial, ajudando na auditoria, diagnóstico de erros e melhoria contínua do agente.
Quando usar o Debug
Use os detalhes da resposta sempre que precisar:
Entender por que o agente respondeu de forma inesperada
Confirmar se a Base de Conhecimento foi consultada corretamente
Verificar se as Instruções configuradas estão sendo aplicadas
Auditar o acionamento de guardrails de segurança
Conferir tempo de resposta e modelo de IA utilizado
Como acessar os detalhes da resposta
Abra o simulador clicando em Testar agente
Envie uma mensagem para o agente
Aguarde a resposta
Passe o mouse sobre o balão da resposta
Clique no ícone de brilho (✨) ou em Detalhes da resposta
💡 Dica: a opção aparece no canto superior do balão da mensagem.
Como funciona o fluxo de pensamento (Trace)
O painel de detalhes exibe todas as etapas percorridas pela IA até chegar na resposta final.
1. Mensagem do usuário
Exibe a mensagem original enviada ao agente. Essa é a entrada principal de todo o processamento.
2. Guardrails de entrada
Valida se a mensagem respeita regras de segurança e qualidade.
Se a mensagem for bloqueada aqui (por exemplo, conteúdo ofensivo), o fluxo é interrompido
Nenhuma resposta é gerada até a validação passar
3. Consulta à Base de Conhecimento
Mostra quais conteúdos foram utilizados para embasar a resposta, como:
Arquivos enviados
FAQs
Links cadastrados
⚠️ Importante:
Se essa etapa não aparecer ou estiver vazia, o agente respondeu usando apenas conhecimento geral ou instruções, sem consultar seus documentos.
4. Instruções
Exibe quais regras e diretrizes configuradas na aba Instruções foram consideradas relevantes para aquela resposta específica.
5. Habilidades
Indica se alguma habilidade ou integração foi acionada, como:
Consulta de pedido
Busca de produto
Transferência para humano
Também mostra o resultado da execução da habilidade.
6. Identidade
Mostra como a resposta foi ajustada para seguir o tom de voz e a personalidade definidos, incluindo:
Grau de formalidade
Uso de emojis
Estilo de linguagem
7. Resposta do Whizz
Exibe a resposta final exatamente como foi apresentada ao usuário.
Detalhes técnicos da execução
No final do painel de debug, você encontra métricas importantes:
Métrica | O que significa |
Tempo de resposta | Quanto tempo o Whizz levou para processar toda a requisição (em milissegundos) |
Modelo de IA (LLM) | Qual modelo de Inteligência Artificial foi utilizado naquela resposta |
Esses dados ajudam a entender desempenho e comportamento do agente.
Diagnosticando problemas comuns
O agente inventou uma informação
O que verificar:
Etapa Consulta à Base de Conhecimento
Possível causa:
O agente não encontrou informações relevantes nos seus arquivos
Como resolver:
Ajuste documentos e FAQs com termos mais claros e completos
O agente respondeu com tom inadequado
O que verificar:
Etapa Identidade
Possível causa:
Configuração incorreta de tom de voz ou personalidade
Como resolver:
Revise as definições de identidade do agente
O agente não acionou uma integração
O que verificar:
Etapa Habilidades
Possível causa:
A IA não reconheceu a intenção do usuário
Como resolver:
Reformule perguntas de teste
Verifique a configuração da habilidade ou integração
Precisa de ajuda?
Se você identificar comportamentos inesperados que não estejam documentados aqui, entre em contato com nosso time de suporte.