Auditor de Definições de Métricas
Encontra onde um nome de métrica significa três coisas diferentes
- 8regras rígidas
- Coisas que ele nunca pode fazer, impostas em toda execução
- 5regras de repasse
- Condições em que ele para e entrega o trabalho a uma pessoa
- 10campos de saída
- Um resultado estruturado, não um parágrafo para reler
- ≤7passos por execução
- Trabalho delimitado: no máximo 5 chamadas de ferramenta, impostas pelo runtime
Somente leitura, por projeto. Este agente não tem caminho para enviar, gastar, publicar ou assumir nada. Onde esse limite é o produto, tirá-lo tiraria o motivo para confiar no resultado.
Visão geral
A falha mais danosa em inteligência de negócio não é um pipeline quebrado — esses são percebidos e corrigidos. É que "cliente ativo" significa uma coisa no painel financeiro, outra no painel de produto e uma terceira no material do conselho, todas com o mesmo rótulo.
Isso acontece sem ninguém fazer nada de errado. Cada painel foi construído por uma pessoa diferente para uma pergunta diferente, e cada definição era razoável para aquela pergunta. Ninguém escreveu porque na época era óbvio. Dois anos depois a pessoa saiu e a definição vive apenas no SQL.
O custo cai nas reuniões. Dois times discutem por uma hora sobre de quem é o número certo quando os dois estão corretos e medindo coisas diferentes. A versão mais cara é quando ninguém percebe, e uma decisão é tomada sobre um número que não significa o que a sala pensa que significa.
Ferramentas de governança vendem catálogos que você precisa preencher, e é por isso que acabam meio preenchidos. Este faz o oposto: lê as consultas que já existem, extrai o que cada métrica de fato calcula, e reporta onde o mesmo nome significa coisas diferentes e onde nomes diferentes significam a mesma coisa.
Ele não altera consulta nenhuma e não publica definição nenhuma. Qual definição está correta é uma decisão de negócio, e pertence a quem é dono da métrica.
Benefícios
Reuniões param de discutir números
E começam a discutir a decisão.
Decisões sobre números que significam o que vocês pensam
Que é a versão cara deste problema.
Um registro de definições construído a partir da realidade
Em vez de um que ninguém preenche.
O que faz
Lê as definições que de fato rodam
Não um catálogo que alguém deveria ter preenchido. A definição real vive na consulta, e só ali.
Encontra um nome, vários significados
Cada definição era razoável para a pergunta para a qual foi construída. Nenhuma delas foi escrita.
E vários nomes, um significado
Trabalho duplicado mantido separadamente, se afastando em silêncio.
Nomeia as diferenças que importam
Um filtro, uma base de data, uma regra de inclusão. Ele diz exatamente qual cláusula faz dois números discordarem.
Prevê quais relatórios vão bater de frente
Para que a reunião esteja preparada em vez de descarrilada.
Não publica definição nenhuma
Qual está correta é uma decisão de negócio de quem é dono da métrica.
O que isso muda
O que isso muda na sua semana
- Ele assume
- Estabelecer o que cada métrica de fato calcula, em cada painel.
- Hoje quem faz é
- Um catálogo de dados que alguém deveria ter preenchido.
- Com que frequência
- Nunca, e é por isso que a reunião discute.
- Esforço manual típico
- A definição real vive na consulta, e só ali.
Por que Dados e business intelligence em particular. "Cliente ativo" significa três coisas diferentes em três painéis, todas com o mesmo rótulo. Cada uma era razoável para a própria pergunta e ninguém escreveu, então a definição foi embora quando o autor foi.
Roda sem supervisão
Você ou um evento dá a partida, e ele chega ao fim sozinho. Nada fica esperando alguém estar na mesa.
O mesmo padrão todas as vezes
O ducentésimo item recebe o mesmo rigor do primeiro. A constância é a parte que as pessoas não conseguem sustentar.
Ele não pode agir por conta própria
Auditor de Definições de Métricas não tem caminho para enviar, gastar ou assumir compromissos. É esse limite que torna seguro agir com base no que ele entrega.
Como roda
Este agente é executado no servidor, pelo ambiente de execução da PROMIVO. Cada execução é registada passo a passo e cada chamada de ferramenta tem as permissões verificadas antes de ser executada.
- 1EntradaValidada contra o esquema de entrada do agente
- 2Modeloclaude-opus-5 com fallback automático
- 3Ferramentasextract_structured_data
- 4PermissõesExecuta automaticamente as ações de nível READ; tudo acima disso espera aprovação
- 5SaídaResultado estruturado, conforme o esquema de saída
- 6RegistroTokens, duração e cada passo ficam registrados
Demonstração
Dados de demonstraçãoIllustrative sample output, abridged.
Entrada
{
"metrics": []
}Saída
{
"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
Integrações
Nenhuma integração necessária.
Antes de começar
- O SQL ou as definições de modelo por trás das suas métricas
- Qual painel ou relatório cada uma alimenta
- Os nomes das métricas como são exibidos a quem lê
- Requer o plano Acesso total ou superior
Casos de uso
Antes de um material de conselho
Se os números concordam com os painéis operacionais.
Construindo uma camada semântica
Quais são as definições hoje, antes de decidir quais deveriam ser.
Depois de uma mudança no time de dados
As definições que foram embora com quem as escreveu.
Um número contestado
Exatamente qual cláusula faz os dois discordarem.
Preço
Acesso total
Cobrado mensalmente pela sua assinatura PROMIVO. Cancele quando quiser.
As execuções consomem a cota do seu plano para execuções de agentes e tokens. Veja limites do plano
Perguntas frequentes
Ele decide qual definição está certa?
Não. As duas normalmente estão certas para a própria pergunta. Escolher a canônica é uma decisão de negócio, e uma ferramenta tomando isso em silêncio é como a errada ganha.
Ele altera nossas consultas ou painéis?
Não. Ele lê. Ele não tem acesso de escrita a nenhum data warehouse, modelo ou painel.
Precisamos de um catálogo de dados antes?
Não — a ausência de um é a razão de isto existir. Ele trabalha a partir das próprias definições das consultas, que é o único lugar em que a verdade está guardada.
Avaliações
As avaliações abrem depois que os clientes tiverem executado este agente.
Precisa que este agente funcione de outro jeito?
Diga o que mudar e a nossa equipe vai definir o escopo de uma versão personalizada para a sua empresa.
Personalizar este agente