El Playground es un espacio dedicado dentro de la Consola de Semantiks donde puedes probar el comportamiento de tu Agente antes de implementar cambios en los canales de clientes en vivo. Proporciona un entorno controlado para simular conversaciones, validar nuevas capacidades y refinar respuestas sin arriesgar la experiencia del usuario en producción.Documentation Index
Fetch the complete documentation index at: https://semantiks.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Características Principales
- Entorno de Pruebas Seguro: Cualquier cambio que hagas a la identidad, conocimiento o capacidades de tu Agente puede ser probado aquí sin impactar los canales conectados (WhatsApp, chat web, etc.).
- Simulador de Conversaciones: Interactúa con tu Agente en tiempo real para evaluar cómo responde a preguntas de ejemplo o prompts guiados.
- Prompts Predefinidos: Comienza rápidamente con entradas sugeridas como:
- ¡Hola! ¿En qué me puedes ayudar?
- Cuéntame más sobre tu organización
- Reiniciar Conversaciones: Reinicia el chat en cualquier momento para probar un nuevo flujo desde el principio.
- Soporte Multilingüe: Prueba las respuestas de tu Agente en diferentes idiomas (si está habilitado).
- Banner Informativo: Al abrir una nueva sesión del Playground, un banner azul te recuerda que estás probando en el canal del Playground y recomienda reiniciar la conversación después de hacer cambios en tu agente. El banner se cierra automáticamente cuando envías tu primer mensaje, o puedes cerrarlo manualmente haciendo clic en el botón ✕.
- Adjuntos de Archivos: Envía imágenes, documentos (PDF), audio y video directamente en el Playground para probar cómo tu Agente maneja archivos multimedia. Esta funcionalidad depende de la configuración de preferencias de archivos del canal web de tu agente.
- Configuración de Usuario Externo: Simula conversaciones como un usuario final específico configurando un ID de usuario, nombre de perfil y metadatos personalizados antes de iniciar una conversación. Esto es útil para probar personalización, memorias y comportamientos específicos por usuario.
Configuración de Usuario Externo
El Playground te permite sobrescribir la identidad de usuario por defecto que se envía al backend de tu agente. Esto es especialmente útil cuando quieres:- Probar cómo se comporta tu agente con un usuario recurrente específico (proporcionando su ID de usuario).
- Verificar funciones de personalización como saludar al usuario por nombre (estableciendo un Nombre de perfil).
- Simular conversaciones con metadatos personalizados (ej.
plan: premium,idioma: fr) para probar lógica dependiente de metadatos en workflows o herramientas.
Cómo configurar el usuario externo
Abre el modal de Usuario Externo
En la barra de herramientas del Playground, haz clic en el botón Usuario externo (el ícono de usuario con engranaje). Se abrirá un diálogo modal.
Establece el ID de usuario (opcional)
Ingresa un ID de usuario personalizado. Si se deja vacío, el Playground genera un ID aleatorio en el formato
playground-<uuid>.Establece el Nombre de perfil (opcional)
Ingresa un Nombre de perfil personalizado. Si se deja vacío, se usa la etiqueta por defecto
Playground <timestamp>.Agrega Metadatos (opcional)
Haz clic en Agregar propiedad para añadir pares clave-valor. Cada par representa un atributo de metadatos enviado junto con la conversación.
- Las claves deben ser únicas y no vacías.
- Puedes eliminar cualquier par haciendo clic en el ícono de papelera junto a él.
- Si no se proporcionan metadatos, se usan los metadatos por defecto (
source: playground,session_id: <uuid>).
Cambiar la configuración de usuario externo no reinicia la conversación actual automáticamente. Para que la nueva identidad surta efecto, inicia un nuevo hilo haciendo clic en el botón Nuevo hilo.
Envío de Adjuntos de Archivos
Si el canal web de tu agente tiene uno o más tipos de archivo habilitados en sus preferencias de archivos, el compositor del Playground mostrará un botón + a la izquierda del campo de texto.Cómo adjuntar archivos
- Haz clic en el botón + en el área del compositor.
- Aparecerá un menú con los tipos de archivos disponibles: Imágenes, Media (PDF), Audio y Video. Solo los tipos habilitados en la configuración del canal web de tu agente estarán activos.
- Selecciona un tipo de archivo y elige uno o más archivos desde tu dispositivo.
- Una barra de vista previa aparecerá sobre el compositor mostrando miniaturas para imágenes o insignias con el nombre del archivo para otros tipos.
- Para eliminar un archivo antes de enviarlo, pasa el cursor sobre su vista previa y haz clic en el botón ✕.
- Escribe tu mensaje (opcional) y presiona Enviar. Los archivos adjuntos se envían junto con tu mensaje.
Puedes adjuntar hasta 3 archivos por mensaje, con un tamaño máximo de 10 MB por archivo.
Mejores Prácticas
- Prueba después de cada cambio: Cada vez que actualices la identidad, conocimiento o capacidades de tu Agente, abre el Playground y ejecuta una prueba rápida para verificar que los cambios funcionan como se esperaba.
- Usa el botón de reiniciar: Después de hacer ajustes, reinicia la conversación para limpiar el contexto y comenzar desde cero.
- Simula escenarios reales: Intenta hacer las preguntas que tus usuarios reales harían para descubrir vacíos en el conocimiento de tu Agente.
- Prueba con diferentes identidades de usuario: Usa el modal de Usuario Externo para simular conversaciones como diferentes usuarios y verificar personalización, memorias y comportamientos basados en metadatos.