> For the complete documentation index, see [llms.txt](https://aizy.gitbook.io/aizy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aizy.gitbook.io/aizy-docs/aizy-docs-es/analytics.md).

# Analytics

Analytics reúne las métricas que Aizy recoge en el entorno y mantiene **Knowledge** como una pestaña específica.

### Acceso y pestañas

Abre **Knowledge Admin > Analytics**. La pantalla incluye cuatro pestañas:

* **Resumen**: indicadores principales y evolución diaria.
* **Canales**: actividad comparada por canal, bot e idioma.
* **Web y widget**: uso de las superficies web.
* **Knowledge**: preguntas, respuestas, Unknown y uso de documentos para el bot seleccionado.

### Filtros generales

Los filtros generales se aplican a **Resumen**, **Canales** y **Web y widget**:

* **Desde** y **Hasta**: periodo de consulta. El valor inicial son los últimos 30 días y el rango máximo es de 366 días, ambos inclusive.
* **Bot o asistente**: todos los bots o uno concreto.
* **Canal**: todos los canales o un canal con actividad en el periodo.
* **Filtrar**: aplica la selección y conserva la pestaña abierta.
* **Restablecer**: recupera el periodo y los filtros iniciales.

La pestaña **Knowledge** usa sus propios filtros y no hereda los filtros generales de Analytics.

### Resumen

Muestra cuatro indicadores:

* **Conversaciones iniciadas**: conversaciones cuyo primer mensaje de usuario se ha registrado en el periodo.
* **Mensajes de usuario**: número de mensajes enviados por usuarios.
* **Respuestas del asistente**: número de mensajes enviados por el asistente.
* **Duración media**: tiempo medio entre el inicio y el cierre registrado de una conversación. Solo incluye conversaciones cerradas; no mide la latencia del modelo.

El gráfico **Evolución diaria** compara por día las conversaciones iniciadas y los mensajes de usuario.

### Canales

Incluye los siguientes gráficos:

* **Actividad por canal**: conversaciones iniciadas, mensajes de usuario y respuestas del asistente, agrupados por canal.
* **Actividad por bot**: las mismas tres métricas, agrupadas por bot o asistente.
* **Respuestas del asistente por idioma**: distribución de respuestas según el idioma registrado. Solo aparece cuando existen datos de idioma.

### Web y widget

Compara tres superficies independientes:

* **Widget inline**.
* **Widget flotante**.
* **Ventana de chat**.

Según la superficie, el gráfico puede mostrar:

* **Cargas** del widget inline y del widget flotante.
* **Aperturas** del widget flotante.
* **Accesos** a la Ventana de chat.
* **Conversaciones iniciadas**.
* **Mensajes de usuario**.

Una carga o una apertura no equivale por sí sola a una conversación: la conversación se cuenta cuando se registra su primer mensaje de usuario.

### Knowledge

Knowledge mide el uso para el bot seleccionado en Knowledge Admin. Sus filtros propios son:

* **Fecha inicio** y **Fecha fin**. El periodo inicial son los últimos 7 días.
* **Canal**: todos los canales o uno concreto.
* **Filtrar** y **Restablecer**.

#### Indicadores Knowledge

* **Preguntas de usuario**: mensajes de usuario recibidos en el periodo.
* **Preguntas contestadas**: preguntas que tienen al menos un mensaje posterior del asistente en la misma conversación. No equivale a resolución, satisfacción ni respuesta correcta.
* **Usos de documentos de Knowledge**: suma de las referencias válidas a documentos activos incluidas en respuestas del asistente. No es el número de documentos únicos.
* **Respuestas Unknown**: respuestas del asistente registradas con estado **Unknown**.

#### Gráficos Knowledge

* **Tendencia diaria**: preguntas de usuario y preguntas contestadas por día.
* **Preguntas por canal**: distribución de preguntas entre canales. La leyenda muestra cantidad y porcentaje.
* **Documentos más usados**: hasta diez documentos o categorías con más referencias. Cuando existen respuestas Unknown, **Unknown** puede aparecer como categoría comparativa, pero no se suma al indicador **Usos de documentos de Knowledge**.

#### Opciones de documentos

En **Mostrar etiquetas como** puedes cambiar el identificador usado en el gráfico y la leyenda:

* **ID documento**.
* **Label ID documento**.
* **Label name documento**.
* **Título documento**, seleccionado por defecto.

La leyenda muestra los usos y el porcentaje sobre el total. Pulsa una entrada para ocultar o volver a mostrar su porción en el gráfico.

Usa **Chat Detail** para revisar una conversación concreta y sus fuentes de Knowledge.
