Como ensinar a história da empresa a um agente de IA

Para ensinar a história da empresa a um agente de IA, não envie tudo o que você tem. Converta as decisões passadas, o contexto de clientes e as lições que o papel realmente exige em entradas curtas, cada uma com data, fonte e um responsável nomeado, e carregue apenas as que uma pessoa confirmou. Assim a memória inicial fica pequena, verificável e fácil de corrigir.

Principais pontos

• Monte a memória a partir das perguntas que o papel do agente precisa responder, não pelo tamanho do seu arquivo.
• Toda entrada precisa de data, fonte, escopo e um responsável que possa confirmá-la. Sem isso, ninguém consegue revisá-la.
• Escreva as decisões com seus motivos e suas condições, porque é o motivo que permite ao agente aplicá-las a um caso novo.
• Mantenha o material não confirmado em uma área de espera, separada da memória que o agente usa para agir.
• Teste a memória inicial com casos passados cuja resposta certa você já conhece e, depois, agende revisões.

Por que memória inicial não é um despejo de documentos?

O instinto é entregar ao agente todas as pastas, todas as conversas antigas e todas as apresentações, e deixar que ele se vire. Isso falha de maneiras previsíveis. Planos antigos ficam ao lado dos atuais, sem nenhum sinal de qual vale. Um comentário solto em um chat se torna indistinguível de uma decisão assinada. A preferência de um cliente, registrada numa relação anterior com outro contato, passa a ser aplicada a um contato diferente.

Um agente não tem noção de história institucional como um funcionário de longa data. Ele tem o que você coloca na frente dele e trata esse material com confiança parecida, a menos que a estrutura diga o contrário. A orientação da Anthropic sobre engenharia de contexto para agentes aponta na mesma direção: o objetivo é o menor conjunto de informação de alto sinal que permita ao agente fazer o trabalho, não a maior pilha possível. Para ver como isso se aplica ao negócio, leia engenharia de contexto para agentes de negócio.

Portanto, a tarefa é editorial. Você decide quais partes do passado da empresa merecem virar memória, escreve essas partes de um jeito que possa ser conferido e deixa o resto no arquivo, onde as pessoas ainda conseguem encontrar. Se você tem dúvida sobre a diferença entre isso e registros brutos de conversa, memória de IA ou histórico de chat explica a distinção.

Que história da empresa vale a pena carregar?

Comece pelo papel, não pelo arquivo. Anote uma dezena de perguntas que o agente vai enfrentar nas primeiras semanas e pergunte que histórico um colega novo e cuidadoso precisaria para respondê-las bem. Quatro tipos de material costumam merecer lugar.

• Decisões: o que foi escolhido, o que foi descartado, por quê e em que condições a decisão deve ser reaberta. Exemplos: a regra de só orçar depois de uma conversa de escopo, ou a escolha de parar de dar suporte a um fluxo antigo.
• Contexto de clientes e contas: fatos estáveis sobre como o cliente trabalha, quem aprova o quê, o que ele não gosta e o que foi prometido. Isso pertence a perfis estruturados. Veja como estruturar o perfil de memória de clientes.
• Lições: o que deu errado ou certo, escrito como uma causa curta e uma mudança de prática, não como uma história de culpa.
• Procedimentos e exceções: como a empresa trata casos recorrentes, incluindo as exceções que só existem na cabeça das pessoas.

O que normalmente não entra: transcrições brutas de reuniões, longas negociações por e-mail, opiniões pessoais sobre indivíduos, rascunhos que nunca viraram decisão e tudo o que suas regras sobre dados sensíveis na memória de agentes de IA proíbem. Esse material pode continuar como fonte para a qual as entradas apontam, sem ser memória.

Um filtro a mais ajuda. Pergunte se o fato ainda é verdadeiro e se o agente agiria de outro modo ao conhecê-lo. Se a resposta a qualquer uma das duas for não, deixe de fora.

Como é uma boa entrada de memória?

Uma boa entrada é uma afirmação curta e autocontida, com metadados suficientes para que um revisor a avalie em menos de um minuto. Parágrafos soltos copiados de documentos antigos não passam nesse teste, porque a afirmação fica enterrada e a data e o autor se perdem.

Use os mesmos campos em todas as entradas:

• Afirmação: uma ou duas frases em linguagem simples, escritas como algo que o agente possa usar.
• Tipo: decisão, contexto de cliente, lição ou procedimento.
• Data: quando a decisão foi tomada ou quando o fato foi confirmado pela última vez. Não a data em que você escreveu a entrada.
• Fonte: o documento, a conversa ou a ata de onde veio, com um ponteiro que alguém consiga abrir.
• Escopo: a que cliente, equipe, produto ou papel se aplica e onde não deve se aplicar.
• Responsável: a pessoa que pode confirmar, corrigir ou aposentar a entrada.
• Status: confirmada, inferida ou a verificar.
• Revisar até: quando uma pessoa deve olhar de novo, ou o evento que deve disparar a revisão.

Nas decisões, acrescente mais duas linhas: o motivo e a condição que reabriria a questão. Uma decisão guardada sem o motivo vira uma regra que o agente segue além do ponto em que ela faz sentido. Uma decisão guardada com o motivo permite que o agente perceba quando um caso novo está fora dela e pergunte.

O campo de data merece atenção especial. A história está cheia de fatos que foram verdadeiros em algum momento. Registrar quando cada um foi verdadeiro é o que permite, mais tarde, resolver divergências e expirar o que ficou velho, e isso está no centro de como evitar que contexto antigo engane seu agente de IA.

Plano passo a passo para montar a memória inicial

Este plano serve para um único papel com função clara. Resista à vontade de carregar a empresa inteira de uma vez.

• Passo um, defina o papel e suas perguntas. Escreva pelo que o agente é responsável e quais perguntas ele precisa responder. Esse é o seu filtro de relevância para tudo o que vem depois.
• Passo dois, faça o inventário das fontes candidatas. Liste onde mora a história relevante: registros de decisão, retrospectivas de projeto, anotações de clientes, pastas compartilhadas, histórico de chamados e a cabeça de duas ou três pessoas de casa há bastante tempo. Marque quais são oficiais e quais são informais.
• Passo três, defina as exclusões antes de ler qualquer coisa. Combine o que nunca deve ser guardado, como credenciais, dados de saúde, assuntos pessoais de funcionários e tudo o que um cliente pediu para ficar de fora. Faça isso primeiro, para que as exclusões não sejam decididas caso a caso, sob pressão.
• Passo quatro, entreviste quem guarda a história não escrita. Pergunte pelas decisões que os surpreenderam, pelas manias de clientes que custaram tempo e pelas exceções que nunca foram documentadas. Registre tudo como rascunho de entrada, com a pessoa nomeada como fonte.
• Passo cinco, redija as entradas no formato padrão. Extraia as afirmações, anexe datas e fontes e atribua um responsável. Quando não for possível achar a data ou a fonte, marque o status como a verificar em vez de chutar.
• Passo seis, peça que os responsáveis confirmem ou rejeitem. Cada responsável vê só as suas entradas e responde a uma de três coisas: continua verdadeira, é verdadeira mas mais restrita ou diferente, ou deve ser aposentada. Rejeições são resultado útil, não fracasso.
• Passo sete, carregue em camadas. As entradas confirmadas vão para a memória em que o agente se baseia para agir. As inferidas ou não verificadas vão para uma área de espera, que o agente pode conhecer mas na qual não deve se apoiar, ou ficam retidas por completo.
• Passo oito, teste com casos conhecidos. Escolha situações passadas cuja resposta certa se conhece e veja se o agente recupera as entradas certas e chega à conclusão certa. Como testar a qualidade da busca em uma base de IA descreve como fazer isso sem achismo.
• Passo nove, defina a rotina de revisão. Nomeie quem revisa o quê, com que frequência e quais eventos (mudança de cliente, mudança de política, saída de alguém) disparam uma checagem antecipada.

Dois detalhes poupam tempo. Primeiro, mantenha um registro curto do que você excluiu e por quê, para que a próxima pessoa não redescubra os mesmos documentos e reabra a questão. Segundo, guarde o ponteiro da fonte mesmo quando reescrever a afirmação, para que o revisor sempre consiga voltar à redação original.

Como lidar com conflitos, detalhes sensíveis e lacunas?

Carregar a história faz aparecer divergências, e isso é um benefício se você as trata de propósito. Dois documentos antigos vão dizer coisas diferentes sobre o mesmo cliente ou processo. Não deixe o agente descobrir isso durante o uso.

Resolva os conflitos na montagem, com uma ordem de precedência simples e escrita. Uma ordem comum: um registro assinado ou formalmente aprovado vale mais que uma nota de decisão datada, que vale mais que um e-mail, que vale mais que a lembrança de alguém. Quando duas fontes do mesmo nível divergem, em geral a mais recente prevalece, a menos que a mais antiga tenha um motivo declarado que continua válido. Se nenhuma das regras resolver, o responsável decide e a entrada registra que foi ele. As regras completas estão em memórias conflitantes em agentes de IA: qual fato prevalece.

Detalhes sensíveis pedem uma postura mais rígida. A história é o lugar onde as pessoas colam coisas que não deveriam persistir: situações pessoais, dados de pagamento, comentários francos sobre colegas. Na dúvida, guarde a conclusão sem o detalhe. Por exemplo, registre que um cliente exige aprovação por escrito antes de qualquer mudança, e não a história da disputa que levou a isso.

Lacunas são normais. Se ninguém sabe dizer por que uma decisão foi tomada, guarde-a com o motivo marcado como desconhecido e sinalize para o responsável. Uma lacuna honesta é melhor que um motivo plausível inventado por alguém para preencher o espaço.

Por fim, trate a memória como conteúdo que pode estar errado ou ser hostil. Documentos antigos podem conter instruções escritas para outro fim, e qualquer texto armazenado pode influenciar o comportamento. A lista da OWASP sobre riscos para aplicações com modelos de linguagem é um bom roteiro para entender por que o conteúdo carregado deve vir de fontes confiáveis e ser revisado antes do uso.

Um cenário ilustrativo

Isto é um cenário ilustrativo, não um cliente real. Um pequeno estúdio de design quer que um agente ajude seus gerentes de conta a se preparar para reuniões com clientes. As perguntas do papel incluem: o que combinamos da última vez, do que esse cliente não gosta e qual é a nossa regra para revisões?

A responsável de operações do estúdio monta a memória inicial em uma semana de trabalho em meio período. Ela parte das retrospectivas de projeto, das anotações de conta e de uma conversa com o gerente de conta mais antigo. Algumas das entradas resultantes:

• Afirmação: o Cliente A aprova todas as mudanças criativas por um diretor específico, e não pelo contato do dia a dia. Tipo: contexto de cliente. Fonte: ata de kickoff e uma conversa de e-mail posterior. Responsável: o gerente de conta. Status: confirmada. Revisar até: a próxima renovação de contrato.
• Afirmação: as rodadas de revisão têm limite no documento de escopo, e rodadas extras são orçadas à parte. Tipo: decisão. Motivo: rodadas ilimitadas tinham estendido projetos anteriores. Reabrir se: o estúdio mudar seu modelo de atendimento. Responsável: o fundador do estúdio. Status: confirmada.
• Afirmação: o Cliente B prefere resumos escritos curtos a reuniões. Tipo: contexto de cliente. Fonte: apenas a lembrança do gerente de conta. Status: a verificar, mantida na área de espera.

Durante a entrevista, o gerente de conta se lembra de uma regra antiga sobre entregas em fim de semana que contradiz uma nota de processo mais nova. A responsável de operações não escolhe uma das duas. Ela pergunta ao fundador, que confirma a nota nova e aposenta a regra antiga com data registrada. Ao testar o agente em três reuniões passadas, ele recupera corretamente a regra do diretor, mas deixa passar o limite de revisões, porque a entrada estava escrita em jargão interno. Ela a reescreve com as palavras que os clientes realmente usam, e a recuperação melhora.

A lição do cenário é o fluxo, não os detalhes: os responsáveis confirmam, os conflitos são resolvidos por uma pessoa, o que é incerto espera e os testes encontram problemas de redação antes dos clientes.

Como a Be Human cuida da memória inicial?

A Be Human trata a montagem da memória como parte do primeiro trabalho com o papel de um agente. Ajudamos a definir que histórico o papel precisa, redigimos as entradas em um formato com data e fonte, encaminhamos aos responsáveis que você indicar para confirmação e carregamos na memória do agente apenas o material confirmado. As regras de exclusão, os limites de aprovação e a rotina de revisão são combinados desde o início. Dentro da operação gerenciada, podemos conduzir revisões periódicas da memória, testar a recuperação com casos conhecidos e fazer correções controladas conforme a empresa muda. As decisões sobre o que o agente pode lembrar continuam com você. Para aprofundar a etapa de revisão, veja auditoria de memória de agente de IA: o que revisar e como.

Perguntas frequentes

Devo fazer fine-tuning de um modelo com a nossa história em vez de montar memória? Em geral não, quando os fatos mudam ou precisam de correção. A memória recuperada pode ter data e fonte, ser editada e removida, enquanto o conhecimento embutido nos pesos de um modelo é difícil de inspecionar ou retirar. Para ver os dois caminhos lado a lado, leia RAG ou fine-tuning para o conhecimento da empresa.

Quanta história a primeira versão deve ter? O mínimo que permita ao papel executar bem as primeiras tarefas. Um conjunto pequeno de entradas confirmadas vale mais que um grande sem revisão, porque cada entrada precisa ter alguém que responda por ela. Você pode acrescentar mais quando a rotina de revisão estiver funcionando.

E se a pessoa que conhece a história já saiu da empresa? Registre o que sobrou nos documentos, marque o status como a verificar e peça ao colega mais próximo que confirme ou rejeite. Se ninguém puder, mantenha o item fora da memória ativa. Uma afirmação não confirmada, de uma fonte que não está mais disponível, é um risco, não um ativo.

Com que frequência a memória inicial deve ser revisada? Defina a cadência pela velocidade com que os fatos mudam. Preferências de clientes e regras de processo costumam pedir checagem regular, e qualquer mudança de política, de cliente ou de equipe deve disparar uma revisão antecipada das entradas afetadas. Atribua um responsável a cada entrada, para que a revisão não dependa de uma única pessoa se lembrar de fazê-la.

Orientação editorial Be Human. Exemplos são ilustrativos, salvo atribuição explícita. Fontes oferecem contexto; a implementação depende do seu processo.