Métricas

El módulo de Métricas reúne los indicadores de uso, costo y calidad de la plataforma. Ofrece una vista general del portafolio y detalles por desarrollador, por factoría y por proyecto, además de una sección de Soporte con las métricas del Centro de Ayuda. Lo que ves depende de tu rol: la vista de portafolio es para administradores; cada persona ve, como mínimo, sus propias métricas de uso.

Encontrarás este módulo en el menú lateral, sección Análisis → Métricas.

Qué puedes hacer aquí

Un recorrido por la vista general

La vista de administrador (Métricas — Vista general de la plataforma) organiza los indicadores de arriba abajo.

Encabezado y controles

El título es Métricas. A la derecha están el filtro de período y el botón Refrescar (vuelve a cargar todos los datos). El filtro de período ofrece Hoy, Esta semana, Este mes y Personalizado; este último abre dos fechas y un botón Aplicar, con un rango máximo de 90 días.

KPIs principales

Primera fila de tarjetas:

Segunda fila:

Cada tarjeta de KPI muestra su variación vs. período anterior con flecha e icono; si no hay dato comparable, aparece N/D. El color nunca es el único indicador: siempre hay texto e icono.

Gráficas

• Tendencia temporal: evolución de las invocaciones día a día.
• Invocaciones por factoría: barras horizontales por factoría.
• Ranking de developers: tabla ordenable por Invocaciones, Tokens o Factorías.

Cuando no hay datos, cada gráfica muestra «Sin datos para el período seleccionado».

Análisis detallado

Una fila de enlaces Análisis detallado lleva a Detalle por Developer →, Detalle por Factoría → y Detalle por Proyecto →.

Sección Soporte

Al final, si tienes acceso al Centro de Ayuda, aparece la sección Soporte (Centro de Ayuda · últimos 30 días) con estos KPIs: Solicitudes abiertas, Tiempo medio de resolución, Cumplimiento SLA y CSAT. La acompañan las gráficas Volumen por tipo, Distribución por estado, Temas de orientación más frecuentes y Tasa de autoatención (deflexión KB) —el porcentaje de usuarios que resolvieron su duda en la Base de Conocimiento sin crear ticket—.

Detalle por desarrollador

Desde Detalle por Developer eliges un desarrollador en el selector (Desarrollador:). Hasta elegir uno, verás «Selecciona un desarrollador para ver sus métricas». Con uno seleccionado se muestran:

• Fila de KPIs: Invocaciones, Tokens, Fábricas usadas, Proyectos activos y Tasa de éxito.
• Tendencia semanal de invocaciones comparada con el promedio del equipo.
• Top fábricas utilizadas y Tendencia semanal — últimas 12 semanas.
• Mapa de actividad por hora y día (siempre los últimos 90 días, no cambia con el período).
• Tabla de historial de ejecuciones paginada.

Detalle por factoría

Desde Detalle por Factoría eliges una factoría en el selector. Con una seleccionada verás su encabezado (nombre, versión y tipo) con su propio filtro de período y:

• Fila de KPIs: Invocaciones, Tasa de éxito, Tasa de error, Tokens promedio y Costo total.
• Información de desarrolladores únicos que la usaron.
• Top herramientas MCP y Tipos de error (con opción de ver logs).
• Tendencia de rendimiento (con línea de referencia del 90%).
• Un aviso de Rendimiento decreciente si la tasa de éxito baja, y una comparación por versión si la factoría tiene más de una.

Detalle por proyecto

Cuando esté disponible, el detalle por proyecto muestra sus KPIs de por vida (Costo total, Invocaciones, Fases completadas, Tokens consumidos y Tiempo transcurrido), una proyección de costo, el Costo por fase, la línea de tiempo de invocaciones, la tabla de ejecuciones y la opción de exportar a CSV.

Vista para tu propio uso

Si tu rol no es de administrador, el módulo muestra Mis métricas de uso con tu actividad. Trae un filtro 7 días / 30 días / 90 días y:

• KPIs: Invocaciones totales, Tokens consumidos y MCP Tools usadas.
• Latencia de respuesta con P50 y P95.
• Estado de factorías (activa, inactiva o con error).

Esta vista solo incluye tus propias métricas; los desgloses por developer, factoría y proyecto son exclusivos de la vista de administrador.

Cómo interpretar los indicadores

• Invocaciones: a más invocaciones, más trabajo del agente. Compara la variación vs. período anterior para detectar picos.
• Costo / Tokens: suben con el uso; vigílalos junto a las invocaciones para controlar el gasto.
• Tasa de éxito / error / escalación: la salud del proceso. Una tasa de éxito bajo el 80% es Crítico; la escalación indica cuántas ejecuciones necesitaron intervención.
• Tiempo promedio de fase: cuánto tarda una fase de media; útil para detectar cuellos de botella.
• N/D significa que no hay período anterior con el que comparar, no que el valor sea cero.

Filtros de fecha

El filtro de período de la vista general se sincroniza con la dirección de la página, así que puedes compartir o guardar una vista ya filtrada. El período Personalizado admite un rango de hasta 90 días; si te pasas, verás «El período personalizado no puede superar 90 días».

Permisos

La sección Soporte solo aparece si además puedes gestionar el Centro de Ayuda. La vista general completa (con los detalles por developer y por factoría) es para administradores; el resto de usuarios ve Mis métricas de uso.

Relación con otros módulos

• Proyectos y fases: las métricas de costo, tiempo y ejecuciones provienen del trabajo realizado en los proyectos y sus fases.
• Factorías: el detalle por factoría mide el rendimiento de cada factoría.
• Centro de Ayuda: la sección Soporte resume las métricas del Centro de Ayuda.