Métricas
Vigila el uso, el costo y el rendimiento de la plataforma con un tablero de cuatro pestañas, análisis narrativo con IA y detalle por desarrollador, factoría, proyecto y Board.
El módulo de Métricas reúne los indicadores de uso, costo y calidad de la plataforma. Para quien administra, es un tablero de cuatro pestañas — Plataforma, Proyectos, Mesa de Ayuda y Board — con un explorador para bajar al detalle de cada factoría, persona o proyecto, y un análisis narrativo con IA sobre cualquier indicador. Lo que ves depende de tu nivel de acceso: el tablero completo 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í
Ver los KPIs del portafolio
Invocaciones, costo, tasa de éxito, proyectos, tiempo de fase y tokens.
Explorar por factoría, persona o proyecto
Un buscador maestro-detalle sin salir de la pestaña Plataforma.
Seguir el portafolio de proyectos
Tabla y cronograma de todos los proyectos en un eje de tiempo compartido.
Revisar la Mesa de Ayuda
KPIs del Centro de Ayuda: tickets, tiempos de respuesta y resolución, reaperturas y deflexión.
Pedir un análisis con IA
Genera una lectura narrativa de cualquier indicador, con sus fuentes.
Las cuatro pestañas
El tablero de administrador organiza todo en pestañas (?tab= en la URL, así que cada una es enlazable):
| Pestaña | Qué muestra |
|---|---|
| Plataforma | El tablero general: KPIs del portafolio, gráficas y el explorador por factoría, persona o proyecto. Es la pestaña por defecto. |
| Proyectos | Portafolio de proyectos (tabla + KPIs) y su cronograma en un eje de tiempo compartido. |
| Mesa de Ayuda | Los KPIs del Centro de Ayuda: tickets, tiempos de respuesta y resolución, reaperturas, CSAT y SLA. Solo si además gestionas el Centro de Ayuda. |
| Board | El mismo tablero de métricas de flujo del módulo Board, incrustado aquí. Solo si además ves el módulo Board. |
A diferencia del resto de la plataforma, las pestañas Mesa de Ayuda y Board sí se muestran aunque no tengas el permiso que abre su contenido: en vez de desaparecer, la pestaña se abre y explica que te falta el permiso. Cambiar de pestaña conserva los demás parámetros de la URL (período, filtros, selección), así que puedes compartir una vista ya filtrada.
Pestaña Plataforma
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:
| KPI | Qué mide |
|---|---|
| Invocaciones totales | Número de ejecuciones del agente en el período. |
| Costo acumulado | Costo en USD del período. |
| Tasa de éxito | Donut con el reparto entre Éxito, Error y Escalación. |
Segunda fila:
| KPI | Qué mide |
|---|---|
| Proyectos completados | Proyectos cerrados en el período. |
| Tiempo promedio de fase | Duración media de una fase (en horas o días). |
| Tokens consumidos | Volumen de tokens procesados. |
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».
El explorador: factorías, personas y proyectos
Debajo de las gráficas, el explorador reemplaza lo que antes eran páginas separadas: es un panel maestro-detalle que vive dentro de la propia pestaña Plataforma, con las tres pestañas internas Factorías (por defecto), Personas y Proyectos (?view= en la URL). El KPI y las gráficas de arriba se quedan visibles mientras exploras.
Elige una dimensión, busca «Buscar {dimensión} por nombre…» en la lista de la izquierda y selecciona un elemento: el detalle carga a la derecha sin salir de la página. Los enlaces profundos siguen funcionando (por ejemplo ?view=factory&factoryId=…).
Detalle por factoría — con una factoría seleccionada verás su encabezado (nombre, versión y tipo) con su propio filtro de período y:
- Fila de KPIs: Ejecuciones, Tasa de éxito, Ejecuciones fallidas, Tokens, Costo estimado y Duración media.
- 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.
En el detalle por factoría, la Tasa de éxito se etiqueta con texto además de color: Éxito (≥ 90%), Advertencia (≥ 80%) o Crítico (por debajo). La Tasa de error se etiqueta Normal, Advertencia o Crítico.
Detalle por persona — con un desarrollador seleccionado verás:
- Fila de KPIs: Ejecuciones, Tokens, Costo estimado, Factorías 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 proyecto — con un proyecto seleccionado verás:
- Fila de KPIs: Costo total, Ejecuciones, Fases completadas, Tokens consumidos, Personas activas y Tiempo medio de fase.
- Una proyección de costo y el Costo por fase.
- La línea de tiempo de invocaciones, con el conmutador Acumulado / Por día.
- Un filtro por fase y la tabla de ejecuciones.
- El botón de exportar a CSV: se genera en el servidor (no en el navegador), respeta el filtro de fase activo y el nombre del archivo lo define el propio servidor.
Pestaña Proyectos
Tiene dos vistas internas (?sub=): Portafolio (por defecto) y Cronograma.
Portafolio
Fila de seis KPIs, cada uno con un botón ℹ️ más información que abre su análisis con IA:
| KPI | Qué mide |
|---|---|
| Proyectos | Total, con el desglose de activos y completados. |
| Duración mediana | Mediana y media de duración; indica sobre cuántos proyectos se calculó. |
| Fase mediana | Duración mediana de una fase, más el percentil 90. |
| Personas | Promedio y máximo de personas por proyecto. |
| Fases abiertas | Cuántas hay y su edad media. |
| Espera / ejecución | Porcentaje del tiempo que un proyecto pasa esperando en vez de ejecutándose. No cambia con Incluir eliminados. |
Bajo los KPIs, la barra de filtros trae segmentos de estado (Todos, Activos, Completados, Otros, cada uno con su contador salvo Otros), el buscador «Buscar proyecto o código SP…» (resuelto en el servidor), la casilla Incluir eliminados y el botón de exportar a CSV.
La tabla de la izquierda es ordenable y paginada (el orden viaja en la URL); al elegir una fila se abre a la derecha una tarjeta de detalle del proyecto (estado, tipo, fechas, fase mediana y más larga, avatares de los actores). Debajo, tres gráficas: antigüedad de fases, duración de fases y participación por actor.
Cronograma
Un diagrama de Gantt que ubica todos los proyectos en un mismo eje de tiempo, pensado para dejar claro que sumar la duración de las fases no equivale a la duración del proyecto: las fases en paralelo se ven en paralelo. Es de solo lectura, no permite reprogramar. Seleccionar la barra de un proyecto comparte la misma selección (?project=) con la vista Portafolio; al expandirla se piden los datos de sus fases uno por uno, no todos de golpe.
Pestaña Mesa de Ayuda
Solo la ves con contenido si además gestionas el Centro de Ayuda; si no, la pestaña se abre igual pero con un aviso de que te falta el permiso.
Fila de seis KPIs:
| KPI | Qué mide |
|---|---|
| Tickets | Total de tickets, con el conteo visto en las últimas semanas. |
| Sin resolver | Tickets abiertos, con el desglose por estado. |
| Primera respuesta | Tiempo de primera respuesta: mediana y media en horas, sobre cuántos tickets se calculó. |
| Resolución | Tiempo de resolución: mediana y media en horas, sobre cuántos tickets se calculó. |
| Reaperturas | Porcentaje de tickets alguna vez resueltos que se volvieron a abrir. Un 0% medido se muestra en verde, como un resultado real y no como falta de datos. |
| CSAT | Calificación media (sobre 5) y cuántas personas calificaron. |
Los cuatro primeros KPIs con lectura narrativa (Tickets, Primera respuesta, Resolución, CSAT) también tienen el botón más información del análisis con IA; Sin resolver y Reaperturas no, por no tener nada que narrar.
Debajo, una tarjeta aparte de Cumplimiento de SLA: hoy puede mostrar sin dato con la razón (por ejemplo, que ningún ticket resuelto tiene prioridad asignada, que es de lo que dependen los umbrales de SLA) — se cura sola en cuanto los tickets empiecen a llevar prioridad.
Le siguen las gráficas Creados y resueltos por semana, Estado de los tickets (conteo y porcentaje por estado), Volumen por tipo, Temas de orientación más frecuentes y Tasa de autoatención (deflexión KB) — el porcentaje de personas que resolvieron su duda en la Base de Conocimiento sin crear ticket, calculado sobre las aperturas del launcher de ayuda.
Regla general de esta pestaña: un indicador sin denominador medible se muestra como — junto con la razón concreta (por ejemplo, «nadie abrió el launcher»), nunca como un 0% que podría confundirse con un resultado real. Un 0% que sí se pudo medir —como cero reaperturas— se muestra tal cual, como un dato válido.
Pestaña Board
Antes se llamaba «Backlog»
El módulo pasó a llamarse Board, y con él esta pestaña. Los enlaces antiguos
/metrics?tab=backlog siguen funcionando y abren esta misma pestaña, así que no hace
falta rehacer los que ya hayas compartido.
Incrusta el mismo tablero de métricas de flujo del Board — lead time, cycle time, throughput semanal, diagrama de flujo acumulado (CFD) y bloqueos —, con sus propios filtros de equipo, sub-equipo, Tipo de Board y rango de fechas (hasta 366 días). Pide elegir un equipo entre los que ves antes de pedir cualquier dato. Si el Board del equipo aún no tiene cards o eventos, muestra su propio estado vacío (Todavía no hay Cards).
Esta pestaña depende del permiso de Board, no del de Métricas: por eso puede aparecer para alguien que ve las demás pestañas pero no esta, y viceversa.
Análisis con IA de un indicador
Cada tarjeta de KPI en las pestañas Plataforma y Proyectos (y los cuatro narrables de Mesa de Ayuda) trae un botón ℹ️ más información que abre el diálogo «Análisis de {indicador}»: una lectura narrativa generada con IA sobre las cifras y sus fuentes.
- Leer un análisis ya generado por otra persona solo exige el permiso Ver métricas; el botón siempre está visible.
- Generar uno nuevo (o regenerar uno existente) exige el permiso aparte Analizar métricas, porque consume tokens. Sin él, en vez del botón de generar verás: «Generar un análisis exige un permiso aparte porque consume tokens.»
- Abrir el diálogo nunca dispara una generación por sí solo: siempre hace falta pulsar Generar análisis (o Regenerar análisis, una vez ya existe uno).
El análisis pasa por cinco estados:
| Estado | Qué significa |
|---|---|
| Listo | El informe está renderizado, con titular y cuerpo en Markdown. |
| No fiable | Se generó, pero la plataforma no pudo verificar las cifras que cita; se etiqueta así en vez de ocultarlo. |
| Generando | En curso, con la actividad de herramientas en vivo mientras el texto llega por streaming. |
| Fallido | Terminó en error; se puede reintentar. |
| Bloqueado | Solo puede generarse un análisis a la vez en toda la plataforma; si alguien más está generando uno, verás este estado. |
El diálogo también trae un historial plegable de «Análisis anteriores de este indicador» y una sección de «Ajustes del análisis» para elegir qué factoría lo genera (esta última también exige Analizar métricas). El pie del informe siempre indica la fecha de corte de los datos y qué factoría lo produjo.
Vista para tu propio uso
Si tu nivel de acceso no es de administrador, el módulo muestra Mis métricas de uso con tu actividad, en vez del tablero de cuatro pestañas. 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; el tablero de cuatro pestañas y sus exploradores son exclusivos de quien administra.
Cómo interpretar los indicadores
- Invocaciones / Ejecuciones: 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; — significa que el indicador no tiene datos suficientes para calcularse. Ninguno de los dos es un 0 real.
Filtros de fecha
El filtro de período de la pestaña Plataforma 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». La pestaña Board tiene su propio rango, de hasta 366 días.
Permisos
| Permiso (etiqueta en la interfaz) | Qué habilita en este módulo |
|---|---|
| Ver métricas | Ver la entrada Métricas en el menú, acceder al módulo y a las pestañas Plataforma y Proyectos, y leer los análisis con IA ya generados. Sin este permiso no puedes entrar. |
| Analizar métricas | Generar o regenerar el análisis con IA de un indicador (consume tokens). |
La pestaña Mesa de Ayuda además exige poder gestionar el Centro de Ayuda; la pestaña Board además exige ver el módulo Board. Ambas se muestran igual sin el permiso correspondiente, pero con el contenido reemplazado por un aviso.
Fuera de las pestañas Mesa de Ayuda y Board, lo que no tienes permitido no aparece en la interfaz: no se muestra deshabilitado, simplemente no está. Si no ves Métricas en el menú, tu nivel de acceso no concede el permiso Ver métricas.
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 pestaña Mesa de Ayuda resume las métricas del Centro de Ayuda.
- Board: la pestaña Board incrusta las métricas de flujo del Board.