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.

Jun 26, 2026

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

  1. Ve a Configuración → Agentes IA y abre el agente.
  2. Ve a la pestaña Sandbox.
  3. 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

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp