Sandbox avançado: contato real, modo real, trace, regenerar e reiniciar
Aproveite ao máximo o testador do agente: injete um contato real, execute ações de verdade com o modo real, inspecione o trace do LLM e regenere ou reinicie a conversa.
Veja este passo no vídeo · O teste: trace, modo real e ações HTTP
O Sandbox (Teste ao vivo) não é só um chat de teste: ele permite testar o agente com dados reais, executar ações de verdade e ver exatamente o que o modelo decidiu. Este guia cobre os recursos avançados. Se você está começando, leia antes Como testar seu agente no sandbox.
Como chegar
- Vá em Configurações → Agentes IA e abra o agente.
- Vá até a aba Sandbox.
- No topo você verá três sub-abas: Chat, Contato e Trace.
Se houver alterações não salvas, salve antes de testar: o sandbox usa a versão salva do agente.
Contato real (aba Contato)
Por padrão o agente conversa com um contato sintético. Na aba Contato você pode dar dados reais para que ele personalize a resposta:
- Carregar contato real: busque por nome, email ou telefone e selecione. O agente vai resolver variáveis como nome, empresa ou etiquetas com esses dados.
- Ou insira dados manualmente: preencha nome, email, telefone, empresa, observação e etiquetas à mão.
Esses dados são injetados como contexto em cada mensagem de teste.
Modo real
O toggle Modo real (no cabeçalho do Chat) muda o que acontece quando o agente usa uma ferramenta:
- Desligado (padrão): as ações são simuladas. O agente "diz" que atribuiu ou fechou, mas não toca em nenhum dado.
- Ligado: as ferramentas nativas (atribuir, fechar, adicionar etiqueta, etc.) são executadas de verdade contra o contato selecionado.
Para ligar o modo real você precisa de um contato real carregado (sem contato, o toggle fica desabilitado). Na primeira vez, ele pede confirmação com um aviso: "as ações modificam dados do workspace". Você verá um banner vermelho enquanto estiver ativo. Use apenas quando quiser auditar o fluxo completo de ponta a ponta.
Trace
A aba Trace mostra o detalhe de cada turno: a entrada e a saída do LLM e as tool calls que ele fez. Quando a última resposta usou ferramentas, você verá um ponto âmbar na aba para avisar sem sair do Chat. Cada tool call é rotulada conforme como rodou:
- Executada (modo real) — rodou de verdade,
- Simulada — não tocou em dados,
- Ação HTTP executada — sua ação personalizada (sempre real),
- Erro — algo falhou.
Use Copiar JSON para levar o trace completo e depurar ou compartilhar.
Regenerar e reiniciar
- Regenerar: gera de novo a última resposta do agente a partir da mesma entrada (útil quando saiu fraca e você quer outra variante sem reescrever).
- Reiniciar conversa: limpa o chat de teste e começa do zero.
- Copiar conversa (JSON): exporta todo o diálogo de teste.
Lembre-se: o sandbox consome tokens de IA
Os testes do sandbox são chamadas reais ao modelo e consomem tokens de IA da sua conta (da cota mensal do plano ou, se ela acabou, do Saldo Omnifox). O orçamento diário de tokens do agente não trava mais nenhum agente, então testar não deixa um agente de produção sem responder.
Se não funcionar
- Não consigo ativar o modo real: carregue primeiro um contato real na aba Contato. Se remover o contato com o modo real ligado, ele volta para simulação automaticamente.
- O trace está vazio: essa resposta não usou ferramentas. Tente uma mensagem que dispare uma ação.
- Estou testando a versão antiga: salve as alterações; o sandbox usa a versão salva.
Dicas
- Antes de liberar um agente, faça uma passada em modo real com um contato de teste para confirmar que ele atribui, etiqueta e fecha como esperado.
- Quando uma resposta surpreender, abra o Trace antes de mexer no prompt: muitas vezes o problema é uma tool call, não o texto.
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.