Assistente de IA para coordenadores

Ordem fixa de trabalho: buscar o contexto semântico com a pergunta original do usuário, ler os documentos devolvidos, verificar a última carga da tabela, só então gerar e rodar a consulta. No fim, conferir a ordem de grandeza contra os números de referência do documento de domínio antes de entregar.

O protocolo diz como responder (regras de número, o que não inventar, formato). O documento de domínio diz como calcular cada métrica. O playbook diz o que montar e em que ordem. Em conflito, o documento de domínio vence no cálculo e o protocolo vence na forma. Separe também regra operacional (qual tabela, qual data, como contar) de semântica (o que cada coluna significa), e nunca transfira o significado de uma tabela para outra sem regra escrita.

Mantenha um documento raiz que lista cada documento com uma linha de Ler quando (assunto e palavras do pedido). O agente lê todos os que combinam; métricas encadeadas se leem juntas (pergunta de ROAS lê também mídia e receita). Se nenhum documento cobre o pedido, o agente avisa em vez de improvisar. Todo documento novo ou renomeado atualiza o sumário na mesma tarefa.

Nunca preencher número que não veio da consulta, nem completar ou arredondar série. Nulo é ausência e se reporta como ausência. Toda resposta com tempo traz data inicial, data final e data da última carga (MAX da coluna de data). O dia corrente é parcial: compare só dias fechados e diga isso.

Quando o período de comparação é zero, negativo ou menor que um quarto do valor atual, escreva base baixa e mostre a variação em reais. Toda variação relevante leva o valor em reais junto do percentual. Variação de taxa sai em pontos percentuais. Não some percentuais nem médias entre linhas: recalcule a razão a partir dos totais.

Decompor é análise: volume contra ticket, qual grupo ou unidade explica a variação em reais. Explicar por que caiu ou recomendar ação, sem dado de produtividade, meta ou budget na base, é invenção. Feche com a lista do que a base atual não responde. Quando o mês cai contra o anterior e sobe contra o ano passado, mostre as duas comparações e não escolha uma.

Pergunta de evento (quantas matrículas novas entre A e B) usa a data do evento e a data final inteira, não meia-noite. A coorte histórica não muda depois: se 20 entraram e 2 cancelaram, foram 20 matrículas novas; a situação atual (18 ativas, 2 canceladas) vem separada, pela situação mais recente da mesma matrícula. Pergunta de posição (quantos estavam matriculados em D) usa um único retrato.

Por padrão, responda com contagens e somas. Liste pessoas só quando quem pergunta pedir, com as colunas que a pergunta precisa e até 50 linhas. Em agentes de coordenadores e de mídia, e-mail, nome, telefone e documento ficam só dentro da consulta (para casar fontes) e nunca saem na resposta. Contato do CRM pode ser responsável, interessado ou familiar.

Agentes de coordenadores leem só um conjunto curado de tabelas, citadas pelo nome completo no documento. Erro de acesso fora dele é o escopo funcionando: o agente responde que aquilo está fora do seu acesso e diz onde está (dashboard, planilha, outro responsável), sem pedir permissão nova. Cada documento traz uma tabela O que esta fonte não responde e onde procurar.

A mesma pergunta usa o mesmo cálculo para qualquer pessoa, conversa ou painel. Filtros seguem esta prioridade: os explícitos na pergunta atual, os mantidos claramente na conversa, os ativos no painel, as regras padrão do documento. Relatório recorrente segue o playbook: leitura executiva de até cinco linhas antes de qualquer tabela, mês com comparação contra o mês anterior e o mesmo mês do ano anterior sempre juntas, acumulado do ano, quebras e rodapé de metodologia. Muda o meio (página, documento, markdown), não a estrutura.