Fonte da verdade para agentes de IA: como definir

O agente pode acessar tudo e ainda trabalhar com a informação errada

Uma empresa conecta o agente ao CRM, ao e-mail, ao ERP, aos documentos e às conversas da equipe. A integração funciona. O problema aparece quando duas fontes contam histórias diferentes.

O CRM mostra uma oportunidade em negociação. A planilha do vendedor informa que o cliente desistiu. O e-mail traz uma condição comercial aprovada. A proposta armazenada ainda contém a versão anterior. O agente encontra todos os registros, mas não sabe qual deles possui autoridade para orientar a próxima ação.

Esse conflito não se resolve com uma busca mais ampla. Ele exige uma fonte da verdade, também chamada de sistema de registro: o lugar reconhecido pela empresa como autoridade para um dado, estado ou decisão.

Agentes de IA tornam essa definição urgente porque conseguem localizar e combinar informação com velocidade. Sem uma hierarquia explícita, também conseguem distribuir inconsistência com a mesma velocidade.

O que significa fonte da verdade

Fonte da verdade é o sistema, documento ou registro autorizado a representar o estado vigente de um objeto operacional.

A definição precisa ser feita por objeto. Uma empresa raramente possui um único sistema responsável por tudo.

Exemplos:

o CRM pode ser a fonte oficial do estágio e da próxima ação de uma oportunidade;
o ERP pode responder por pedido, estoque, faturamento e condição financeira;
o sistema de atendimento pode representar status, prioridade e responsável de um chamado;
o repositório documental pode guardar a versão aprovada de uma política;
a agenda pode ser a autoridade sobre disponibilidade e compromisso confirmado;
um sistema de identidade pode determinar cargo, vínculo e permissão de acesso.

A fonte oficial não precisa concentrar todos os detalhes. Ela precisa ter autoridade sobre campos e estados definidos.

Uma conversa no WhatsApp pode explicar por que o cliente pediu adiamento. O CRM ainda deve registrar a nova próxima ação e sua data. A conversa preserva contexto; o CRM preserva o estado que organiza o trabalho.

Fonte oficial, memória e contexto cumprem papéis diferentes

Essas três camadas costumam ser misturadas em projetos de agentes.

Fonte oficial mantém o estado operacional

Ela responde perguntas como:

qual é o estágio atual;
quem é o responsável;
qual versão está aprovada;
que valor foi registrado;
qual prazo está vigente;
que ação foi concluída.

O agente deve consultar essa camada antes de executar decisões que dependem do estado atual.

Memória preserva informação útil entre execuções

A memória pode guardar preferências, resumos, padrões e contexto recuperável. Ela melhora continuidade, mas não deveria substituir automaticamente um sistema transacional.

Uma lembrança de que o cliente prefere reuniões pela manhã ajuda a preparar o contato. Ela não prova que existe uma reunião confirmada amanhã.

O guia sobre memória de agentes de IA mostra como separar memória de curto prazo, conhecimento persistente e estado do processo.

Contexto reúne o necessário para a tarefa atual

Contexto é o pacote montado para uma execução. Pode combinar estado oficial, documentos, histórico recente, instruções e dados recebidos naquele momento.

A qualidade desse pacote depende de origem, versão e validade visíveis. Uma resposta fluente não corrige uma fonte vencida.

Comece pelos objetos que movem o processo

A empresa pode passar meses tentando organizar todos os dados antes de implementar um caso de uso. O recorte mais útil começa no processo escolhido.

Liste os objetos que o agente precisa consultar, criar ou alterar. Em um fluxo comercial, por exemplo:

conta;
contato;
oportunidade;
proposta;
compromisso;
próxima ação;
condição comercial;
mensagem enviada.

Para cada objeto, responda:

qual sistema cria o identificador principal;
onde o estado vigente deve aparecer;
quem pode alterar esse estado;
quais campos vêm de outras fontes;
como uma mudança é confirmada;
que histórico precisa permanecer acessível;
o que acontece quando existe divergência.

Esse inventário revela um problema comum: a empresa nomeou um sistema oficial, mas a rotina real continua decidindo por mensagens e planilhas paralelas.

Defina autoridade por campo e por evento

Dizer que “o CRM é a fonte oficial” pode ser amplo demais. O CRM talvez tenha autoridade sobre estágio e responsável, enquanto preço aprovado vem do sistema comercial e situação de pagamento vem do financeiro.

A definição precisa chegar ao nível em que o agente toma decisões.

Autoridade por campo

Registre para cada dado relevante:

nome e significado;
fonte autorizada;
formato;
responsável pela qualidade;
frequência de atualização;
prazo de validade;
regra de acesso;
comportamento quando estiver ausente.

Autoridade por evento

O estado muda quando algo acontece. A arquitetura deve reconhecer eventos como:

proposta aprovada;
pagamento confirmado;
reunião remarcada;
chamado resolvido;
contrato assinado;
cadastro bloqueado;
pedido cancelado.

Cada evento precisa ter origem autorizada, identificador, horário e confirmação no destino. Um texto dizendo “pagamento aprovado” dentro de uma conversa não deve ter a mesma autoridade de uma confirmação do sistema financeiro.

Crie uma hierarquia para conflitos

Conflitos vão acontecer mesmo em operações organizadas. Integrações atrasam, pessoas registram mudanças no lugar errado e documentos permanecem abertos depois de uma nova versão.

O agente precisa de uma política previsível.

Uma hierarquia pode considerar:

autoridade da fonte para aquele campo;
versão aprovada;
confirmação do evento;
data e horário;
identidade de quem alterou;
estado de sincronização;
necessidade de validação humana.

A regra “usar o registro mais recente” costuma ser frágil. Um comentário novo não deveria revogar um contrato aprovado. Uma planilha alterada ontem não deveria substituir o estoque confirmado hoje pelo ERP apenas porque o arquivo possui outro horário.

Quando o conflito não pode ser resolvido de forma determinística, o agente deve parar a ação dependente, apresentar as fontes divergentes e encaminhar a decisão para a pessoa responsável.

O artigo sobre handoff entre agente de IA e humano explica como transferir o caso com contexto e decisão pendente, sem obrigar a pessoa a reconstruir tudo.

Leitura e escrita exigem controles diferentes

Consultar informação possui um risco. Alterar o sistema oficial possui outro.

Na leitura

O agente deve registrar:

fonte consultada;
objeto e identificador;
versão ou horário relevante;
campos usados;
falhas de acesso;
divergências encontradas.

Também deve limitar a busca ao escopo necessário. Acesso a todos os clientes, contratos e documentos raramente é requisito para concluir uma única tarefa.

Na escrita

A arquitetura precisa confirmar:

identidade autorizada;
operação permitida;
estado anterior;
alteração proposta;
regra aplicada;
aprovação exigida;
resultado devolvido pelo sistema;
identificador da transação.

Uma resposta de sucesso da integração ainda pode ser ambígua. Depois de timeout, o agente precisa verificar se a alteração ocorreu antes de tentar novamente. Sem idempotência e confirmação, uma retomada pode criar duas tarefas, duas mensagens ou dois pedidos.

O guia sobre identidade e credenciais para agentes de IA detalha como separar contas, permissões e trilhas por processo.

Evite cópias que viram sistemas paralelos

Agentes frequentemente criam resumos, índices vetoriais, caches e bases de apoio para recuperar contexto com rapidez. Essas cópias podem ser úteis, desde que a arquitetura saiba que são derivadas.

Para cada cópia, defina:

fonte de origem;
campos replicados;
frequência de atualização;
mecanismo de invalidação;
data da última sincronização;
finalidade;
prazo de retenção;
ação permitida quando estiver desatualizada.

Uma base vetorial pode ajudar a localizar uma política. A versão oficial do documento ainda deve confirmar o conteúdo antes de uma decisão sensível.

Um resumo de atendimento pode acelerar a triagem. O chamado oficial continua responsável pelo status, pela fila e pelo encerramento.

A cópia precisa apontar de volta para a origem. Quando o agente entrega apenas um trecho sem identificador, versão ou link, a pessoa recebe conveniência sem capacidade de verificação.

Organize o caminho de retorno ao sistema

Muitos projetos param quando o agente produz uma boa resposta. O trabalho permanece fora da operação.

Se o agente prepara uma próxima ação comercial, o resultado precisa voltar ao CRM. Se classifica uma solicitação, a fila responsável deve receber o registro. Se extrai obrigações de um contrato, o sistema de gestão precisa guardar tarefa, prazo e dono.

Defina três estados:

Preparado

O agente produziu uma sugestão ou pacote revisável. Ainda não houve alteração oficial.

Aprovado

Uma regra ou pessoa autorizou a mudança. A ação pode seguir para execução.

Confirmado

O sistema de destino registrou a alteração e devolveu evidência. Somente aqui o processo pode considerar a etapa concluída.

Essa separação evita que um rascunho vire fato e que uma aprovação seja confundida com execução.

Exemplo: agente de follow-up comercial

Considere um agente que identifica oportunidades sem próxima ação e prepara mensagens de continuidade.

A arquitetura pode definir:

CRM como fonte oficial de estágio, responsável e próxima ação;
e-mail e WhatsApp como fontes de conversa;
repositório comercial como fonte de condições e materiais aprovados;
agenda como fonte de horários confirmados;
memória do agente como apoio para preferências e sínteses, sempre vinculada à origem.

Antes de sugerir o follow-up, o agente relê a oportunidade, verifica a última interação e confirma que nenhuma reunião ou resposta nova apareceu.

Se o WhatsApp informa desistência e o CRM continua aberto, ele não dispara uma cobrança automática. Registra a divergência, prepara o contexto e pede ao responsável que confirme o estado.

Depois da decisão, o CRM recebe motivo, próxima ação, data e responsável. A mensagem enviada fica ligada à oportunidade. O processo continua legível para a equipe e para a próxima execução.

Veja também o guia sobre como integrar um agente de IA ao CRM.

Como implantar em seis etapas

1. Escolha um processo

Evite começar por um catálogo corporativo inteiro. Selecione uma unidade de trabalho com dono, volume e resultado observável.

2. Liste objetos e decisões

Identifique dados, documentos, estados e eventos usados pelo agente. Marque o que apenas informa e o que autoriza ação.

3. Nomeie a fonte autorizada

Defina autoridade por campo e evento. Registre também responsável, atualização e acesso.

4. Escreva regras de conflito

Documente prioridade, validade, confirmação e situações que exigem revisão humana. Teste com divergências reais.

5. Construa leitura e retorno

Integre consulta, preparação, aprovação, escrita e confirmação. Preserve identificadores entre as etapas.

6. Monitore a integridade

Acompanhe divergências, sincronizações atrasadas, campos ausentes, alterações recusadas e correções humanas. Esses sinais mostram onde a arquitetura ou a disciplina de registro precisa melhorar.

Métricas que revelam a qualidade da fonte

Um painel útil pode acompanhar:

percentual de casos com fonte identificada;
divergências por objeto e sistema;
registros sem responsável ou próxima ação;
tempo entre evento e atualização oficial;
tentativas de escrita recusadas;
duplicidades evitadas;
decisões devolvidas por contexto insuficiente;
correções humanas após ação do agente;
cópias derivadas fora da janela de atualização;
casos concluídos com confirmação no destino.

O objetivo não consiste em produzir uma base perfeita. A empresa precisa saber quando a informação é confiável o suficiente para cada tipo de decisão.

Checklist da fonte da verdade

Antes de ampliar a autonomia, confirme:

[ ] cada objeto crítico possui fonte autorizada;
[ ] autoridade está definida por campo e evento quando necessário;
[ ] versão, horário e identidade ficam visíveis;
[ ] cópias derivadas apontam para a origem;
[ ] conflito possui regra ou escalonamento;
[ ] ausência de dado não vira preenchimento inventado;
[ ] leitura usa o menor escopo necessário;
[ ] escrita exige identidade e permissão adequadas;
[ ] aprovação e confirmação são estados separados;
[ ] retentativas não duplicam efeitos;
[ ] a decisão volta ao sistema oficial;
[ ] divergências e atrasos são monitorados;
[ ] existe dono para corrigir a qualidade do registro.

A fonte da verdade transforma acesso em direção

Conectar um agente a muitos sistemas aumenta alcance. A utilidade aparece quando ele sabe qual registro orienta cada decisão, como tratar divergências e onde devolver o resultado.

A arquitetura precisa separar estado oficial, memória e contexto. Também precisa definir autoridade, confirmação, escrita e exceção. Com essa base, o agente ajuda a manter a operação atualizada. Sem ela, apenas percorre versões concorrentes da empresa e escolhe uma delas com confiança difícil de auditar.