← DocumentaciónConceptos

Sandbox

Prueba el bot sin tocar producción.

El sandbox te deja probar el bot con la misma persona, el mismo knowledge y las mismas herramientas que producción — pero contra un cliente ficticio y respuestas mockeadas de tools. Ningún mensaje sale a WhatsApp, ninguna llamada HTTP real ocurre.

Cuándo usarlo

  • Antes de soltar un cambio en la persona o las instrucciones.
  • Para iterar prompts sin gastar tokens en cada test.
  • Para validar que el LLM elige la tool correcta dado un mensaje.
  • Para probar casos edge (handoff, fallback) que rara vez pasan en prod.

Cómo funciona

Desde el dashboard → sesión → Sandbox:

  1. Escribes mensajes como si fueras el cliente.
  2. El bot responde usando la config actual de la sesión.
  3. Las llamadas a tools se interceptan — defines mocks con responses fijas.
  4. Cada turno muestra: prompt enviado al LLM, tokens, tool calls intentadas, respuesta final.

Mocks de tools

Para cada tool definida en la sesión, podés añadir uno o más mocks. Cada mock matchea parámetros y devuelve un body fijo:

tool: getStock
match: { sku: "BSH-GBH-2-26" }
returns: { stock: 3, warehouse: "VAL" }
status: 200
delay: 100ms

Si ningún mock matchea, el sandbox devuelve 404 simulado para que el bot recupere como en producción.

Persistencia de la conversación

Cada conversación de sandbox vive aislada — no toca conversations ni messages de producción. Puedes guardarla como caso de prueba y re-correrla después de cualquier cambio para verificar regresiones.

Diferencias con producción

AspectoProducciónSandbox
LLMReal, con tu claveReal, con tu clave (cuesta tokens igual)
Tools HTTPLlamadas realesMocks definidos por ti
EmbeddingsRealiza retrieval realMismo retrieval real (knowledge base es la misma)
WhatsAppMensajes salen a WhatsAppNada sale fuera del sandbox
Audit logAislado a la sesión de sandbox
Sandbox · Replai · WhatsApp con IA en Venezuela