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

Contexto e memória

Backup da memória de agentes de IA: o que copiar e testar a restauração

Guia prático de backup da memória de agentes de IA: o que o snapshot deve conter, com que frequência testar a restauração e quem deve guardar as cópias.

Capa tipográfica do Be Human com o título: Backup da memória de agentes de IA: o que copiar e testar a restauração
Ilustração conceitual criada com IA · Be Human

Um backup da memória de agentes de IA é uma cópia versionada e restaurável do conhecimento curado do qual o agente depende: fatos aprovados, registros de entidades, instruções, regras de permissão e um registro de alterações, guardados fora do ambiente de execução do agente. Um bom backup consegue reconstruir a memória do agente até um ponto conhecido no tempo, mas só prova seu valor quando alguém restaura de propósito e confere o resultado. Este guia explica o que o backup deve conter, com que frequência testar a restauração e quem deve guardar cada cópia.

Principais pontos

  • O backup deve incluir memória curada, instruções, permissões de ferramentas e histórico de alterações, e não apenas transcrições brutas de conversas.
  • Guarde pelo menos uma cópia fora do ambiente de execução do agente, para que um job com defeito ou uma importação ruim não sobrescreva todas as cópias.
  • Teste a restauração em uma agenda fixa e após cada mudança relevante, porque um backup que nunca foi restaurado é apenas uma suposição.
  • Divida a custódia entre um responsável com autoridade dentro da empresa e um operador que consiga executar a restauração.
  • Mantenha segredos e dados pessoais sensíveis fora da memória, para que uma restauração não os traga de volta.

O que um backup de memória deve conter

A maioria das equipes faz backup do banco de dados que guarda as anotações do agente e para por aí. Isso captura o armazenamento, mas deixa de fora o contexto operacional do agente. Uma cópia restaurável precisa de cinco grupos de material, cada um com seu próprio identificador de versão:

  • Memória curada: fatos aprovados, registros de entidades como clientes, serviços ou ativos, e a referência à fonte de cada registro.
  • Instruções e tom de voz: a definição do papel, os limites de aprovação e qualquer glossário que o agente deve usar.
  • Definições e permissões de ferramentas: quais ferramentas existem, seus esquemas de entrada e quais funções podem acioná-las.
  • Configurações de recuperação: regras de fragmentação, identificador do modelo de embeddings e configuração de ranking, para que a busca se comporte da mesma forma após a restauração.
  • Registro de alterações: quem adicionou, editou, corrigiu ou expirou cada item de memória, e quando.

O registro de alterações é a parte que mais costuma faltar. Sem ele, você consegue restaurar a memória, mas não consegue explicar por que ela diz o que diz nem provar que um fato errado foi removido. Cada registro também deve ter um campo de procedência que aponte para o documento ou a conversa de origem, para que o estado restaurado possa ser conferido contra suas fontes.

Não trate o índice vetorial como backup. Um índice pode ser reconstruído a partir dos documentos de origem e dos registros de memória, então faça backup das entradas e da configuração que o produzem. Guardar também o índice pode acelerar a recuperação, mas ele não é a fonte da verdade.

Mantenha memória, transcrições e configurações do modelo em camadas separadas

As restaurações dão errado quando as camadas se misturam. As transcrições de conversas têm grande volume e são, em sua maioria, transitórias. A memória curada é menor e passou por revisão. As configurações do modelo mudam quando o fornecedor atualiza um modelo. Um backup que mistura as três torna difícil decidir o que reverter quando algo quebra.

Dê a cada camada sua própria regra de retenção. Transcrições normalmente precisam de uma vida útil mais curta e só são copiadas quando uma disputa, uma auditoria ou uma obrigação legal exige. A diferença entre anotações temporárias de sessão e memória empresarial durável é explicada em Memória de IA ou histórico de chat: o que guardar?, e ela deve decidir o que entra no backup.

Com que frequência fazer backup e com que frequência testar a restauração

Defina a cadência do backup pela velocidade com que a memória muda. Um agente que recebe novos registros de clientes ao longo do dia precisa de um snapshot noturno da memória curada, enquanto um agente que trabalha principalmente com políticas estáveis pode funcionar com snapshots semanais. Faça um snapshot extra antes de qualquer importação em massa, troca de modelo, mudança de esquema de ferramenta ou revisão de permissões, e identifique-o de forma que seja fácil de encontrar.

O teste é uma atividade separada, com agenda própria. Use este roteiro:

  • Escolha um snapshot recente e pelo menos um fato que você consiga verificar em um documento de origem atual.
  • Restaure em um ambiente de teste isolado. Nunca restaure sobre a memória de produção como primeiro passo.
  • Execute um conjunto fixo de perguntas com respostas conhecidas e registre quais fontes o agente cita.
  • Compare as permissões de ferramentas restauradas com o registro de permissões aprovado.
  • Confira se o registro de alterações explica cada item da memória restaurada.
  • Anote cada falha, corrija o processo de backup e agende o próximo teste.

Execute o ciclo completo pelo menos uma vez por trimestre e após qualquer mudança relevante na memória, nas ferramentas ou no modelo. O primeiro teste costuma revelar algo que falta, como um arquivo de configuração que existia apenas no notebook de uma pessoa. Descobrir isso durante o teste é justamente o objetivo do exercício.

Quem deve guardar as cópias

A custódia responde a duas perguntas: quem pode ler o backup e quem pode colocá-lo novamente em uso. Por padrão, essas não devem ser a mesma pessoa, e as duas respostas precisam estar escritas.

  • Um responsável com autoridade dentro da empresa mantém o registro de onde as cópias ficam e de quem pode acessá-las.
  • Um operador, interno ou externo, executa os snapshots agendados e os testes, e pode restaurar no ambiente de teste.
  • A restauração em produção exige uma aprovação separada do responsável, registrada no registro de alterações.
  • Pelo menos uma cópia fica em um local no qual o ambiente de execução do agente não consegue escrever, para que nenhum job isolado apague todas as versões.

Use seu modelo de papéis para decidir quem pode ver registros no nível de cliente dentro de um snapshot, já que um backup carrega os mesmos dados pessoais do original. Acesso à memória de IA por função: guia prático para empresas mostra como delimitar essas permissões. A orientação de autorização da OWASP é um checklist útil aqui, principalmente o princípio de conceder a cada função apenas o acesso de que ela precisa. Mantenha os registros de restauração como um registro próprio, da mesma forma que a introdução à observabilidade do OpenTelemetry trata logs como um sinal distinto, para que depois seja possível ver quem restaurou o quê e quando.

Criptografe os backups em repouso, revise a lista de detentores sempre que alguém mudar de função e lembre que um backup herda todas as obrigações do original. O NIST AI Risk Management Framework descreve a gestão de riscos como uma atividade contínua ao longo da vida de um sistema, o que combina com um backup que precisa ser testado repetidamente.

Segredos, tokens de acesso e dados pessoais que nunca deveriam estar na memória também devem ficar fora dos backups. Se algo sensível foi salvo por engano, limpe a memória primeiro e só então faça um snapshot novo, porque a restauração trará de volta tudo o que o snapshot antigo continha. A fronteira está descrita em Dados sensíveis na memória de agentes de IA: o que nunca guardar.

Uma restauração ilustrativa após uma importação ruim

Cenário ilustrativo, não é um caso de cliente: um agente de atendimento de um fornecedor de equipamentos responde perguntas a partir de uma lista curada de contatos de assistência técnica. Um integrante da equipe importa uma planilha antiga e, por engano, marca vários contatos desligados como ativos. O agente passa a enviar lembretes de manutenção para pessoas que já não trabalham com a empresa.

Como a equipe faz um snapshot antes de cada importação em massa, a correção não é uma edição manual em centenas de registros. O operador restaura o snapshot anterior à importação no ambiente de teste e executa as perguntas do roteiro. As respostas confirmam que os contatos desligados saíram da lista. O responsável aprova a promoção para produção, e o registro de alterações mostra qual importação introduziu o erro. Em seguida, a equipe acrescenta uma etapa de validação ao checklist de importação. Sem o snapshot anterior à importação, teriam de reconstruir a lista de contatos de memória e adivinhar quais entradas estavam corretas.

Como a Be Human executa backup e restauração para um agente

A Be Human desenha infraestrutura de agentes de IA personalizada, em que identidade, memória, canais, ferramentas e permissões continuam sob controle humano. Por isso, o backup faz parte do desenho, e não é algo acrescentado depois. Na operação gerenciada, o trabalho inclui a agenda de snapshots, os snapshots tirados antes de cada mudança, o inventário de componentes com identificadores de versão, os testes de restauração medidos pelo critério de sucesso combinado no início e um registro de cada aprovação de restauração. A resposta a incidentes inclui um caminho de restauração testado, e as revisões de permissão verificam quem detém cópias. As decisões continuam com o responsável, e o registro operacional mantém essas decisões visíveis.

Se você quer identificar a primeira tarefa que vale entregar a um agente, e a memória de que ela precisaria para ser restaurada com segurança, faça o diagnóstico gratuito de IA da Be Human.

Perguntas frequentes

Com que frequência fazer backup da memória de um agente de IA? Defina a frequência pela velocidade com que a memória muda e nunca confie apenas na agenda. Um agente que recebe novos registros todos os dias precisa de snapshots frequentes da memória curada, enquanto um agente em grande parte estático pode trabalhar com um ritmo mais lento. Em todos os casos, faça um snapshot extra antes de importações em massa, mudanças de modelo, mudanças de esquema de ferramentas ou revisões de permissão.

Um índice vetorial é suficiente como backup? Não. Um índice é um produto derivado que pode ser reconstruído a partir das suas entradas. Faça backup dos documentos de origem, dos registros de memória com sua procedência e da configuração de recuperação que transforma tudo isso em índice. Manter uma cópia do índice pode reduzir o tempo de recuperação, mas ele nunca deve ser o único registro do que o agente sabe.

Quem deve poder restaurar a memória de um agente? As pessoas que podem restaurar devem formar um grupo pequeno e nomeado, separado de quem apenas lê o backup. Uma restauração no ambiente de teste pode ser feita por um operador, enquanto uma restauração em produção deve exigir aprovação do responsável. Registre cada restauração no registro de alterações para que a empresa possa explicar depois o que mudou.

E se uma restauração trouxer de volta informações erradas? Primeiro confirme se o erro já existia quando o snapshot foi tirado, usando o registro de alterações e os campos de procedência. Se existia, esse snapshot é a escolha errada, então restaure uma versão anterior e corrija o registro pelo processo de revisão normal. Se o erro apareceu depois, corrija ou expire o item na memória atual e tire um snapshot novo quando a correção for aprovada.

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 →