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.

Jun 26, 2026

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

  1. Vá em Configurações → Agentes IA e abra o agente.
  2. Vá até a aba Sandbox.
  3. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp