Perfil de memória de clientes para agente de IA: como estruturar

Um perfil de memória de clientes para agente de IA é um registro curto e estruturado de cada cliente. Cada item é uma afirmação com fonte, uma base (declarada, confirmada ou inferida) e uma regra para revisar ou encerrar o item. Esses três campos permitem que o agente distinga o que é confiável do que é apenas plausível, e é isso que o faz lembrar dos clientes com precisão. As conversas completas pertencem a um arquivo separado, não ao perfil.

Principais pontos

• O perfil é um registro curado, não uma transcrição: cada item é uma afirmação com fonte, base e regra de validade ou revisão.
• Separe o que o cliente disse, o que sua equipe confirmou e o que o agente inferiu, e limite como cada tipo pode ser usado.
• Preferências ficam desatualizadas mais rápido que dados de identidade, então cada tipo de item precisa de sua própria regra de revisão.
• Texto que vem de clientes é dado, nunca instrução, mesmo quando é o próprio agente que o grava na memória.
• Quando um item vence, marque-o como não verificado em vez de apagá-lo em silêncio ou continuar confiando nele em silêncio.

O que entra em um perfil de memória de cliente?

O perfil guarda o conjunto pequeno de informações de que o agente precisa para tratar o cliente corretamente sem repetir as mesmas perguntas toda vez. Isso inclui como se dirigir a ele, o que é verdade sobre a situação dele, como ele gosta de trabalhar, o que você prometeu e quais são os limites. Não entram todas as mensagens, todos os anexos nem todos os números do seu sistema financeiro.

A distinção importa porque perfil e histórico têm funções diferentes. O histórico responde ao que aconteceu. O perfil responde ao que o agente deve assumir agora e com que grau de certeza. Para um tratamento mais completo dessa fronteira, o artigo Memória de IA ou histórico de chat: o que guardar? mostra o que o agente deve guardar e o que deve apenas poder consultar.

O perfil também deve apontar para seus sistemas de registro, não copiá-los. O endereço de cobrança fica no sistema de cobrança, e o prazo do contrato fica no contrato. O perfil pode indicar onde encontrá-los e registrar apenas os fatos de que o agente precisa na conversa. O princípio é o mesmo de Como definir fontes oficiais para um agente de IA: um lugar de referência para cada fato, e todo o resto remete a ele.

Como é um perfil enxuto?

Mantenha o perfil em cinco blocos. Se um revisor humano não consegue lê-lo em poucos minutos, ele está longo demais, e ninguém vai mantê-lo correto.

• Identidade: o nome que o cliente usa, a forma de tratamento preferida, o idioma, o contato principal e a pessoa do seu lado que responde pelo relacionamento.
• Fatos: afirmações com fonte sobre a situação do cliente que afetam o seu trabalho, como a forma de aprovar gastos ou os sistemas que ele usa.
• Preferências: como ele gosta de se comunicar e trabalhar, como canal, horário, nível de detalhe e formato dos relatórios.
• Compromissos: o que você prometeu e o que continua em aberto, cada item com responsável e ponto de entrega.
• Limites: assuntos que exigem uma pessoa, temas que o cliente pediu para não abordar e observações sobre consentimento para uso de dados.

Cada bloco é uma lista de itens, e todos os itens usam os mesmos campos. Um formato uniforme permite que o agente e os revisores leiam rápido e apliquem as mesmas regras em todo lugar. Também facilita os testes, porque dá para verificar se algum item está sem fonte ou sem validade.

Como registrar um fato para que o agente possa confiar nele?

Dê a todo item os mesmos seis campos. Este é o núcleo do formato.

• Afirmação: uma frase, uma informação. Se a frase contém duas informações, divida, porque elas podem vencer em momentos diferentes.
• Fonte: o documento, o registro de sistema ou a mensagem de onde veio a informação, e quem a disse.
• Base: declarada pelo cliente, confirmada pela equipe, observada no comportamento ou inferida pelo agente.
• Registrado em: a data em que o item foi escrito, para que a idade esteja sempre visível.
• Revisar até: uma data ou um evento após o qual o item precisa ser conferido de novo.
• Escopo: quais papéis ou tarefas podem usar o item e se ele pode aparecer em algo que o cliente vai ler.

O campo de base é o que mais trabalha. Um cliente que escreve que prefere um resumo curto tem uma preferência declarada. Uma coordenadora que anota isso numa ligação tem uma preferência confirmada. Um agente que percebe que o cliente nunca abre anexos longos tem apenas uma inferência. As três são úteis, mas merecem tratamentos diferentes. Uma regra padrão sensata: itens inferidos podem orientar um rascunho que uma pessoa vai revisar, mas nunca podem ser afirmados ao cliente como fato. O agente pode fazer uma pergunta, por exemplo se um formato mais curto ajudaria.

O campo de fonte é o que torna a correção possível. Quando o cliente diz que algo mudou, você encontra o item, vê de onde ele veio e decide se a fonte antiga também ficou errada. Sem fonte, um item errado é só a sensação vaga de que algo não está certo.

Há mais uma regra aqui: itens são dados, não instruções. Clientes e terceiros enviam e-mails, formulários e documentos, e parte desse texto pode estar escrita como se fosse uma ordem. Se o agente grava memória a partir desse conteúdo, deve armazenar uma afirmação sobre o que o cliente disse, não uma regra que o agente precise cumprir. As orientações da OWASP sobre prevenção de prompt injection explicam por que texto não confiável deve ficar separado das instruções, e a memória é um dos lugares onde essa separação se perde com facilidade. Para ver o risco com mais detalhe, leia Prompt injection em documentos: o que proteger. Restrinja quem e o que pode gravar em um perfil, e registre cada gravação em log.

Como definir a validade de cada tipo de fato?

Validade não é um único cronômetro. Tipos diferentes de item ficam desatualizados por motivos diferentes, então cada tipo precisa de sua regra. Use este guia ao definir o campo de revisão.

• Dados estáveis de identidade, como a razão social: revise em ritmo fixo e sempre que ocorrer um evento gatilho, como a renovação do contrato.
• Contatos e cargos: revise quando um e-mail voltar, uma assinatura mudar ou o cliente mencionar um colega novo. As pessoas mudam de função sem avisar.
• Preferências declaradas: revise em um calendário lento e contínuo, e imediatamente se o cliente as contradisser.
• Preferências observadas ou inferidas: dê a elas vida curta. Ou confirme com o cliente, ou deixe vencerem.
• Compromissos: vencem quando concluídos ou quando o ponto de entrega passa, e então vão para o histórico com o resultado.
• Fatos situacionais, como uma restrição temporária ou uma ausência planejada: vencem no evento de término, não em um palpite de calendário.
• Consentimento e permissões: nunca renovam sozinhos. Vencem no fim do prazo e exigem que uma pessoa renove ou remova.

O que acontece no vencimento é tão importante quanto a regra. Um item vencido não deve sumir nem continuar sendo tratado como verdadeiro. Ele deve ser marcado como não verificado, e o agente deve confirmá-lo com a fonte ou com uma pessoa antes de usá-lo em qualquer coisa voltada ao cliente. Essa é a defesa prática contra o problema descrito em Como evitar que contexto antigo engane seu agente de IA. A remoção é um ato separado e deliberado, tratado em Como apagar a memória de um agente de IA: corrigir, expirar, excluir, que diferencia corrigir, expirar e remover.

Como montar os primeiros perfis?

Comece pequeno e com um fluxo de trabalho real. Um primeiro lote de perfis para poucos clientes ativos ensina mais do que migrar de uma vez todos os cadastros.

• Passo um: escolha o papel que o agente vai exercer e liste as perguntas sobre o cliente que ele precisa responder para fazer esse trabalho. O que não serve a essas perguntas fica de fora.
• Passo dois: escreva os cinco blocos e os seis campos como um modelo, e combine os valores permitidos para base e escopo.
• Passo três: preencha cada perfil a partir dos sistemas de registro e de quem na equipe conhece o cliente. Registre a fonte em cada item desde o início, mesmo que pareça lento.
• Passo quatro: defina as regras de revisão por tipo de item usando o guia acima e nomeie uma pessoa responsável pelo perfil de cada cliente.
• Passo cinco: defina quem pode gravar. Deixe o agente propor itens e exija aprovação da equipe para fatos que envolvam dinheiro, compromissos ou consentimento.
• Passo seis: separe os clientes com rigor, para que o perfil de um nunca possa ser recuperado enquanto se atende outro. O artigo Isolamento de dados de clientes em agentes de IA trata disso em termos práticos.
• Passo sete: teste com situações reais, incluindo um contato alterado, uma preferência contradita e um item vencido, e confirme que o agente se comporta como as regras determinam.
• Passo oito: revise as correções toda semana no primeiro período e ajuste o modelo onde os itens continuarem falhando.

Planeje para que o perfil seja carregado no contexto de trabalho do agente de forma seletiva. Nem todo item é necessário para toda tarefa, e um contexto inchado piora o agente em vez de melhorá-lo. O artigo da Anthropic sobre engenharia de contexto eficaz para agentes de IA explica por que um conjunto pequeno de informações de alto sinal costuma superar um conjunto grande. Para o tema no contexto de negócios, veja Engenharia de contexto para agentes de negócio. O campo de escopo ajuda aqui, porque permite que o sistema carregue só os itens relevantes para a tarefa atual.

Como isso funciona na prática?

Este é um cenário ilustrativo, não um caso real. Um escritório de contabilidade usa um agente para redigir mensagens de acompanhamento para a equipe. O perfil de um cliente contém uma preferência declarada por e-mail em português, registrada a partir de um formulário de integração assinado. Contém também uma preferência inferida por ligações antes do meio-dia, baseada nas reuniões que o cliente aceitou, com um prazo curto de revisão.

Quando o agente redige uma mensagem pedindo documentos que faltam, escreve em português sem hesitar, porque a base é declarada e a fonte é um documento. Quanto ao horário das ligações, ele não afirma uma preferência. O rascunho oferece dois horários e pergunta qual convém ao cliente, e avisa o revisor de que a preferência pela manhã é apenas inferida. Uma semana depois, um e-mail para o contato principal volta. O item de contato é marcado como não verificado, e o agente deixa de endereçar mensagens a essa pessoa e pede ao responsável pelo relacionamento que confirme quem cuida da conta agora.

Nada nesse exemplo exigiu um modelo sofisticado. Exigiu itens com fonte, base e regra de revisão, e um agente configurado para respeitá-los.

Como a Be Human trata a memória de clientes?

A Be Human desenha o formato do perfil junto com a empresa, como parte da definição de um papel, ao lado das ferramentas que o agente pode usar e dos limites de aprovação ao redor dele. A memória é separada por cliente, as gravações se limitam ao que o papel precisa, e fatos que afetam dinheiro, compromissos ou consentimento vão para uma pessoa aprovar. Durante a operação gerenciada, a equipe revisa correções, itens vencidos e permissões em uma rotina regular, e ajusta o modelo quando o mesmo tipo de item continua dando problema. A empresa mantém o controle sobre o que o agente lembra e pode inspecionar, corrigir ou remover qualquer item.

Perguntas frequentes

Qual deve ser o tamanho de um perfil de memória de cliente? Curto o bastante para que uma pessoa o revise em poucos minutos, em geral uma ou duas páginas de itens. Se ele não para de crescer, leve o detalhe para os documentos de origem e mantenha só as afirmações de que o agente precisa na conversa, com uma indicação de onde está o registro completo.

O agente pode gravar no perfil por conta própria? Pode propor, com limites sobre o que ele registra sozinho. Itens de baixo risco, como uma preferência de reunião confirmada, podem ser gravados com a fonte registrada, mas fatos sobre dinheiro, compromissos, consentimento ou identidade devem aguardar a aprovação da equipe. Toda gravação deve ficar em log para que um revisor veja o que mudou e por quê.

Perfis de memória de clientes levantam questões de proteção de dados? Podem levantar, porque guardam informações pessoais e empresariais de pessoas identificáveis. Guarde apenas o que o papel precisa, registre o consentimento quando ele se aplica, restrinja o acesso por cliente e por papel e torne a remoção possível. Verifique as regras aplicáveis à sua situação, como as publicadas pela ANPD no Brasil, com orientação qualificada.

Em que um perfil difere de uma base de conhecimento? Uma base de conhecimento reúne o conhecimento da empresa, compartilhado entre muitas tarefas, como políticas e procedimentos. Um perfil reúne fatos sobre um único cliente e tem escopo restrito a ele. Os dois podem alimentar o contexto do agente, mas têm responsáveis, rotinas de revisão e regras de privacidade diferentes.

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