Testar e editar ações personalizadas
Use o botão Testar para executar uma chamada real, ler a resposta e ajustar, ativar ou excluir a ação sem afetar a conversa.
Veja este passo no vídeo · Ações personalizadas: parâmetros, variáveis e teste
Por que testar antes
Antes de deixar o agente usar uma ação na frente de um cliente, vale a pena testá-la. O botão Testar executa uma chamada real à sua API e mostra a resposta como está, para você confirmar que a URL, os headers e o mapeamento funcionam.
Requisito
O botão Testar só fica habilitado depois de salvar a ação pelo menos uma vez. Se estiver criando uma ação nova, clique primeiro em Salvar ação.
Passos para testar
- Abra Agentes de IA, entre no agente e vá até a aba Ações personalizadas.
- Clique no lápis (Editar) sobre a ação que deseja testar.
- No final do formulário, clique em Testar.
- Aguarde o resultado: o botão mostra Testando... e então aparece um painel com a resposta.
Como ler o resultado
- Um ponto verde e Resposta OK indicam que sua API respondeu com sucesso (HTTP 2xx).
- Um ponto vermelho e Falhou indicam um erro: o painel mostra o código HTTP ou a mensagem da falha.
- O corpo JSON é exibido por completo. Compare-o com o Campo a extrair que você configurou para confirmar que aponta para o valor certo.
O botão Testar tem limite de 10 execuções por minuto por usuário. Se ultrapassar, aguarde alguns segundos antes de tentar de novo.
Editar uma ação
- Na lista, clique no lápis (Editar).
- Altere o que precisar: identidade, método, URL, headers, body, parâmetros ou o campo a extrair.
- Clique em Salvar ação. As mudanças se aplicam imediatamente às próximas conversas.
Ativar, desativar ou excluir
- Ativar/desativar: use o interruptor de cada linha. Uma ação Inativa continua salva, mas o agente não a usa — ideal para pausar sem perder a configuração.
- Excluir: clique no ícone de lixeira. Ele pede confirmação porque não pode ser desfeito.
Se não funcionar
- O botão Testar está desabilitado: você ainda não salvou a ação; clique em Salvar ação.
- Falhou com um código 401 ou 403: verifique o header
Authorizatione se o token é válido. - Falhou com timeout: sua API demorou mais que o Timeout (s) configurado; aumente-o (até 60 s) ou revise o desempenho do endpoint.
- Resposta OK mas o agente não usa o dado: ajuste o Campo a extrair ou a Descrição da ação.
Dica: teste com dados reais do contato para detectar problemas de formato (ex.: telefones ou e-mails) antes de colocar em produção.
Dica: se for fazer mudanças grandes, desative a ação enquanto a ajusta para que o agente não a use pela metade.
Artigos relacionados
Artigos relacionados
-
Crie seu primeiro agente de IA
Aprenda o que um agente de IA faz no Omnifox, como dar instrucoes, conecta-lo a um canal e testa-lo no sandbox antes de falar com clientes reais.
-
Como escrever boas instruções para seu agente de IA
Aprenda a redigir instruções claras para que seu agente de IA responda com o tom, os limites e as ações corretas.
-
Guia completo dos Agentes de IA
Os Agentes de IA a fundo, em 65 capítulos: criar, instruções, ferramentas, conhecimento, comportamento, teste, caixa de entrada, fluxos, análise e consumo, com cada opção explicada.
-
Conectar seu agente de IA ao WhatsApp, Instagram, Messenger e chat do site
Um agente sem canais não atende ninguém. Conecte-o ao seu WhatsApp, Instagram, Messenger ou ao chat do seu site na seção Conexões e ative-o para ele começar a responder.
-
Comece aqui: os Agentes de IA em 8 minutos
O essencial dos Agentes de IA em um vídeo curto: criar um agente, as instruções, ferramentas, conhecimento, canais, o teste, o horário e a passagem para uma pessoa.