> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetzy.es/llms.txt
> Use this file to discover all available pages before exploring further.

# Playground

> Prueba tu agente de IA en tiempo real sin hacer llamadas telefónicas

## ¿Qué es el Playground?

El Playground es un entorno de pruebas en el Editor Avanzado donde puedes interactuar con tu agente en tiempo real. Te permite simular conversaciones, probar diferentes escenarios y validar el comportamiento de tu agente antes de desplegar a producción.

<Info>
  Probar en el Playground ahorra tiempo y dinero al detectar problemas antes de que afecten a llamadas reales de clientes.
</Info>

## Nuevas Funcionalidades del Playground

### Reconocimiento de Voz Integrado

El Playground ahora incluye reconocimiento de voz automático que convierte tu habla en texto de manera instantánea:

<Tabs>
  <Tab title="Entrada por Voz">
    **Funcionalidades de Voz**

    * Reconocimiento automático de voz en tiempo real
    * Transcripción instantánea a texto
    * Soporte para múltiples idiomas
    * Integración perfecta con el flujo de conversación
  </Tab>

  <Tab title="Configuración de Idioma">
    **Selección de Idioma**

    * Configuración automática basada en el idioma del agente
    * Opción de cambio manual durante la conversación
    * Detección automática del idioma hablado
    * Soporte para dialectos regionales
  </Tab>
</Tabs>

### Estadísticas de Caracteres y Tokens

El editor ahora proporciona información detallada sobre el uso de texto en tiempo real:

| Métrica        | Descripción                | Umbral                          |
| -------------- | -------------------------- | ------------------------------- |
| 🟢 Óptimo      | Menos de 25,000 caracteres | Precisión máxima                |
| 🟡 Advertencia | 25,000 - 40,000 caracteres | Posible pérdida de consistencia |
| 🔴 Crítico     | Más de 40,000 caracteres   | Alto riesgo de inconsistencias  |

<Warning>
  Las instrucciones muy largas pueden hacer que el agente pierda coherencia en partes específicas. Considera simplificar o dividir el contenido.
</Warning>

### Atajos de Teclado Mejorados

El Playground incluye nuevos atajos de teclado para una experiencia más eficiente:

| Atajo              | Acción                       | Descripción                        |
| ------------------ | ---------------------------- | ---------------------------------- |
| `Ctrl/Cmd + Enter` | Enviar mensaje               | Envía el mensaje actual            |
| `Ctrl/Cmd + K`     | Limpiar conversación         | Borra el historial de chat         |
| `Ctrl/Cmd + R`     | Reiniciar agente             | Reinicia la sesión del agente      |
| `Espacio`          | Activar/Desactivar micrófono | Control rápido de grabación        |
| `Escape`           | Cancelar grabación           | Cancela la grabación de voz activa |

## Nuevas Funcionalidades de Visualización

### Vista Comparativa del Editor

El Editor Avanzado ahora incluye opciones mejoradas de visualización para facilitar la edición y depuración:

<Tabs>
  <Tab title="Vista de Diferencias">
    **Sistema de Diff Mejorado**

    * Comparación visual lado a lado de cambios
    * Resaltado de líneas modificadas, añadidas o eliminadas
    * Navegación rápida entre diferencias
    * Soporte para múltiples tipos de cambios simultáneos
  </Tab>

  <Tab title="Control de Versiones">
    **Integración con Git**

    * Indicadores de estado en tiempo real (clean, modified, conflict)
    * Versioning automático con números de versión
    * Colaboración en tiempo real con bloqueo de campos
    * Sincronización automática de cambios remotos
  </Tab>
</Tabs>

### Estados de Visualización

El editor mantiene diferentes estados visuales para una mejor experiencia de usuario:

| Estado      | Descripción                  | Indicador Visual                    |
| ----------- | ---------------------------- | ----------------------------------- |
| 🟢 Clean    | Sin cambios locales          | Badge verde "Clean"                 |
| 🟡 Modified | Cambios locales pendientes   | Badge amarillo "Modified (N)"       |
| 🔴 Conflict | Conflictos de versión        | Badge rojo "Conflicts (N)"          |
| 🔵 Syncing  | Sincronizando cambios        | Badge azul "Syncing..."             |
| 🟠 Locked   | Bloqueado por otros usuarios | Badge naranja "Locked by N user(s)" |

<Warning>
  Los cambios realizados mientras el agente está en estado "Locked" pueden perderse si otro usuario publica primero.
</Warning>

## Accediendo al Playground

El Playground está ubicado en el panel derecho del Editor Avanzado. Haz clic en la pestaña "Playground" para acceder, y observa el estado de sincronización en la barra superior para asegurar que estás probando la versión más reciente.

## Tipos de Llamada

Puedes simular dos tipos de llamadas:

| Tipo        | Descripción                  | Caso de Uso                                       |
| ----------- | ---------------------------- | ------------------------------------------------- |
| 📞 Entrante | Cliente llamando a tu agente | Probar flujo de bienvenida, escenarios de soporte |
| 📤 Saliente | Agente llamando a un cliente | Probar introducciones, scripts de ventas          |

<Tip>
  Cambia entre tipos de llamada para probar ambos saludos y asegurar que tu agente maneja cada escenario correctamente.
</Tip>

## Enviando Mensajes

### Entrada de Texto Mejorada

Escribe mensajes en el campo de entrada con nuevas funcionalidades:

* **Auto-completado inteligente** basado en conversaciones anteriores
* **Sugerencias contextuales** que aparecen mientras escribes
* **Contador de caracteres** en tiempo real
* **Vista previa del mensaje** antes de enviar

### Entrada de Voz con Reconocimiento Automático

<Steps>
  <Step title="Activar Reconocimiento">
    Haz clic en el icono del micrófono o presiona la barra espaciadora para comenzar a grabar.
  </Step>

  <Step title="Hablar Claramente">
    Habla de forma natural. El sistema detectará automáticamente tu idioma y convertirá tu voz a texto.
  </Step>

  <Step title="Revisar Transcripción">
    La transcripción aparece en tiempo real. Puedes editarla antes de enviarla.
  </Step>

  <Step title="Enviar o Continuar">
    Envía el mensaje transcrito o continúa hablando para añadir más contenido.
  </Step>
</Steps>

<Info>
  El reconocimiento de voz se optimiza automáticamente según el idioma principal de tu agente y puede detectar cambios de idioma durante la conversación.
</Info>

## Vista de Conversación Mejorada

El Playground muestra mensajes cronológicamente con indicadores de estado de versión y nuevas funcionalidades:

| Elemento                   | Descripción                                                    |
| -------------------------- | -------------------------------------------------------------- |
| 👤 Mensaje de Usuario      | Tus entradas (texto o voz transcrita) con timestamp            |
| 🤖 Mensaje del Agente      | Respuestas del agente con indicador de tiempo de procesamiento |
| 🔧 Llamada de Herramienta  | Cuando el agente dispara un webhook o acción                   |
| ✅ Resultado de Herramienta | Respuesta del webhook o acción                                 |
| 📝 Estado de Versión       | Indicador del estado actual del agente                         |
| 🎤 Indicador de Voz        | Muestra cuándo se usó reconocimiento de voz                    |

### Reproducción de Audio Mejorada

Para cada respuesta del agente, puedes:

* ▶️ **Reproducir** la respuesta de audio con controles avanzados
* ⏸️ **Pausar/Reanudar** reproducción en cualquier momento
* ⏩ **Velocidad ajustable** (0.5x, 1x, 1.5x, 2x)
* 📊 **Visualización de forma de onda** durante la reproducción
* 🔄 **Repetir mensajes** con loop automático
* 💾 **Descargar audio** para análisis offline

### Estadísticas de Conversación en Tiempo Real

El panel lateral ahora muestra estadísticas detalladas:

<Tabs>
  <Tab title="Métricas de Texto">
    **Análisis de Contenido**

    * Total de caracteres utilizados
    * Número de tokens procesados
    * Promedio de palabras por respuesta
    * Tiempo promedio de respuesta
  </Tab>

  <Tab title="Métricas de Voz">
    **Análisis de Audio**

    * Tiempo total de grabación
    * Precisión de transcripción estimada
    * Idiomas detectados en la conversación
    * Calidad de audio promedio
  </Tab>

  <Tab title="Métricas de Rendimiento">
    **Análisis de Eficiencia**

    * Latencia promedio de respuesta
    * Uso de herramientas por conversación
    * Tasa de éxito de llamadas a webhook
    * Evaluaciones automáticas pasadas/falladas
  </Tab>
</Tabs>

## Variables de Contexto Mejoradas

<Steps>
  <Step title="Panel de Variables Inteligente">
    El panel ahora incluye sugerencias automáticas basadas en tu industria y tipo de agente.
  </Step>

  <Step title="Validación en Tiempo Real">
    Las variables se validan automáticamente y muestran errores antes de iniciar la conversación.
  </Step>

  <Step title="Plantillas Precargadas">
    Selecciona entre plantillas de contexto populares para casos de uso comunes.
  </Step>

  <Step title="Sincronización de Versiones">
    Las variables se sincronizan automáticamente con cambios de versión del agente.
  </Step>
</Steps>

### Ejemplo de Contexto Avanzado

```json theme={null}
{
  "cliente": {
    "nombre": "Ana García",
    "telefono": "+34612345678",
    "email": "ana@empresa.com",
    "idioma_preferido": "español"
  },
  "pedido": {
    "numero": "PED-2024-001",
    "estado": "procesando",
    "valor": 299.99,
    "fecha_entrega": "2024-03-15"
  },
  "sesion": {
    "es_cliente_premium": true,
    "historial_contactos": 3,
    "ultima_interaccion": "2024-03-01T10:30:00Z",
    "satisfaction_score": 4.5
  }
}
```

## Test de Fiabilidad con IA Mejorado

El sistema de pruebas ahora incluye análisis impulsado por IA:

<Steps>
  <Step title="Configuración Inteligente">
    El sistema sugiere automáticamente parámetros de prueba basados en tu agente.
  </Step>

  <Step title="Generación de Escenarios">
    La IA genera automáticamente escenarios de prueba variados y realistas.
  </Step>

  <Step title="Ejecución Paralela">
    Las pruebas se ejecutan en paralelo para obtener resultados más rápido.
  </Step>

  <Step title="Análisis Predictivo">
    El sistema predice posibles problemas antes de que ocurran en producción.
  </Step>

  <Step title="Reportes Detallados">
    Obtén reportes completos con recomendaciones específicas de mejora.
  </Step>
</Steps>

### Tipos de Pruebas Automatizadas

<Tabs>
  <Tab title="Pruebas de Consistencia">
    **Verificación de Comportamiento**

    * Misma entrada → misma respuesta
    * Análisis de variabilidad de respuestas
    * Detección de contradicciones
    * Consistencia en diferentes idiomas
  </Tab>

  <Tab title="Pruebas de Estrés">
    **Límites del Sistema**

    * Respuesta a entradas muy largas
    * Manejo de múltiples herramientas simultaneas
    * Comportamiento con contexto extenso
    * Recuperación después de errores
  </Tab>

  <Tab title="Pruebas de Edge Cases">
    **Casos Límite**

    * Entradas malformadas o inválidas
    * Solicitudes fuera del dominio del agente
    * Inputs en idiomas no soportados
    * Manejo de silencio prolongado
  </Tab>
</Tabs>

<Info>
  Los tests de fiabilidad con IA pueden detectar hasta un 95% más de problemas potenciales comparado con pruebas manuales tradicionales.
</Info>

## Integración con Sistema de Control de Versiones

### Flujo de Trabajo con Synchronización Inteligente

<Steps>
  <Step title="Detección Automática de Cambios">
    El sistema detecta automáticamente cambios realizados por otros colaboradores.
  </Step>

  <Step title="Resolución de Conflictos Asistida">
    La IA sugiere resoluciones de conflictos basadas en el contexto del cambio.
  </Step>

  <Step title="Pruebas Automáticas Post-Merge">
    Las pruebas se ejecutan automáticamente después de resolver conflictos.
  </Step>

  <Step title="Rollback Inteligente">
    Posibilidad de revertir cambios específicos sin afectar otras modificaciones.
  </Step>
</Steps>

### Colaboración en Tiempo Real

El Playground ahora soporta colaboración simultánea:

<Warning>
  Cuando múltiples usuarios prueban el mismo agente, sus sesiones se aíslan para evitar interferencias, pero pueden ver actividad de otros usuarios.
</Warning>

| Indicador           | Significado             | Acción Recomendada                            |
| ------------------- | ----------------------- | --------------------------------------------- |
| 👥 Usuarios activos | Otros usuarios probando | Coordinar para evitar cambios conflictivos    |
| 🔒 Sesión bloqueada | Usuario editando código | Esperar o trabajar en modo solo lectura       |
| 🔄 Sincronizando    | Cambios en progreso     | Pausar pruebas hasta completar sincronización |

## Evaluaciones Automáticas Mejoradas

### Sistema de Evaluación en Tiempo Real

Las evaluaciones ahora se ejecutan automáticamente después de cada conversación:

<Tabs>
  <Tab title="Evaluaciones Básicas">
    **Métricas Fundamentales**

    * Tiempo de respuesta promedio
    * Tasa de finalización exitosa
    * Uso correcto de herramientas
    * Adherencia a instrucciones
  </Tab>

  <Tab title="Evaluaciones Avanzadas">
    **Análisis Profundo**

    * Calidad de la conversación (IA-powered)
    * Satisfacción estimada del usuario
    * Coherencia semántica
    * Manejo de emociones y contexto
  </Tab>

  <Tab title="Evaluaciones Personalizadas">
    **Métricas Específicas del Negocio**

    * KPIs definidos por el usuario
    * Evaluaciones basadas en objetivos específicos
    * Métricas de compliance regulatorio
    * Análisis de sentiment y tone
  </Tab>
</Tabs>

### Reportes de Evaluación Automáticos

<Info>
  Los reportes se generan automáticamente después de cada sesión de pruebas y se pueden exportar en múltiples formatos (PDF, CSV, JSON).
</Info>

## Mejores Prácticas Actualizadas

<Steps>
  <Step title="Preparación Pre-Prueba">
    * Verifica el estado de sincronización del agente
    * Configura variables de contexto realistas
    * Selecciona el idioma apropiado para reconocimiento de voz
  </Step>

  <Step title="Durante las Pruebas">
    * Utiliza tanto entrada de voz como texto para cobertura completa
    * Monitorea las estadísticas de caracteres y tokens en tiempo real
    * Aprovecha los atajos de teclado para eficiencia
  </Step>

  <Step title="Análisis Post-Prueba">
    * Revisa las evaluaciones automáticas generadas
    * Analiza las métricas de rendimiento
    * Exporta conversaciones importantes para análisis posterior
  </Step>

  <Step title="Iteración y Mejora">
    * Utiliza las sugerencias de IA para optimizar el agente
    * Implementa cambios basados en métricas de fiabilidad
    * Documenta problemas encontrados y soluciones aplicadas
  </Step>
</Steps>

## Troubleshooting Avanzado

| Problema                          | Causa Posible              | Solución                                 |
| --------------------------------- | -------------------------- | ---------------------------------------- |
| Reconocimiento de voz no funciona | Permisos de micrófono      | Verificar permisos del navegador         |
| Transcripción incorrecta          | Idioma mal configurado     | Cambiar idioma en configuración de voz   |
| Estadísticas no se actualizan     | Problema de sincronización | Refrescar el playground                  |
| Evaluaciones fallan               | Conflictos de versión      | Resolver conflictos antes de evaluar     |
| Audio no se reproduce             | Problema de codec          | Verificar soporte de audio del navegador |

## Nuevas Funcionalidades Experimentales

<Warning>
  Las siguientes funcionalidades están en fase beta y pueden cambiar en futuras actualizaciones.
</Warning>

### IA Assistant para Pruebas

* **Generación automática de casos de prueba** basada en tu industria
* **Sugerencias de optimización** en tiempo real durante las pruebas
* **Detección automática de problemas** antes de que se conviertan en errores
* **Recomendaciones de mejores prácticas** específicas para tu agente

### Análisis de Sentimientos en Tiempo Real

* **Detección emocional** durante la conversación
* **Métricas de satisfacción** estimadas en tiempo real
* **Alertas de escalación** cuando se detecta frustración del usuario
* **Análisis de tone** para asegurar consistencia de marca

## Integraciones Próximas

<CardGroup cols={2}>
  <Card title="Slack/Teams Integration" icon="comment" href="/es/advanced-editor/integrations">
    Recibe notificaciones de pruebas directamente en tu canal de equipo
  </Card>

  <Card title="Jira/Linear Integration" icon="list-check" href="/es/advanced-editor/integrations">
    Crea automáticamente tickets para problemas encontrados
  </Card>

  <Card title="Analytics Dashboard" icon="chart-line" href="/es/advanced-editor/analytics">
    Dashboard completo con métricas históricas de rendimiento
  </Card>

  <Card title="A/B Testing Suite" icon="flask" href="/es/advanced-editor/ab-testing">
    Compara diferentes versiones de tu agente automáticamente
  </Card>
</CardGroup>

## Siguientes Pasos

<CardGroup cols={2}>
  <Card title="Copilot" icon="robot" href="/es/advanced-editor/copilot">
    Obtén ayuda de IA para mejorar tus prompts con análisis de conversaciones del playground
  </Card>

  <Card title="Historial de Versiones" icon="clock-rotate-left" href="/es/advanced-editor/version-history">
    Rastrea cambios y revierte a versiones anteriores basándote en resultados de pruebas
  </Card>

  <Card title="Pruebas Automatizadas" icon="flask" href="/es/advanced-editor/tests">
    Configura pruebas que se ejecuten automáticamente con cada cambio
  </Card>

  <Card title="Colaboración en Equipo" icon="users" href="/es/advanced-editor/collaboration">
    Aprende a colaborar eficientemente usando el playground compartido
  </Card>
</CardGroup>