> ## Documentation Index > Fetch the complete documentation index at: https://docs.inagent.inconcertcx.com/llms.txt > Use this file to discover all available pages before exploring further. # Playground > El Playground es el entorno de pruebas y depuración de Inagent. Permite probar agentes virtuales en tiempo real, observar el comportamiento interno de cada respuesta y simular diferentes contextos de interacción antes de publicar en producción. ## Propósito * Validar que el **guion**, las **reglas**, las **herramientas**, los **guardrails** y los **modificadores** funcionen como se espera. * Visualizar el **flujo interno de ejecución** (inicio/fin de interacción, uso de herramientas, consultas de conocimiento, guardrails, transferencias, etc.). * Simular **variables de contexto** que normalmente provendrían de integraciones externas (CRM, WhatsApp, etc.). * Guardar **escenarios de prueba** para reproducir casos complejos. *** ## Opciones de depuración (Debug) El Playground permite habilitar trazas de **debug** que insertan **marcas grises en el diálogo** para mostrar eventos clave en tiempo real.\ Cada marca incluye el momento del evento y, cuando corresponde, el resultado obtenido. ### Eventos que se pueden habilitar * **Inicio y finalización de interacción**: muestra cuándo comienza y termina la conversación. * **Uso de herramientas (Tools)**: indica cuándo se ejecuta una herramienta (API REST, Código, Transferencia a humano) y el resultado devuelto. * **Uso de modificadores**: señala si se aplicaron transformaciones de texto, traducciones o estilos de habla. * **Transferencias entre agentes**: registra la decisión y el momento en que una conversación es transferida a un **Contacto**. * **Consulta de bases de conocimiento**: muestra cuándo y cómo se recupera información de una base de conocimiento. * **Aplicación de guardrails**: indica cuándo se aplican filtros de moderación o de estilo. Puedes activar o desactivar cada categoría de debug de forma independiente para ajustar el nivel de detalle a tus necesidades de prueba. *** ## Variables de contexto El Playground permite **definir variables de contexto** para simular datos que normalmente provienen de integraciones externas (por ejemplo, WhatsApp o un CRM). * Se cargan como un **objeto JSON**. * Ejemplo: ```json theme={null} { "telefono": "+59899123456", "id_cliente": "12345", "plan": "premium" } ``` Estas variables están disponibles para el agente durante toda la interacción y se comportan igual que en un entorno real. Las variables de contexto permiten recrear escenarios complejos, como llamadas que traen datos previos del CRM o mensajes con metadatos del canal. *** ## Escenarios guardados Los **datos de prueba** (incluyendo variables de contexto y configuraciones de debug) pueden **guardarse** para reutilizarlos en futuras pruebas. * Cada usuario puede mantener **N escenarios guardados** según sus necesidades. * Los escenarios guardados **pertenecen a la sesión del usuario**: nadie más puede ver ni modificar los escenarios personales. ### Esto facilita * Probar **flujos de negocio recurrentes**. * Ejecutar **regresiones** después de cambios en el guion o las herramientas. * Mantener un **historial de pruebas críticas**. *** ## Conversaciones de pruebas para testing El chat del Playground permite **manipular y reutilizar conversaciones de prueba** de forma más flexible. Estas mejoras están pensadas para agilizar el proceso de iteración, depuración y validación de los agentes sin necesidad de reiniciar el flujo cada vez. ### ✏️ Editar mensajes enviados Permite **corregir un mensaje ya enviado** y el asistente retomará la conversación automáticamente con el nuevo contexto, sin necesidad de reiniciar la sesión. ### 🔁 Retomar desde cualquier punto Puedes **volver a un mensaje anterior** y continuar la conversación desde allí, evitando repetir pasos intermedios o volver a configurar el contexto. ### 📤 Exportar conversaciones Guarda tus conversaciones de prueba y **reutilízalas como plantillas** en otros equipos, proyectos o versiones del agente. ### 📥 Importar conversaciones **Restaura flujos de prueba** previamente exportados para replicar escenarios, validar regresiones o comparar versiones. 💡 Coloca el cursor sobre cualquier mensaje para editarlo o retomarlo.\ Usa el menú contextual (arriba a la derecha del Playground) para exportar o importar tus conversaciones. *** ## Flujo de prueba recomendado 1. **Seleccionar el agente** que se desea probar.\ Asegúrate de elegir la versión o entorno correcto antes de iniciar la sesión. 2. **Activar las opciones de debug** necesarias: inicio/fin de interacción, uso de herramientas, modificadores, transferencias, consultas de conocimiento y guardrails.\ Esto te permitirá visualizar el flujo interno de ejecución durante la conversación. 3. **Definir variables de contexto** en formato JSON para simular entradas reales (por ejemplo, datos provenientes de WhatsApp, CRM u otros sistemas externos). 4. **Interactuar con el agente** enviando mensajes como lo haría un usuario final.\ Observa en tiempo real cómo el asistente aplica reglas, herramientas y guardrails. 5. **Editar o retomar mensajes** para iterar más rápido: * Corrige mensajes ya enviados para ver cómo cambia la respuesta del agente sin reiniciar la conversación. * Retoma desde cualquier punto de la conversación para probar rutas alternativas o validar ajustes en el guion. 6. **Revisar las marcas grises** de debug que indican: * Inicio y final de la interacción. * Uso de herramientas, guardrails o modificadores. * Transferencias entre agentes o contactos. * Consultas a bases de conocimiento. 7. **Guardar, exportar o importar escenarios de prueba** según necesidad: * Guarda tus configuraciones y variables para repetir pruebas críticas. * Exporta conversaciones para compartir con otros equipos. * Importa escenarios anteriores para validar regresiones o comparar versiones del agente. 💡 Combina la edición y retomado de mensajes con el uso de escenarios guardados para acelerar la depuración y reducir el tiempo de iteración en pruebas complejas. *** ## Buenas prácticas * **Activa solo las trazas necesarias**: demasiados eventos pueden dificultar la lectura. * **Agrupa escenarios guardados por objetivo** (p. ej., “onboarding cliente”, “fallo de pago”). * **Valida latencia**: observa si guardrails o modificadores añaden tiempo de respuesta. * **Repite pruebas críticas** después de cada cambio de guion o herramienta para evitar regresiones. *** ## Próximos pasos * Consulta [**Comportamiento del agente**](./agents/behavior) para saber cómo se evalúan guion, reglas, herramientas, guardrails y modificadores. * Revisa [**Herramientas**](../tools/overview) para entender qué se ejecuta cuando se llama a una API REST, se corre código o se transfiere a un humano. * Usa [**Reportes avanzados**](../reporting/advanced-reports) para medir la eficacia de las pruebas en escenarios reales.