Layers por cliente e documentos de contexto
Resolver o cliente, rotear e aplicar a precedência
Resposta com a régua e as tabelas do cliente
Agente de IA, relatórios e atendimento
O que resolve
- O agente nunca mistura dados ou regras de um cliente com outro.
- Cada cliente é medido pela definição que combinou com a agência.
- Quando falta dado, o agente diz isso em vez de estimar.
Perguntas de negócio que responde
Faça estas perguntas ao seu agente quando o caso estiver pronto.
O que você precisa
- Fontes de cada cliente conectadas e organizadas por layer
- As definições de cada cliente: lead, venda, evento principal, imposto e escopo
O que você recebe
- Um documento de roteamento por cliente e plataforma
- Um contrato global com a precedência das regras
- Um agente que responde na régua de cada cliente
- A lista do que falta validar com cada cliente
Onde ativar
O gerente de conta pergunta sobre um cliente e recebe a resposta na régua daquele cliente.
Modelos de relatório no contexto, preenchidos só com dado consultado e com perguntas quando falta algo.
Dados fatiados por cliente para um agente que só enxerga o próprio dataset.
Pouca transformação e muita escrita. O trabalho é levantar e validar as regras de cada cliente; o modelo se repete a cada cliente novo. O detalhado traz as regras de negócio, as armadilhas e o teste de aceitação. Ou mande tudo direto para o seu agente com o MCP da Nekt.
Cada cliente da agência tem funil, evento de conversão, imposto, CRM e vocabulário próprios. Sem contexto separado, o agente de IA usa a tabela de outro cliente porque o nome é parecido, aplica a régua global por cima de uma exceção combinada ou estima um número que não existe. A resposta parece certa e chega errada ao cliente.
Como costuma ser feito, e a regra
Cada linha é um erro que já aconteceu na prática.
A ordem é: 1) cliente citado no pedido atual; 2) contexto da conversa, só quando existir exatamente um cliente ativo e sem ambiguidade; 3) caso contrário, o cliente fica não resolvido e o agente pergunta. Uma pergunta trata de um cliente só. Consultas que combinam clientes só quando pedidas de forma explícita.
Cada cliente tem um documento de roteamento por plataforma que diz a source, a layer e as tabelas físicas dele. Esse documento só resolve onde está o dado: não redefine KPI, resultado, grão ou deduplicação. Os documentos globais dizem como interpretar o dado e não guardam nomes físicos de cliente.
Quando duas regras conflitam, vale nesta ordem: 1) pedido explícito do usuário; 2) regra validada do cliente; 3) regra global da agência; 4) interpretação genérica da plataforma. Uma regra global nunca sobrescreve em silêncio uma exceção validada de um cliente.
Tabela de outro cliente não serve de prova, mesmo com nome, estrutura, métricas e conector iguais, ou quando o documento dele aparece por semelhança. Não reaproveite join validado, grão observado nem histórico disponível de outro cliente.
Lead pode ser negócio digital criado no CRM, contato com conversão válida na automação de marketing ou conversão reportada pela plataforma, quando não há CRM. A mesma palavra (lead, MQL, venda) muda de cliente para cliente. Use o vocabulário do relatório que o cliente já recebe e escreva a definição no documento dele.
Cabeçalho fixo: STATUS (validado, parcialmente validado, levantado nos dados e não validado), escopo, dono e data da última revisão. Ao responder com regra não validada, o agente avisa que a régua é da agência e está pendente de validação com o cliente.
Declare o que não entra na análise: funil de reativação montado por importação, receita da carteira antiga quando a agência só cuida da fatia nova, campanhas do próprio cliente na conta compartilhada. Nunca divida o faturamento total do cliente pela verba da agência.
Cliente sem CRM conectado não tem venda, MQL nem taxa de fechamento nos dados: o certo é dizer isso, não aproximar. Nenhum número é estimado, arredondado por conveniência ou inferido. Se falta informação para um relatório, o agente pergunta antes de preencher.
Regras são estáveis; contagens (clientes ativos, layers, conectores) são retrato de uma data e envelhecem em dias. Se um número do documento divergir da consulta, a consulta é a verdade. Antes de acusar divergência, confira a data da última execução da fonte.
O agente pode recuperar só um trecho. Cada bloco precisa se sustentar sozinho: título descritivo com o nome do cliente, um conceito por bloco, termo definido antes de ser usado e referência explícita a tabela e campo.
Quem vence quando duas regras conflitam
Da mais forte para a mais fraca. Sem cliente resolvido, nenhuma vale.
Definições
Armadilhas que já aconteceram
Clientes com tabelas de mesmo prefixo de conector e nomes parecidos levaram o agente a responder com dados de outro cliente.
Roteamento por cliente e proibição escrita de usar recurso de outro cliente.
Um cliente que combinou evento personalizado como resultado recebeu CPL calculado pelo lead padrão da regra global.
Precedência no documento global e exceção com status validado.
Quase todo o faturamento do cliente era recompra da carteira; dividir pela verba de mídia gerava retorno absurdo. A receita vinda de marketing era fração mínima.
Escopo escrito: só conta receita de quem foi lead de marketing.
Em cliente só com mídia, o agente aproximou vendas a partir das conversões da plataforma.
Documento de visão geral dizendo que a pergunta não tem resposta nos dados.
Documentos escritos por agente apareceram duplicados, com sondas de teste e um "panorama genérico do mercado" no meio do contexto do cliente; o benchmark genérico virou resposta.
Automação só atualiza blocos marcados; o genérico fica fora do documento do cliente.
Layers e conectores mudaram em poucos dias e a cópia da carteira no warehouse tinha até 24 horas de atraso; o documento e a consulta divergiam.
Data em toda contagem e a consulta como verdade.
Teste de aceitação
O caso está pronto quando todos os itens passam.
- Perguntando a mesma métrica para dois clientes com tabelas de nome parecido, cada resposta usa só a source e a layer do próprio cliente.
- Uma pergunta sem cliente, numa conversa sem cliente único, recebe uma pergunta de volta e nenhum número.
- Para um cliente com exceção validada de resultado, o custo por resultado do agente bate com o relatório oficial do cliente (diferença abaixo de 1%).
- Para um cliente sem CRM, "quantas vendas tivemos no mês" é respondida como dado inexistente, sem estimativa.
- Todo documento de cliente tem STATUS, dono e data de revisão no cabeçalho.
Pacote para o agente
Cole no Claude, ChatGPT ou outro cliente com o MCP da Nekt conectado.
Contrato de contexto por cliente - Toda pergunta trata de exatamente um cliente. Resolva nesta ordem: cliente citado no pedido; contexto da conversa só se houver um único cliente ativo; senão, pergunte qual é o cliente. - Nunca escolha cliente por semelhança de nome, mesma plataforma ou tabelas parecidas. - A localização física (source, layer, tabelas) vem do documento "<cliente> Roteamento" de cada plataforma. Os documentos globais dizem como interpretar, não onde está o dado. - Recurso de outro cliente não é evidência, mesmo com tabela, métrica e conector iguais. - Precedência: 1) pedido explícito do usuário; 2) regra validada do cliente; 3) regra global da agência; 4) interpretação genérica da plataforma. Regra global nunca sobrescreve exceção validada. - Lead, MQL, SQL e venda são definidos no documento de cada cliente. Use a definição dele. - Se a regra usada tiver status "não validado", diga que a régua é da agência e está pendente com o cliente. - Sem dado conectado (ex.: cliente sem CRM), diga que a pergunta não tem resposta nos dados. Nunca estime. - Contagens escritas nos documentos são retrato de uma data; se divergirem da consulta, vale a consulta. - Combinar clientes numa resposta só quando o usuário pedir explicitamente. Exceções por cliente: - <cliente>: lead = <definição>; status: <validado | não validado> em <data>. - <cliente>: fora de escopo: <funil, receita ou campanhas que não entram>. - <cliente>: sem CRM conectado; perguntas de venda e MQL não têm resposta nos dados.
Construa no meu workspace Nekt o caso "Contexto por cliente para o agente de IA" seguindo as regras em https://academy.nekt.com/industrias/agencias/contexto-por-cliente-ia.md. 1) Encontre as tabelas de origem e confirme as colunas usadas pelas regras. 2) Crie uma transformação no grão indicado aplicando todas as regras. 3) Rode o teste de aceitação e me mostre o resultado de cada item. 4) Crie o context document do caso no workspace, com as exceções dos meus clientes em aberto para eu preencher.
Variações
Uma tabela ou layer por cliente para agentes expostos ao cliente final; no notebook, nomes de tabela literais por cliente.
Fontes multi-cliente (Google Meu Negócio, Business Manager) filtradas pelo identificador do cliente declarado no documento.
A própria agência analisada como cliente fica num escopo separado das regras globais que ela mantém.