Ir para conteúdo
be-human.ai
← Voltar ao blog

Contexto e memória

Esquema de memória para agentes de IA: clientes, trabalhos e ativos

Esquema de memória para agentes de IA com clientes, trabalhos e ativos como entidades, IDs estáveis e relações que o agente lê com segurança.

Capa tipográfica do Be Human com o título: Esquema de memória para agentes de IA: clientes, trabalhos e ativos
Ilustração conceitual criada com IA · Be Human

Um esquema de memória para agentes de IA é uma lista curta e fixa de tipos de entidade, como clientes, trabalhos e ativos, em que cada registro tem um ID estável, um pequeno conjunto de campos obrigatórios e vínculos nomeados com outros registros. Um agente que lê essa estrutura consegue saber qual trabalho pertence a qual cliente, qual unidade foi atendida e o que mudou desde a última visita, sem adivinhar a partir de anotações soltas. Comece com três tipos de entidade, emita IDs que nunca mudam e registre as relações antes que qualquer agente leia os dados.

Principais pontos

  • Dê a cada entidade um ID emitido uma única vez e nunca reutilizado, mesmo depois que o registro for encerrado ou unificado.
  • Guarde as relações como registros de vínculo explícitos, com tipo, direção, status e fonte, e não como frases escondidas em anotações.
  • Comece com clientes, trabalhos e ativos, e acrescente um novo tipo somente quando um agente continuar falhando por falta dele.
  • Mantenha separado o que o esquema afirma como atual do que uma conversa apenas mencionou.
  • Revise o esquema em uma rotina regular, porque os campos que importam mudam conforme o trabalho muda.

Por que anotações em texto livre falham para um agente

A maioria das empresas já guarda memória em anotações, e-mails, conversas de chat e pastas compartilhadas. Esse material funciona para pessoas, que preenchem lacunas com contexto e bom senso. Um agente lê o mesmo material de forma literal. Se uma anotação diz a van da empresa e outra diz a Transit azul, o agente não tem como saber com segurança que as duas se referem ao mesmo ativo, nem se esse ativo foi vendido e substituído.

As entidades resolvem isso ao tornar a identidade uma propriedade do registro, e não uma propriedade da redação. A frase pode mudar; o ID permanece. À medida que os agentes assumem tarefas mais longas, um vínculo errado fica mais caro, porque pode se repetir silenciosamente em muitas ações antes que alguém perceba. O esquema é o que permite a um agente agir sobre um fato com confiança, em vez de reconstruir a identidade a partir de texto toda vez.

Os três tipos de entidade para começar

A maioria dos negócios operacionais consegue descrever quase todo o seu trabalho com três tipos. Cada tipo precisa de um núcleo obrigatório pequeno, e todo o resto pode esperar até que uma tarefa real exija.

  • Cliente: customer_id, nome legal ou fantasia, idioma preferido, canais de contato com o status de consentimento de cada um, status da conta e o responsável interno que pode aprovar exceções.
  • Trabalho: job_id, customer_id, status de uma lista fixa, escopo em uma ou duas frases, janela agendada, colaborador designado e a regra de aprovação que governa as alterações.
  • Ativo: asset_id, customer_id do dono, tipo do ativo, localização, identificadores externos como números de série ou placas, e um ponteiro para o registro de manutenção ou histórico.

Mantenha fora do núcleo os campos que mudam com frequência e coloque-os em eventos vinculados. O telefone de um cliente muda, mas o histórico de quem foi ligado e quando é um evento separado que referencia o ID do cliente. Se a sua operação precisar de mais estrutura no futuro, a abordagem em grafo de conhecimento para agentes de IA mostra como começar com poucos tipos de entidade sem superdimensionar o modelo.

Como desenhar IDs que um agente consegue ler

Um ID é o único valor que um agente deve usar para decidir que duas coisas são a mesma. Nomes, e-mails e endereços são insumos para a comparação, não identidade. As regras de comparação merecem um desenho próprio, abordado em unificar cadastro de clientes com IA, mas as regras de ID abaixo valem independentemente de como a comparação for feita.

  • Emita todo ID dentro da sua camada de memória ou do seu sistema de registro, e nunca o derive de um nome, telefone ou endereço.
  • Use um prefixo curto de tipo, como cus, job ou ast, para que quem lê identifique o tipo da entidade de relance.
  • Nunca reutilize um ID, mesmo depois que um registro for encerrado, unificado ou excluído, para que referências antigas não apontem silenciosamente para algo novo.
  • Guarde identificadores externos, como uma referência de faturamento ou de agendamento, em campos próprios, com o sistema de origem nomeado.
  • Quando dois registros se provarem a mesma entidade, mantenha um ID canônico e registre o outro como apelido que aponta para ele.
  • Registre quem criou cada ID e quando, para que uma auditoria consiga rastrear de onde veio cada vínculo.

Prefixos ajudam pessoas e modelos a ler o esquema rapidamente, mas não são um recurso de segurança. O que importa é que cada ID seja estável, único e rastreável.

Relações que um agente consegue seguir

As relações devem ser registros, não frases. Um registro de vínculo que diz que o cliente cus_0142 tem o trabalho job_0917, com status ativo, fonte o sistema de agendamento confirmado pelo responsável da conta, é algo que um agente consegue verificar. Uma anotação que diz este é o trabalho do Silva não consegue. Todo vínculo precisa de um tipo de relação, uma direção, os dois IDs, um status de validade e uma fonte.

Defina a cardinalidade antes de construir. Um trabalho normalmente pertence a um cliente. Um ativo pode pertencer a um cliente por vez, mas muda de mãos, então a propriedade deve ser um vínculo com status de validade, e não um campo sobrescrito. O dono anterior permanece no histórico em vez de desaparecer dele.

Cenário ilustrativo: uma oficina que conserta unidades de refrigeração comercial recebe uma ligação sobre uma unidade atendida duas visitas antes. Como a unidade é um ativo com ID próprio, vinculado ao trabalho que a atendeu, o agente consegue recuperar esse trabalho, ver as peças usadas e a dúvida em aberto do técnico, e redigir uma resposta que cite esses registros. Sem o vínculo, o agente buscaria pelo nome do cliente e poderia pegar outro trabalho ou uma unidade que já foi transferida para outra filial.

Quando duas fontes divergem sobre uma relação, não deixe o agente adotar silenciosamente a mensagem mais recente. Marque o vínculo como contestado e encaminhe para uma pessoa. As regras para escolher entre fatos conflitantes estão descritas em memórias conflitantes em agentes de IA.

Permissões, campos sensíveis e o que fica de fora

Esquemas de entidade facilitam o controle de acesso, porque as permissões podem se aplicar a tipos de entidade e a campos individuais, em vez de a um grande bloco de texto livre. Um agente de agendamento pode precisar do status e do escopo do trabalho, mas não precisa dos dados de pagamento de um cliente. A orientação de autorização da OWASP descreve a verificação de acesso em cada requisição, em relação à identidade que a faz, e não em relação ao que um prompt pede. Aplique o mesmo princípio a toda leitura de memória.

Alguns materiais nunca deveriam entrar no esquema:

  • Números de cartão de pagamento, credenciais bancárias e senhas.
  • Documentos de identidade do governo e registros de saúde ou jurídicos, que pertencem a sistemas de registro com controles próprios.
  • Julgamentos pessoais sobre clientes, como comentários sobre caráter, que devem ser revisados por uma pessoa antes de serem armazenados em qualquer lugar.

Revise as permissões por campo sempre que a função de um colaborador mudar, e remova acessos que não correspondam mais ao trabalho. Trate o esquema como uma superfície de controle, e não apenas como uma conveniência para o agente.

Como a Be Human trata isso em operações gerenciadas

A Be Human desenha o esquema de entidades como parte de um primeiro projeto, começando pelo único papel que o agente vai desempenhar. O trabalho define quais tipos de entidade, IDs, relações e campos esse papel precisa, a memória e as ferramentas às quais ele tem acesso, e os limites de aprovação para qualquer alteração neles. Em operações gerenciadas, a equipe acompanha se o agente resolve registros para os IDs corretos, executa verificações recorrentes sobre apelidos e qualidade dos vínculos, revisa permissões quando os papéis mudam e responde a incidentes em que um vínculo errado chegou a um cliente. As mudanças no esquema são feitas como melhorias controladas, com motivo registrado, e não como edições informais nas anotações do agente.

Se você quer descobrir a primeira tarefa que vale entregar a um agente, o diagnóstico gratuito de IA da Be Human é o lugar para começar, e o trabalho de esquema costuma partir dessa tarefa.

Perguntas frequentes

Quantos tipos de entidade um primeiro esquema de agente deve ter? Três é um ponto de partida sólido para a maioria dos negócios operacionais: clientes, trabalhos e ativos. Acrescente um novo tipo somente quando o agente continuar falhando por falta dele, e registre cada acréscimo junto com a falha que o motivou. Uma lista longa logo no início costuma indicar que a equipe está modelando o que deseja, e não o que faz.

O agente pode gerar os próprios IDs? Não. Os IDs devem ser emitidos pela camada de memória ou pelo sistema de registro, sob regras que a sua equipe controla. Se um agente puder criar IDs livremente, duas execuções podem gerar dois registros para o mesmo cliente, e a duplicata se torna difícil de encontrar depois.

As anotações em texto livre podem continuar ao lado do esquema? Sim, e devem. As anotações guardam nuances e contexto que um campo não consegue capturar, mas o agente deve tratá-las como material de apoio vinculado a um ID, nunca como o único registro de qual cliente ou ativo um fato descreve.

O que acontece quando um cliente ou ativo é excluído? Encerre o registro, mantenha o seu ID reservado e trate a remoção conforme as suas regras de retenção e exclusão, nunca reatribuindo o ID a uma nova entidade. O processo para corrigir, expirar ou remover memória está descrito em como apagar a memória de um agente de IA.

Seu próximo passo

Descubra primeiro onde um agente de IA cabe na sua empresa.

Faça o diagnóstico gratuito de IA da Be Human. Algumas perguntas sobre o seu trabalho mostram qual tarefa entregar primeiro a um agente, o que ele precisa saber e onde uma pessoa aprova.

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

Menos tarefas. Mais espaço para você.

Traga o trabalho para o qual falta tempo.

Agende uma conversa e teste 7 dias grátis um agente de IA personalizado ↗Ou faça o diagnóstico gratuito de IA →