Testando um Agente

Testar um agente é mais do que enviar uma pergunta e ver se ele responde. O objetivo é descobrir se ele se comporta bem em situações reais antes de você abrir o agente para usuários finais.

Como abrir o teste

No editor do agente, clique no botão Testar Agente no canto superior direito. O SquadOS abre o Hub interno com o agente já selecionado e uma nova conversa pronta.

Você também pode usar o botão Conversar na lista de agentes (/admin/agents) — ele leva direto para o Hub com esse agente.

O que testar

Cubra pelo menos estes cenários:

• pergunta simples dentro do escopo;
• pergunta complexa dentro do escopo;
• pergunta fora do escopo (o agente deve recusar com elegância);
• mensagem com informação incompleta (o agente deve perguntar antes de assumir);
• pedido que exige ferramenta (a IA deve chamar a ferramenta certa);
• pedido que não deve acionar ferramenta (a IA deve responder com o conhecimento próprio);
• tom inadequado ou usuário frustrado (o agente deve manter o tom configurado).

Validando ferramentas

Quando o agente usa uma ferramenta durante o teste, confira na própria conversa:

• chamou a ferramenta certa;
• passou parâmetros corretos;
• perguntou antes quando faltavam dados;
• explicou o resultado de forma compreensível;
• tratou erro sem inventar resposta.

Cada chamada de ferramenta aparece no chat com o nome da ferramenta e os parâmetros enviados — útil para auditar o comportamento.

Ajustando

Se o teste falhar, ajuste uma coisa por vez: prompt, modelo, ferramenta, base ou configuração avançada. Depois repita o mesmo caso de teste para confirmar a melhora. Mudar várias coisas ao mesmo tempo torna difícil saber o que resolveu.

Logs e auditoria pós-teste

Para investigar conversas de teste com mais detalhe — incluindo tokens consumidos, latência por chamada e parâmetros completos de tools — abra a aba Execuções no menu lateral. Lá você vê o histórico de cada turno do agente.