# Testes automatizados de agente: valide antes de entregar

Rode cenários de teste com um usuário simulado contra o seu agente real, compare modelos e guarde o histórico. Veja como funciona e quais são os limites.

Autor: Zaia
Publicado em 2026-10-14 · Tags: testes, agentes, qualidade, produto

---

Agora dá para testar um agente da Zaia sem conversar com ele na mão. Você escreve cenários, um usuário simulado conversa com o seu agente real, e cada teste fica salvo com a conversa e o resultado. Serve para quem entrega agentes a clientes e precisa saber, antes de publicar e depois de cada ajuste, se o agente ainda responde como deveria.

## O que são testes automatizados de agente

Teste automatizado de agente é uma conversa em que um **usuário simulado** (um modelo de IA) segue um cenário que você definiu e conversa com o seu agente, usando a mesma configuração, tools e provider do agente real. Cada cenário vira uma conversa de teste, e as conversas ficam organizadas em **sessões** no histórico de testes. Você acessa a partir do Internal Chat, na opção **Teste automatizado**.

## O problema que ela resolve

Testar um agente à mão significa digitar as mesmas perguntas toda vez que o prompt, a base de conhecimento ou o modelo mudam. Com vários clientes, isso não escala, e o que não é testado vai para produção. Sem registro, também não há como mostrar ao cliente o que foi validado, nem comparar antes e depois de uma mudança.

## Como funciona

1. Abra o agente, entre no **Internal Chat** e escolha **Teste automatizado**.
2. Na **Biblioteca de cenários**, clique em **Novo cenário**. Crie **manualmente** ou **com IA**: descreva a situação (por exemplo, "um cliente recebeu o pedido errado e quer uma substituição") e a plataforma gera o cenário.
3. Defina o **máximo de mensagens do usuário simulado**, até cinco.
4. Crie uma **Nova sessão de teste**, escolha os cenários e o **modelo do agente avaliado** (e, se quiser comparar, mais de um).

![Ilustração da tela Nova sessão de teste, com busca de cenários, lista de cenários e o botão Iniciar teste](../../assets/blog-lancamentos/testes-automatizados-de-agente/sessao-de-teste.png)

5. Clique em **Iniciar teste**. Cada cenário roda como uma conversa independente; você pode **Pausar**, **Retomar** ou **Pausar todos**.
6. Ao terminar, veja o status de cada conversa (**Concluído**, **Limite atingido**, **Falhou** ou **Interrompido**) e use **Reexecutar teste** para uma nova tentativa, que fica agrupada na mesma sessão.

![Ilustração do histórico de testes, com o status de cada conversa (Concluído, Em execução, Limite atingido) e o botão Reexecutar teste](../../assets/blog-lancamentos/testes-automatizados-de-agente/status-das-conversas.png)


Passo a passo na documentação [Testes automatizados do agente](/docs/agents/automated-agent-tests/). Ambiente de chat manual: [Internal Chat](/docs/agents/agent-settings/internal-chat/).

## O que você consegue entregar com isso

Exemplos ilustrativos:

- **Validação antes da entrega:** monte uma sessão com os cenários que o cliente mais teme (pedido errado, pergunta fora do escopo, pedido de humano) e rode antes de publicar o agente.
- **Re-teste depois de mudar:** alterou o prompt ou trocou o modelo? Rode a mesma sessão de novo e compare as conversas, sem digitar nada.
- **Comparação de modelos:** rode o mesmo cenário em modelos diferentes do mesmo provider e veja qual responde melhor para aquele caso.
- **Histórico para o cliente:** cada sessão guarda a conversa e o resultado, e dá para mostrar o que foi testado.

## Limites

- O usuário simulado manda **no máximo cinco mensagens** por cenário. Depois da quinta, o teste espera a resposta do agente e termina como **Limite atingido**.
- Os resultados mostram como o agente se comportou naquela conversa. Não são garantia de resultado em produção nem substituem acompanhar conversas reais.
- Os modelos ficam **fixos depois que o teste começa**, e só valem os compatíveis com o provider atual do agente.
- O agente testado é o agente real: o teste consome créditos, e a tela mostra os créditos do agente e do usuário simulado separados.
- Excluir um cenário mantém os resultados anteriores; excluir uma sessão apaga o histórico das conversas dela.
- Falha em uma conversa não tenta de novo sozinha; você reexecuta quando quiser.

## Perguntas frequentes

### O teste automatizado usa o meu agente de verdade?

Sim. A conversa passa pela mesma configuração, tools e provider do agente, e o usuário simulado só faz o papel do cliente. Por isso o teste consome créditos.

### Dá para criar cenários sem escrever tudo à mão?

Sim. Em **Criar com IA** você descreve a situação e a plataforma gera o cenário. Cada solicitação gera um cenário, e você pode editar antes de salvar.

### Posso rodar vários cenários ao mesmo tempo?

Sim. Os cenários de uma sessão rodam em paralelo, como conversas independentes, e uma falha para só a conversa afetada.

### O que acontece se o agente pedir um dado que o usuário simulado não tem?

O usuário simulado usa um nome fictício estável e continua a conversa. Se não conseguir seguir, a conversa termina como bloqueada em vez de contar como sucesso.

## Próximo passo

Veja o ambiente de teste em [Internal Chat](/docs/agents/agent-settings/internal-chat/) e como levar o agente testado a clientes em [como revender agente de IA](/blog/como-revender-agente-de-ia/).

[Iniciar teste de 7 dias](https://endless.zaia.app/platform/authenticate) — sem cartão. Planos a partir de R$125 por slot/mês no anual.