# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-10-30T16:29:21.705Z

## Página

- Título: Testar um agente avançado
- URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/agentes-avancados/testar-agente
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Prepare vários cenários, simule ou execute ações reais e confira decisões, eventos e resultados no construtor.

## Seções

- Abra o teste no construtor
- Prepare o cenário
- Entenda o que é simulado
- Converse até o resultado
- Trabalhe com vários cenários
- Confira detalhes técnicos quando precisar
- Matriz mínima sugerida
- Depois do teste

## Conteúdo da página

# Testar um agente avançado

O teste completo usa a configuração atual do editor para percorrer a conversa até o resultado. Ele ajuda a conferir perguntas, dados do contexto, decisões e ações antes de colocar o agente em um canal.

## Abra o teste no construtor

Acesse :ScreenEntry{href="https://my.agilize.app/config/agent-builder" label="Configurar um agente avançado" path="Configurações > Configuração Básica > IA > Agentes Avançados > Construtor Agentes Avançados"}, abra o agente e clique em **Testar agente** no cabeçalho do editor visual.

![Ferramenta de teste com cenário, modo das ações, canal e mensagem inicial](/docs/screenshots/agentes-avancados/testar-agente.png)

A tela informa se está usando a configuração atual. Ao terminar a revisão, salve o agente e os procedimentos alterados para que a configuração utilizada no atendimento corresponda à que você validou.

## Prepare o cenário

1. Se o agente atende ambos os públicos, escolha **Cliente pelo chatbot** ou **Equipe no CRM**.
2. Em **Como executar as ações?**, escolha simulação ou execução real.
3. Selecione o **Canal de atendimento** para conferir a apresentação.
4. Se necessário, selecione uma linha da lista como contexto.
5. Preencha somente as informações já conhecidas em **Contato e outras entradas**.
6. Informe a primeira mensagem e clique em **Iniciar teste completo**.

**Registro da lista** é uma linha da lista do CRM, não o lead da conversa. Ela fornece dados como serviço, regras e procedimento. Lead, contato e empresa são vínculos de CRM tratados separadamente.

## Entenda o que é simulado

| Modo | Ações e integrações | Conversa |
| --- | --- | --- |
| **Simular ações e integrações** | Retornam os exemplos configurados nos blocos. Coletas e regras seguem o fluxo. | Usa IA real e pode consumir créditos. |
| **Executar ações e integrações reais** | Podem consultar, criar ou alterar dados de verdade. | Também usa IA real e pode consumir créditos. |

Uma simulação de agendamento não prova que a disponibilidade, a reserva ou a integração Google estão funcionando. Faça um teste real controlado para validar esses pontos.

## Converse até o resultado

Responda no campo da conversa; **Enter** envia a mensagem. Quando houver opções, selecione uma delas ou continue conforme o pedido apresentado.

Observe se o agente pergunta somente o que falta, preserva dados já informados e segue as condições configuradas. Uma mensagem dizendo “agendado” ou “criado” só representa sucesso quando a ação correspondente foi concluída.

## Trabalhe com vários cenários

Use **+ Cenário** para começar outro caso ou **Duplicar** para variar um caso existente. Em **Mais > Nome e resultado esperado**, dê um nome claro e selecione a saída esperada.

Em **Comparar cenários**, confira o último resultado de cada um. Essa comparação verifica a saída esperada; o conteúdo da resposta e os efeitos no CRM ainda precisam ser revisados.

Os cenários são mantidos nesta abertura do editor. Eles não devem ser tratados como uma biblioteca permanente de testes.

## Confira detalhes técnicos quando precisar

Os detalhes do teste ajudam a localizar capacidades executadas, decisões, eventos e resultados. Use-os para responder:

- O agente chamou a capacidade correta?
- A informação veio da conversa, de uma variável ou de um valor fixo?
- A decisão usou o valor e o tipo esperados?
- A integração retornou sucesso ou apenas um exemplo de simulação?
- Há uma confirmação interna aguardando ação?

Mantenha a conversa como referência principal da experiência. Dados técnicos servem para diagnóstico e não precisam aparecer para o cliente.

## Matriz mínima sugerida

| Cenário | O que conferir |
| --- | --- |
| Saudação e dúvida | Capacidades continuam opcionais, conforme as instruções. |
| Dados já enviados pelo bot | Perguntas válidas são dispensadas quando o mapeamento prevê isso. |
| Resposta que encerra a coleta | Próximas perguntas e criação indevida de entidade não ocorrem. |
| Pedido de humano no meio da coleta | Retorno à saída humana preserva as respostas anteriores. |
| Agenda sem horário no período | Alternativas coerentes, sem inventar disponibilidade. |
| Escrita no uso interno | Política de confirmação respeitada. |
| Integração indisponível | Erro e alternativa compreensíveis. |
| Retorno ao bot | Chave da saída e campos devolvidos correspondem ao desenho salvo. |

## Depois do teste

Salve, ative e teste também no fluxo de bot e no canal real pretendido. O construtor ajuda a validar a lógica; não substitui a confirmação das saídas conectadas, permissões e apresentação do canal.

Veja [Conectar ao fluxo do bot](/docs/configuracao/inteligencia-artificial/agentes-avancados/conectar-fluxo-bot) e [Conectar uma agenda](/docs/configuracao/inteligencia-artificial/agentes-avancados/conectar-agenda).