Auditor de Definiciones de Métricas
Encuentra dónde un mismo nombre de métrica significa tres cosas distintas
- 8reglas estrictas
- Cosas que nunca debe hacer, aplicadas en cada ejecución
- 5reglas de traspaso
- Condiciones en las que se detiene y entrega el trabajo a una persona
- 10campos de salida
- Un resultado estructurado, no un párrafo que tengas que releer
- ≤7pasos por ejecución
- Trabajo acotado: como máximo 5 llamadas a herramientas, impuesto por el entorno de ejecución
Solo lectura por diseño. Este agente no tiene ninguna vía para enviar, gastar, publicar ni confirmar nada. Cuando ese límite es el producto, quitarlo eliminaría la razón para confiar en el resultado.
Resumen
El fallo más dañino de la inteligencia de negocio no es una tubería de datos rota: esas se notan y se arreglan. Es que «cliente activo» significa una cosa en el panel de finanzas, otra en el de producto y una tercera en el informe al consejo, todas con la misma etiqueta.
Esto pasa sin que nadie haga nada mal. Cada panel lo construyó una persona distinta para una pregunta distinta, y cada definición era razonable para esa pregunta. Nadie la escribió porque en su momento era evidente. Dos años después esa persona ya no está y la definición vive solo en el SQL.
El coste aterriza en las reuniones. Dos equipos discuten una hora sobre qué número es el bueno cuando ambos son correctos y miden cosas distintas. La versión más cara es cuando nadie se da cuenta y se toma una decisión sobre un número que no significa lo que la sala cree.
Las herramientas de gobierno venden catálogos que tienes que rellenar, que es por lo que acaban a medias. Esto hace lo contrario: lee las consultas que ya existen, extrae qué calcula realmente cada métrica e informa de dónde el mismo nombre significa cosas distintas y de dónde nombres distintos significan lo mismo.
No cambia ninguna consulta y no publica ninguna definición. Cuál es la correcta es una decisión de negocio, y pertenece a quienes son dueños de la métrica.
Beneficios
Las reuniones dejan de discutir sobre números
Y empiezan a discutir sobre la decisión.
Decisiones sobre números que significan lo que crees
Que es la versión cara de este problema.
Un registro de definiciones construido desde la realidad
En vez de uno que nadie rellena.
Qué hace
Lee las definiciones que de verdad se ejecutan
No un catálogo que alguien debía rellenar. La definición real vive en la consulta, y solo ahí.
Encuentra un nombre con varios significados
Cada definición era razonable para la pregunta para la que se construyó. Ninguna se escribió.
Y varios nombres con un significado
Trabajo duplicado que se mantiene por separado y se va separando en silencio.
Nombra las diferencias que importan
Un filtro, una base de fechas, una regla de inclusión. Dice exactamente qué cláusula hace que dos números no coincidan.
Predice qué informes van a chocar
Para que la reunión llegue preparada en vez de descarrilar.
No publica ninguna definición
Cuál es la correcta es una decisión de negocio de quienes son dueños de la métrica.
Qué cambia
Qué cambia en tu semana
- Se encarga de
- Establecer qué calcula realmente cada métrica, en todos los paneles.
- Hoy lo hace
- Un catálogo de datos que alguien debía rellenar.
- Con qué frecuencia
- Nunca, que es por lo que la reunión discute.
- Esfuerzo manual habitual
- La definición real vive en la consulta, y solo ahí.
Por qué Datos e inteligencia de negocio en concreto. «Cliente activo» significa tres cosas distintas en tres paneles, todas con la misma etiqueta. Cada una era razonable para su propia pregunta y nadie la escribió, así que la definición se fue cuando se fue su autor.
Funciona sin supervisión
Lo inicias tú o lo inicia un evento, y termina solo. Nada espera a que alguien esté en su mesa.
El mismo criterio siempre
El elemento doscientos se mide con el listón del primero. La constancia es la parte que las personas no pueden sostener.
No puede actuar por su cuenta
Auditor de Definiciones de Métricas no tiene ninguna vía para enviar, gastar ni comprometer nada. Ese límite es justo lo que hace seguro actuar sobre su resultado.
Cómo funciona
Este agente se ejecuta en el servidor a través del entorno de ejecución de PROMIVO. Cada ejecución se registra paso a paso y cada llamada a una herramienta se comprueba contra los permisos antes de ejecutarse.
- 1EntradaValidada contra el esquema de entrada del agente
- 2Modeloclaude-opus-5 con reserva automática
- 3Herramientasextract_structured_data
- 4PermisosEjecuta acciones READ automáticamente; cualquier cosa por encima espera aprobación
- 5SalidaResultado estructurado conforme al esquema de salida
- 6RegistroTokens, duración y cada paso quedan registrados
Demostración
Datos de demostraciónIllustrative sample output, abridged.
Entrada
{
"metrics": []
}Salida
{
"noOwner": [
"Four metrics feeding the board pack have no recorded owner, so nobody can reconcile them."
],
"escalate": true,
"disclaimer": "A reading of the definitions supplied. No query, model or dashboard has been changed, nothing was written to any system, no definition is stated to be correct or canonical, and equivalences marked apparent were not verified against data.",
"escalationReason": "A metric in the board pack is computed three different ways, its revenue metric contains an unexplained hard-coded exclusion, and four board metrics have no owner.",
"dateBasisConflicts": [
"Revenue is recognised by invoice date in three reports and by service period in two. Same table, same filters, different date basis — invisible in a meeting and it moves the number every quarter end."
],
"hardCodedOrAdjusted": [
"The revenue metric excludes two named account identifiers in the WHERE clause. No comment explains why, and no reader of the dashboard can see it."
],
"reportsThatWillDisagree": [
"The board pack and the finance dashboard will report different active customer counts for the same month. Both are correct for their own definition."
],
"sameNameDifferentMeaning": [
{
"name": "Active customers",
"usedIn": [
"Finance dashboard",
"Product dashboard",
"Monthly board pack"
],
"variants": 3,
"differences": [
"Finance dashboard: any account with an invoice in the period, regardless of usage.",
"Product dashboard: any account with a login in the last 30 days, regardless of billing.",
"Board pack: any account with a live contract on the last day of the period."
],
"likelyDivergence": "The three would differ most in a month with high churn and slow invoicing — exactly the month the number gets scrutinised."
}
],
"differentNamesSameMeaning": [
"\"Monthly recurring revenue\" and \"Contracted monthly value\" compute identically. Two queries, two owners, maintained separately and already drifting."
],
"appearsEquivalentUnverified": [
"Two churn definitions appear to compute the same thing. They were not run against data, so this is reported as apparent rather than confirmed."
]
}Requisitos
Integraciones
No requiere integraciones.
Antes de empezar
- El SQL o las definiciones de modelo detrás de vuestras métricas
- A qué panel o informe alimenta cada una
- Los nombres de las métricas tal como se muestran a quien lee
- Requiere el plan Acceso total o superior
Casos de uso
Antes de un informe al consejo
Si los números concuerdan con los paneles operativos.
Construir una capa semántica
Cuáles son ahora las definiciones, antes de decidir cuáles deberían ser.
Tras un cambio en el equipo de datos
Las definiciones que se fueron con quien las escribió.
Un número en disputa
Exactamente qué cláusula hace que los dos no coincidan.
Precios
Acceso total
Se factura mensualmente con tu suscripción a PROMIVO. Cancela cuando quieras.
Las ejecuciones consumen la asignación de tu plan para ejecuciones de agentes y tokens. Consulta los límites del plan
Preguntas frecuentes
¿Decide qué definición es la correcta?
No. Las dos suelen ser correctas para su propia pregunta. Elegir la canónica es una decisión de negocio, y que una herramienta la tome en silencio es como gana la equivocada.
¿Cambia nuestras consultas o paneles?
No. Los lee. No tiene permiso de escritura en ningún almacén, modelo ni panel.
¿Necesitamos antes un catálogo de datos?
No: la ausencia de uno es el motivo por el que esto existe. Trabaja con las propias definiciones de las consultas, que es el único sitio donde se guarda la verdad.
Reseñas
Las reseñas se abren cuando los clientes hayan ejecutado este agente.
¿Necesitas que este agente funcione de otra forma?
Cuéntanos qué cambiar y nuestro equipo definirá el alcance de una versión a medida para tu negocio.
Personalizar este agente