Sandbox avanzado: contacto real, modo real, traza, regenerar y reiniciar
Saca todo el provecho del probador del agente: inyecta un contacto real, ejecuta acciones de verdad con el modo real, inspecciona la traza del LLM y regenera o reinicia la conversación.
Mira este paso en el video · El probador: traza, modo real y acciones HTTP
El Sandbox (Probador en vivo) no es solo un chat de prueba: te deja probar el agente con datos reales, ejecutar acciones de verdad y ver exactamente qué decidió el modelo. Esta guía cubre las funciones avanzadas. Si recién empiezas, lee primero Cómo probar tu agente en el sandbox.
Cómo llegar
- Ve a Configuración → Agentes IA y abre el agente.
- Ve a la pestaña Sandbox.
- Arriba verás tres sub-pestañas: Chat, Contacto y Traza.
Si tienes cambios sin guardar, guarda antes de probar: el sandbox usa la versión guardada del agente.
Contacto real (pestaña Contacto)
Por defecto el agente conversa con un contacto sintético. En la pestaña Contacto puedes darle datos reales para que personalice la respuesta:
- Cargar contacto real: busca por nombre, email o teléfono y selecciónalo. El agente resolverá variables como el nombre, la empresa o las etiquetas con esos datos.
- O ingresa datos manualmente: rellena nombre, email, teléfono, empresa, nota y etiquetas a mano.
Estos datos se inyectan como contexto en cada mensaje de prueba.
Modo real
El toggle Modo real (en la cabecera del Chat) cambia qué pasa cuando el agente usa una herramienta:
- Apagado (por defecto): las acciones se simulan. El agente "dice" que asignó o cerró, pero no toca ningún dato.
- Encendido: las herramientas nativas (asignar, cerrar, agregar etiqueta, etc.) se ejecutan de verdad contra el contacto seleccionado.
Para encender el modo real necesitas un contacto real cargado (sin contacto, el toggle queda deshabilitado). La primera vez te pedirá confirmar con un aviso: "Las acciones modifican datos del workspace". Verás un banner rojo mientras esté activo. Úsalo solo cuando quieras auditar el flujo completo end-to-end.
Traza
La pestaña Traza muestra el detalle de cada turno: la entrada y salida del LLM y las tool calls que hizo. Cuando la última respuesta usó herramientas, verás un punto ámbar en la pestaña para avisarte sin salir del Chat. Cada tool call se etiqueta según cómo se ejecutó:
- Ejecutada (modo real) — corrió de verdad,
- Simulada — no tocó datos,
- Acción HTTP ejecutada — tu acción personalizada (siempre real),
- Error — algo falló.
Usa Copiar JSON para llevarte la traza completa y depurar o compartirla.
Regenerar y reiniciar
- Regenerar: vuelve a generar la última respuesta del agente con la misma entrada (útil cuando salió floja y quieres ver otra variante sin reescribir).
- Reiniciar conversación: borra el chat de prueba y empieza de cero.
- Copiar conversación (JSON): exporta todo el diálogo de prueba.
Recuerda: el sandbox consume tokens de IA
Las pruebas del sandbox son llamadas reales al modelo y consumen tokens de IA de tu cuenta (de la bolsa mensual del plan o, si se agotó, del Saldo Omnifox). El presupuesto diario de tokens del agente ya no frena a ningún agente, así que probar no deja sin respuesta a un agente de producción.
Si no funciona
- No puedo activar el modo real: carga primero un contacto real en la pestaña Contacto. Si quitas el contacto con el modo real encendido, vuelve a simulación automáticamente.
- La traza está vacía: esa respuesta no usó herramientas. Prueba un mensaje que dispare una acción.
- Pruebo la versión vieja: guarda los cambios; el sandbox usa la versión guardada.
Tips
- Antes de soltar un agente, haz una pasada en modo real con un contacto de prueba para confirmar que asigna, etiqueta y cierra como esperas.
- Cuando una respuesta te sorprenda, abre la Traza antes de tocar el prompt: muchas veces el problema es una tool call, no el texto.
Artículos relacionados
Artículos relacionados
-
Crear tu primer agente de IA
Aprende qué hace un agente de IA en Omnifox, cómo darle instrucciones, conectarlo a un canal y probarlo en el sandbox antes de que hable con clientes reales.
-
Cómo escribir buenas instrucciones para tu agente de IA
Aprende a redactar instrucciones claras para que tu agente de IA responda con el tono, los límites y las acciones correctas.
-
Guía completa de los Agentes de IA
Los Agentes de IA a fondo, en 65 capítulos: crear, instrucciones, herramientas, conocimiento, comportamiento, probador, bandeja, flujos, analítica y consumo, con cada opción explicada.
-
Conectar tu agente de IA a WhatsApp, Instagram, Messenger y el chat web
Un agente sin canales no atiende a nadie. Conéctalo a tu WhatsApp, Instagram, Messenger o al chat de tu sitio web desde la sección Conexiones, y enciéndelo para que empiece a responder.
-
Empieza aquí: los Agentes de IA en 8 minutos
Lo esencial de los Agentes de IA en un video corto: crear un agente, sus instrucciones, herramientas, conocimiento, canales, el probador, el horario y el paso a una persona.