> ## 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.

# Gestionar Agentes

> Aprende a ver, editar, duplicar y gestionar tus agentes de voz en el dashboard de Meetzy

## Vista General de Agentes

La sección **Agents** presenta una interfaz moderna de panel dividido que te permite gestionar eficientemente todos tus agentes de voz:

<CardGroup cols={2}>
  <Card title="Panel Izquierdo" icon="list">
    Lista completa de agentes con búsqueda avanzada, filtros por compañía y herramientas de organización
  </Card>

  <Card title="Panel Derecho" icon="eye">
    Vista detallada del agente seleccionado con métricas, historial de llamadas y acciones rápidas
  </Card>
</CardGroup>

## Buscar y Filtrar Agentes

### Búsqueda Inteligente

El campo de búsqueda en la parte superior del panel izquierdo soporta múltiples criterios:

* **Por nombre**: Escribe el nombre del agente
* **Por ID**: Busca usando el identificador único
* **Por función**: Encuentra agentes por su propósito (ventas, soporte, etc.)

<Tip>
  La búsqueda es en tiempo real y no distingue entre mayúsculas y minúsculas.
</Tip>

### Filtros Avanzados

#### Filtrar por Compañía

Si tienes acceso a múltiples organizaciones:

<Steps>
  <Step title="Acceder al filtro">
    Haz clic en el dropdown **"All companies"**
  </Step>

  <Step title="Seleccionar organización">
    Busca o selecciona la compañía deseada de la lista
  </Step>

  <Step title="Ver resultados">
    La lista se actualiza mostrando solo agentes de esa compañía
  </Step>
</Steps>

#### Filtrar por Estado

Los agentes se pueden filtrar por su estado actual:

* **Activos**: Agentes en producción
* **En entrenamiento**: Agentes siendo configurados
* **Pausados**: Agentes temporalmente desactivados
* **Demo**: Agentes de ejemplo y plantillas

<Info>
  Usa el botón **Clear Filters** para restablecer todos los filtros y ver la lista completa.
</Info>

## Vista Detallada del Agente

Al seleccionar cualquier agente, el panel derecho muestra información completa y actualizada:

### Información Principal

| Elemento              | Descripción                     | Funcionalidad                           |
| --------------------- | ------------------------------- | --------------------------------------- |
| **Nombre del Agente** | Identificador personalizado     | Editable desde configuración            |
| **ID del Agente**     | Identificador único del sistema | Clic para copiar al portapapeles        |
| **Badges de Estado**  | Indicadores visuales del estado | Training, Pause, Demo o producción      |
| **Badge Advanced**    | Editor avanzado habilitado      | Acceso a funciones profesionales        |
| **Phone Health**      | Salud de números telefónicos    | Indicador de rendimiento en tiempo real |

### Métricas de Rendimiento

El panel superior muestra estadísticas clave:

* **Llamadas totales**: Número acumulado de interacciones
* **Duración promedio**: Tiempo medio de conversación
* **Tasa de éxito**: Porcentaje de llamadas completadas exitosamente
* **Última actividad**: Timestamp de la llamada más reciente

### Historial de Llamadas Recientes

La tabla muestra las últimas 200 llamadas con información detallada:

| Columna          | Información                                 | Acciones                    |
| ---------------- | ------------------------------------------- | --------------------------- |
| **ID**           | Identificador único de la llamada           | Clic para ver detalles      |
| **Fecha y Hora** | Timestamp completo de la llamada            | Ordenable por fecha         |
| **Duración**     | Tiempo total de conversación                | Formato mm:ss               |
| **Estado**       | Resultado final (completada, fallida, etc.) | Badge con código de colores |
| **Destino**      | Número telefónico contactado                | Formato internacional       |
| **Evaluación**   | Puntuación automática (si disponible)       | Escala de calidad           |

<Note>
  Haz clic en **View All** para acceder a la página completa de llamadas con filtros avanzados, exportación de datos y análisis detallado.
</Note>

## Editar Configuración del Agente

### Agentes con Editor Avanzado

Para agentes que muestran el badge **"Advanced"**:

<Steps>
  <Step title="Acceder al editor">
    Haz clic en el botón **Advanced Editor**
  </Step>

  <Step title="Configurar secciones">
    Modifica cualquiera de estas áreas:

    * **Configuración básica**: Nombre, descripción, idioma
    * **Saludos**: Mensajes de bienvenida personalizados
    * **Prompt del sistema**: Instrucciones de comportamiento del AI
    * **Base de conocimiento**: Documentos y fuentes de información
    * **Acciones y herramientas**: Integraciones y funcionalidades
    * **Configuración de salida**: Parámetros de respuesta
  </Step>

  <Step title="Guardar cambios">
    Los cambios se aplican inmediatamente en producción
  </Step>
</Steps>

### Agentes Estándar

Para agentes sin el badge "Advanced", las opciones se limitan al panel de configuración básica con funcionalidades esenciales.

<Warning>
  Los cambios en agentes en producción afectan inmediatamente a las llamadas entrantes. Considera probar en un ambiente de desarrollo primero.
</Warning>

## Duplicar y Clonar Agentes

### Requisitos de Permisos

<Info>
  La funcionalidad de clonado está disponible solo para usuarios administradores y agentes con Editor Avanzado habilitado.
</Info>

### Proceso de Clonación

<Steps>
  <Step title="Seleccionar agente">
    Escoge el agente que deseas duplicar de la lista
  </Step>

  <Step title="Iniciar clonación">
    Haz clic en el botón **Clone Agent**
  </Step>

  <Step title="Configurar duplicado">
    * Se crea automáticamente con el nombre "\[Nombre Original] (Copy)"
    * Hereda toda la configuración del agente original
    * Requiere asignación de nuevo número telefónico
  </Step>

  <Step title="Personalizar">
    Edita el nuevo agente según tus necesidades específicas
  </Step>
</Steps>

### Casos de Uso para Duplicación

| Escenario         | Descripción                                     | Beneficio                    |
| ----------------- | ----------------------------------------------- | ---------------------------- |
| **A/B Testing**   | Crear variantes para probar diferentes enfoques | Optimización basada en datos |
| **Departamentos** | Adaptar un agente exitoso para otra área        | Escalabilidad organizacional |
| **Respaldos**     | Mantener versiones de seguridad                 | Recuperación ante fallos     |
| **Idiomas**       | Versiones multiidioma del mismo agente          | Expansión internacional      |

## Sistema de Llamadas de Prueba

Cada agente incluye herramientas integradas para realizar pruebas exhaustivas:

### Llamadas Entrantes de Prueba

<Tabs>
  <Tab title="Configuración">
    El sistema proporciona un número telefónico dedicado:

    ```
    Phone to test inbound call:
    +34 612 345 678 [📋 Copiar]
    ```
  </Tab>

  <Tab title="Proceso de prueba">
    <Steps>
      <Step title="Obtener número">
        Copia el número o usa click-to-call
      </Step>

      <Step title="Realizar llamada">
        Llama desde tu teléfono personal
      </Step>

      <Step title="Interactuar">
        El agente responde según su configuración actual
      </Step>

      <Step title="Evaluar">
        Analiza la conversación y el comportamiento
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Llamadas Salientes de Prueba

El formulario de llamadas salientes se genera dinámicamente basado en los campos configurados del agente:

#### Campos Comunes

* **Número de destino**: Teléfono que recibirá la llamada
* **Campos personalizados**: Según la configuración del agente (nombre, empresa, propósito, etc.)
* **Selector de voz**: Opcional, para probar diferentes voces
* **Versión del agente**: Solo para agentes avanzados

#### Funcionalidades Avanzadas

* **Validación en tiempo real**: Los campos se validan antes del envío
* **Formato internacional**: Soporte automático para códigos de país
* **Historial de pruebas**: Se registran todas las llamadas de test

<Warning>
  Las llamadas de prueba consumen minutos de tu plan igual que las llamadas normales. Usa esta función con moderación durante el desarrollo.
</Warning>

### Selector de Versión para Agentes Avanzados

Los agentes con Editor Avanzado pueden probar diferentes versiones:

```
Agent Version (optional):
├─ Production version (default) ← Versión en vivo
├─ v.1 - Initial version (Production)
├─ v.2 - Greeting improvements  
└─ v.3 - New conversation flow
```

Esto permite:

* **Comparar versiones**: Evalúa mejoras antes de publicar
* **Rollback seguro**: Regresa a versiones anteriores si hay problemas
* **Testing progresivo**: Prueba cambios incrementales

## Gestión de Agentes Demo

### Organización de Demos

Los agentes marcados como **Demo** aparecen en una sección colapsible separada para mantener la organización:

* **Templates profesionales**: Casos de uso comunes preconfigurados
* **Ejemplos por industria**: Agentes especializados por sector
* **Casos de referencia**: Implementaciones exitosas anonimizadas

### Uso de Agentes Demo

<Steps>
  <Step title="Explorar templates">
    Navega por la sección de demos para encontrar casos similares al tuyo
  </Step>

  <Step title="Analizar configuración">
    Revisa la configuración, prompts y flujos de conversación
  </Step>

  <Step title="Clonar y personalizar">
    Duplica el agente demo y adáptalo a tus necesidades específicas
  </Step>
</Steps>

<Tip>
  Los agentes demo se actualizan regularmente con las mejores prácticas y nuevas funcionalidades.
</Tip>

## Acciones Rápidas y Atajos

### Acciones del Panel de Agente

| Acción                     | Método                              | Descripción                                  |
| -------------------------- | ----------------------------------- | -------------------------------------------- |
| **Copiar ID**              | Clic en icono 📋                    | Copia el identificador único al portapapeles |
| **Refrescar llamadas**     | Botón "Refresh"                     | Actualiza el historial de llamadas recientes |
| **Ver todas las llamadas** | Botón "View All"                    | Abre la vista completa con filtros avanzados |
| **Cerrar panel**           | Clic en ✕ o seleccionar otro agente | Cierra la vista detallada                    |

### Atajos de Teclado

| Combinación      | Función                    |
| ---------------- | -------------------------- |
| **Cmd/Ctrl + K** | Búsqueda rápida de agentes |
| **Cmd/Ctrl + F** | Buscar en panel actual     |
| **Escape**       | Cerrar modales abiertos    |
| **Tab**          | Navegar entre elementos    |

### Acciones en Lote

Para usuarios administradores, está disponible la gestión masiva:

* **Pausar múltiples agentes**: Para mantenimiento programado
* **Cambiar compañía**: Transferir agentes entre organizaciones
* **Exportar configuración**: Backup de configuraciones múltiples

## Monitoreo y Alertas

### Indicadores de Salud

El sistema monitorea continuamente la salud de tus agentes:

* **Phone Health**: Estado de números telefónicos asignados
* **Response Time**: Tiempo de respuesta del agente
* **Error Rate**: Tasa de fallos en llamadas
* **Availability**: Disponibilidad del servicio

### Notificaciones Automáticas

Recibe alertas sobre:

* **Números marcados como spam**: Notificación inmediata
* **Fallos recurrentes**: Patrones de error detectados
* **Límites de uso**: Advertencias sobre consumo de minutos
* **Actualizaciones del sistema**: Nuevas funcionalidades disponibles

## Siguientes Pasos

<CardGroup cols={2}>
  <Card title="Números de Teléfono" icon="phone" href="/es/agents/phone-numbers">
    Aprende a asignar, gestionar y optimizar números telefónicos para tus agentes.
  </Card>

  <Card title="Phone Health" icon="heart-pulse" href="/es/agents/phone-health">
    Monitorea la salud y rendimiento de tus números telefónicos.
  </Card>

  <Card title="Editor Avanzado" icon="code" href="/es/agents/advanced-editor">
    Domina las funcionalidades avanzadas de configuración de agentes.
  </Card>

  <Card title="Base de Conocimiento" icon="book-open" href="/es/agents/knowledge-base">
    Configura y gestiona las fuentes de información de tus agentes.
  </Card>
</CardGroup>

## Resolución de Problemas

### Problemas Comunes

<Tabs>
  <Tab title="Agente no responde">
    **Posibles causas:**

    * Número telefónico pausado o desactivado
    * Configuración incorrecta del prompt
    * Problemas de conectividad del proveedor

    **Soluciones:**

    1. Verificar estado del número en Phone Health
    2. Probar con llamada de prueba
    3. Revisar logs de error en historial de llamadas
  </Tab>

  <Tab title="Calidad de conversación baja">
    **Mejoras recomendadas:**

    * Optimizar el prompt del sistema (\< 25,000 caracteres)
    * Actualizar la base de conocimiento
    * Configurar respuestas más específicas
    * Revisar configuración de voz y velocidad
  </Tab>

  <Tab title="Error en clonación">
    **Verificar permisos:**

    * Usuario administrador o Editor Avanzado
    * Números telefónicos disponibles
    * Límites de plan no excedidos
  </Tab>
</Tabs>

<Warning>
  Si persisten los problemas, contacta al soporte técnico con el ID del agente afectado para un diagnóstico detallado.
</Warning>