VoltarTake Sales

Testes e Cenários

Aprenda a testar seus agentes antes de publicar usando o modo de teste e cenários.

Por que testar

Antes de colocar um agente em produção, é fundamental validar que ele se comporta como esperado. Testar evita experiências negativas para os visitantes e garante que:

  • As respostas estão corretas e no tom adequado
  • A base de conhecimento retorna informações relevantes
  • As ferramentas (tools) executam corretamente
  • O handoff para humanos é acionado nos momentos certos
  • A coleta de leads funciona como configurado
⚠️

Nunca publique um agente sem antes testá-lo. Um agente mal configurado pode fornecer informações incorretas, frustrar visitantes e prejudicar a imagem da sua empresa.

Teste rápido (widget embutido)

  1. Acesse Agentes
  2. No card do agente, clique em Testar → Teste Rápido
  3. A página abre o widget real do agente, junto com um resumo da configuração (voz, recursos ligados, bases de conhecimento, origens permitidas) e o script de incorporação
  4. Converse como um visitante e observe respostas, ferramentas e handoff

Conversas de teste

  • Ficam marcadas com o badge Teste no Histórico e saem do filtro padrão ("apenas reais")
  • Podem ser reabertas a qualquer momento, com transcrição, dados e logs completos
  • Não contam no limite de conversas do workspace — mas os tokens consumidos contam normalmente
💡

Teste depois de cada alteração em diretrizes, base de conhecimento ou ferramentas. Mudança pequena no prompt muda comportamento de um jeito difícil de prever no papel.

Teste de cenário (no seu site real)

O Teste de Cenário abre o seu site com o widget do agente sobreposto — é o jeito de validar o agente no contexto real, com as suas páginas, antes de instalar qualquer script.

Como usar

  1. Na página Agentes, clique em Testar → Teste de Cenário
  2. Informe a URL do site (precisa começar com http:// ou https://)
  3. Uma nova aba abre com o site e o widget por cima
  4. Navegue pelo site e converse com o agente como um visitante faria
  5. Saia pelo botão Sair do Teste
ℹ️

É aqui que aparecem os problemas que o teste rápido não mostra: variáveis de página que não resolvem, eventos de tracking que não disparam, widget cobrindo um botão importante.

Cenários que valem a pena rodar

Consulta de produto — O visitante pergunta sobre um item específico; verifique se a resposta traz preço, disponibilidade e especificação corretos (e confira na aba Logs quais trechos da base foram usados).

Lead qualificado — O visitante demonstra interesse e pede proposta; verifique se os dados de contato foram capturados na aba Dados.

Pedido de humano — O visitante pede um atendente; verifique se a conversa aparece no Inbox.

Ferramenta — Force um caso que exija integração; confirme nos logs os parâmetros enviados e a resposta da API.

O que testar — Checklist

Use esta lista como referência para garantir cobertura completa nos testes:

Essenciais

  • Saudação e apresentação — O agente se apresenta corretamente ao iniciar a conversa?
  • Perguntas da base de conhecimento — As respostas estão corretas e completas?
  • Perguntas fora do escopo — O agente responde graciosamente quando não sabe? (ex: "Essa pergunta foge da minha área, mas posso te ajudar com...")
  • Coleta de leads — Nome, email e telefone são capturados corretamente?
  • Execução de ferramentas — As tools são ativadas nos momentos certos com os parâmetros corretos?
  • Handoff — A transferência para humano funciona quando solicitada?

Avançados

  • Idiomas — Se o agente é multilíngue, teste em cada idioma configurado
  • Tom e personalidade — O agente mantém o tom definido durante toda a conversa?
  • Mensagens curtas e vagas — Como o agente lida com "oi", "?", "hmm"?
  • Mensagens longas — O agente processa mensagens extensas corretamente?
  • Linguagem imprópria — O agente mantém profissionalismo diante de mensagens inadequadas?
  • Repetição — O visitante pergunta a mesma coisa várias vezes — o agente responde sem frustração?

Iterando com base em testes

Testar não é uma etapa única. É um ciclo contínuo de melhoria.

Analisando resultados

  1. Após os testes, acesse Conversas e filtre por Apenas teste
  2. Leia as transcrições completas, prestando atenção em:
    • Respostas incorretas ou incompletas
    • Momentos em que o agente deveria ter ativado uma ferramenta mas não ativou
    • Tom inadequado ou respostas genéricas demais
    • Oportunidades perdidas de coleta de lead

Ajustes comuns

Problema identificadoAção corretiva
Respostas incorretas sobre produtosAtualizar base de conhecimento com informações corretas
Agente não coleta leadsAdicionar instruções específicas de coleta no system prompt
Ferramenta ativada no momento erradoMelhorar a descrição da ferramenta para a IA
Tom muito formal/informalAjustar seção de TOM no system prompt
Agente inventa informaçõesAdicionar restrição: "Nunca invente dados. Se não souber, diga que vai verificar."
Handoff não disparaConfirmar que Habilitar transferência para humano está ligado e revisar as instruções no prompt

Workflow de QA recomendado

Siga este fluxo para garantir qualidade antes de publicar:

  1. Configure o agente — System prompt, modelo, aparência
  2. Adicione a base de conhecimento — Documentos, FAQs, URLs
  3. Configure ferramentas — Custom tools e integrações
  4. Execute testes manuais — Modo de teste com conversas variadas
  5. Revise em Conversas — Analise transcrições e a aba Logs de cada mensagem
  6. Ajuste prompt e conhecimento — Corrija os pontos fracos encontrados
  7. Execute cenários — Teste cenários específicos para validar correções
  8. Repita até satisfeito — Ciclo de melhoria contínua
  9. Publique — Instale o widget no seu site
💡

Reserve pelo menos 30 minutos para testes antes de cada publicação. Simule pelo menos 5 conversas diferentes: uma de sucesso, uma com pergunta fora do escopo, uma com coleta de lead, uma com handoff e uma com uso de ferramenta.

Monitoramento pós-publicação

Mesmo após publicar, continue monitorando:

  • Conversas — Revise conversas reais periodicamente para identificar melhorias
  • Analytics — Acompanhe taxa de automação, satisfação e custo por conversa
  • Feedback dos atendentes — Se o agente faz handoff, pergunte à equipe sobre a qualidade das transferências

O ciclo de testes nunca termina. Seu agente deve evoluir continuamente com base em dados reais de uso.

Próximos passos