Backup e restauração de agente de IA: o que salvar e como testar

Para fazer o backup de um agente de IA, salve tudo o que define como ele se comporta e o que ele sabe, não o modelo em si. Isso inclui configuração, instruções, memória, skills, definições de ferramentas e referências a credenciais. Depois, comprove que o backup funciona: restaure-o em um ambiente limpo e confira se o agente se comporta como antes. Um backup que nunca foi restaurado é apenas uma esperança.

Principais pontos

• O modelo geralmente é alugado. O que você precisa proteger é a camada ao redor dele: configuração, memória, skills, conexões com ferramentas e permissões.
• Faça backup das referências às credenciais (o que existe, quem é o responsável, o que ela permite, como reemiti-la), nunca dos segredos em si.
• A memória tem dois tipos de conteúdo: o que pode ser reconstruído a partir dos documentos de origem e o que só existe porque o agente aprendeu ou registrou. Priorize o segundo tipo.
• Inclua no backup um pequeno conjunto de casos de teste, para medir se o agente restaurado se comporta corretamente.
• Faça um exercício de restauração com periodicidade definida e após mudanças importantes, em um ambiente separado, com uma pessoa nomeada como responsável pelo resultado.

Do que um agente de IA é feito e o que é seu para salvar?

A maioria dos agentes empresariais é montada a partir de partes. Um provedor de modelo fornece o raciocínio. Todo o resto é específico da sua empresa e fica em algum lugar que você precisa conseguir acessar: as instruções que definem o papel, a memória que o agente foi construindo, as skills que ele segue, as ferramentas que ele pode acionar e as contas que ele usa para agir.

Ajuda separar essas partes pela dificuldade de recriá-las:

• Fáceis de recriar: o próprio modelo, bibliotecas de uso geral, a plataforma de hospedagem.
• Caras de recriar: instruções de papel refinadas ao longo de meses, skills ajustadas com casos reais, definições de ferramentas que correspondem aos seus sistemas.
• Impossíveis de recriar a partir de fora: a memória acumulada pelo agente, as decisões sobre o que ele pode fazer sem aprovação, o histórico do motivo pelo qual cada regra existe.

O segundo e o terceiro grupos formam o escopo do seu backup. Para ter uma visão mais ampla de como essas partes se encaixam, as sete camadas da infraestrutura de IA empresarial oferecem um mapa útil.

Um ponto a mais antes das listas. O backup é um plano para falhas diferentes: uma configuração apagada, uma atualização ruim, uma conta comprometida, uma queda do provedor, uma mudança para outra hospedagem. O mesmo backup precisa servir a todas elas, e é por isso que o teste de restauração importa mais do que o backup em si.

Quais configurações você deve salvar?

A configuração é a parte que as pessoas mais costumam considerar segura por estar "na plataforma". Pode estar, até a plataforma mudar, um administrador sair da empresa ou uma opção ser sobrescrita por engano. Exporte a configuração para uma forma legível e versionada, que você controle.

Um bom backup de configuração inclui:

• A definição do papel e as instruções de sistema, completas, com a data e o autor da última alteração.
• Os modelos e parâmetros que o agente usa, incluindo qualquer modelo de reserva.
• As configurações de canais: quais caixas de entrada, espaços de chat ou formulários o agente acompanha e em quais ele responde.
• As regras de permissão e aprovação: o que o agente pode fazer sozinho, o que exige uma pessoa e quem é essa pessoa.
• Agendamentos e gatilhos para trabalhos recorrentes ou acionados por eventos.
• Os nomes das variáveis de ambiente e das configurações que o agente espera, sem os valores secretos.
• Um registro curto de mudanças que explique por que as configurações importantes são como são.

O registro de mudanças é subestimado. Um agente restaurado com as configurações certas, mas sem explicação, convida alguém a "corrigir" uma regra que foi criada depois de um incidente. Combine isso com um processo disciplinado de atualização (alterar um agente em produção com cuidado, sem quebrar o que já funciona) e cada versão da configuração passa a ser um ponto de restauração que você consegue nomear.

Como fazer backup da memória e do conhecimento do agente?

É na memória que o backup fica sutil, porque a palavra cobre coisas diferentes. Trate cada uma separadamente.

• Estado de trabalho: anotações que o agente mantém para continuar uma tarefa entre sessões, como arquivos de progresso ou listas de tarefas. Projetos de agentes de longa duração dependem desse tipo de passagem de bastão entre sessões, como a Anthropic descreve em seu artigo sobre estruturas eficazes para agentes de longa duração (effective harnesses for long-running agents). Perder esse estado significa perder o fio do trabalho inacabado.
• Memória de longo prazo: fatos, preferências e correções que o agente registrou sobre a empresa, os clientes ou os processos. Costuma ser o conteúdo mais valioso e menos reproduzível.
• Fontes de conhecimento: os documentos, wikis e registros de onde o agente busca informação. Os arquivos originais normalmente ficam nos seus próprios sistemas.
• Índices derivados: a representação pesquisável construída a partir dessas fontes. Em geral pode ser reconstruída, embora a reconstrução leve tempo.
• Histórico de conversas e ações: útil para auditoria e para diagnosticar problemas, mas sujeito a decisões de retenção.

A regra prática: faça backup da memória de longo prazo e do estado de trabalho em uma exportação legível, faça backup dos documentos de origem e das configurações usadas para ingeri-los, e trate o índice como opcional, a menos que reconstruí-lo leve mais tempo do que o negócio consegue tolerar. Para cada item, registre quem pode lê-lo.

Há uma consequência de privacidade. Um backup de memória contém dados da empresa e, às vezes, dados pessoais. Ele exige os mesmos controles de acesso do sistema em produção e deve ficar em um local compatível com suas obrigações. O guia sobre residência de dados em IA para empresas mostra como pensar sobre onde esses dados podem ficar. Decida também por quanto tempo o histórico é mantido, porque um backup que guarda tudo para sempre pode virar um passivo.

E as skills, as ferramentas e os fluxos de trabalho?

Skills são os procedimentos escritos que o agente segue: como triar uma solicitação, como preparar um resumo semanal, como conferir uma nota fiscal com o pedido de compra. Ferramentas são as conexões que permitem ao agente agir nos sistemas. Ambas registram como a sua empresa trabalha, e ambas merecem backup.

Salve o seguinte:

• Cada skill ou procedimento em texto simples, com seu gatilho e o resultado esperado.
• As definições de ferramentas: nomes, descrições, formatos de entrada e saída e o escopo que cada ferramenta pode tocar. Descrições claras de ferramentas influenciam muito o comportamento do agente, e por isso vale ler a orientação da Anthropic sobre como escrever ferramentas eficazes para agentes (writing effective tools for agents) antes de reescrever uma de memória.
• As configurações dos conectores, incluindo para qual endpoint ou servidor cada ferramenta aponta. Se você usa o Model Context Protocol, registre quais servidores estão conectados e o que cada um expõe. A introdução ao protocolo, na documentação oficial, explica o modelo.
• As definições de fluxos que encadeiam várias etapas, incluindo os pontos de aprovação.
• Um conjunto de casos de teste: entradas realistas com o resultado que você considera correto, incluindo alguns em que a resposta certa é recusar ou escalar para uma pessoa.

Esse último item transforma o backup de um monte de arquivos em algo verificável. Sem casos de teste, "o agente restaurado parece estar bem" é uma opinião. Com eles, é um resultado. Se você ainda não escreveu esses casos, definir critérios de sucesso para um piloto é um bom ponto de partida.

Como tratar credenciais sem guardar segredos no backup?

O backup mais seguro de um segredo é nenhuma cópia. Chaves de API, senhas e tokens pertencem a um cofre de segredos dedicado, com controles de acesso e processo de recuperação próprios. O que o backup do agente deve guardar é um inventário de referências.

Para cada credencial que o agente usa, registre:

• Para que ela serve e a qual sistema se conecta.
• A qual conta pertence e qual pessoa ou equipe é responsável por essa conta.
• O escopo que ela concede, descrito com a maior precisão possível, para que você confirme que a substituta não é mais ampla.
• Onde o segredo está guardado e quem pode recuperá-lo.
• Como rotacioná-la ou reemiti-la e como revogar a antiga.

Dois detalhes importam na hora de restaurar. Primeiro, tokens de autorização emitidos via OAuth costumam estar atrelados a uma concessão específica e, em geral, não devem ser simplesmente copiados para um novo ambiente. Planeje reautorizar e saiba quem tem autoridade para aprovar o consentimento. A visão geral do OAuth 2.0 do Google descreve como funcionam essas concessões e os tokens de atualização. Segundo, um agente restaurado não pode voltar com mais permissões do que tinha. Revise o acesso restaurado segundo o princípio do menor privilégio, como descrito na orientação de autorização do OWASP (Authorization Cheat Sheet).

Tudo isso fica bem mais fácil quando o agente tem identidade e contas próprias, em vez de usar o login de um funcionário. O texto por que o agente de IA da empresa precisa de identidade e contas próprias explica o raciocínio. Também fica mais fácil quando a empresa, e não o fornecedor, é dona das contas e das chaves do modelo, ponto tratado em de quem devem ser as contas e chaves de API do agente de IA.

Como testar uma restauração, passo a passo?

Um teste de restauração responde a uma pergunta: se o agente em produção desaparecesse hoje, teríamos um equivalente funcionando e em quanto tempo? Faça-o em um ambiente separado, para não tocar em nada da produção.

• Defina um responsável e um objetivo. Decida quem conduz o exercício, quem julga o resultado e qual falha você está simulando (perda da hospedagem, atualização ruim, conta comprometida).
• Escolha o ponto de restauração. Use uma versão específica do backup, não "a mais recente", para descobrir também se as versões estão identificadas com clareza.
• Prepare um ambiente limpo, sem nada herdado do agente em produção. Se a restauração só funciona por causa de um estado residual, é melhor descobrir isso agora.
• Restaure primeiro a configuração, depois as skills e as ferramentas, depois a memória e as fontes de conhecimento. Anote cada etapa em que alguém precisou adivinhar ou perguntar.
• Reemita as credenciais a partir do inventário, seguindo o procedimento documentado. Confirme que cada nova credencial tem o escopo pretendido e nada além.
• Reconstrua os índices derivados, se não houve backup deles, e registre quanto tempo isso leva.
• Execute os casos de teste salvos. Compare o comportamento com o esperado, principalmente recusas, escalonamentos e etapas de aprovação.
• Verifique os limites. Confirme que o agente restaurado não alcança sistemas ou dados que não deveria e que as aprovações continuam chegando às pessoas certas.
• Registre o tempo gasto, as falhas encontradas e as correções. Atualize o escopo do backup e o procedimento escrito antes de encerrar o exercício.
• Desative o ambiente de teste e revogue qualquer acesso temporário criado para ele.

Um cenário ilustrativo: uma equipe financeira usa um agente que redige lembretes de pagamento e sinaliza notas fiscais incomuns para revisão. Durante o exercício, a equipe restaura a configuração e as skills sem problemas, mas o agente redige os lembretes no tom errado. A causa é uma correção registrada na memória de longo prazo meses antes, que o backup havia ignorado por se supor que ela poderia ser reconstruída a partir dos documentos. A solução é pequena: incluir a exportação da memória no escopo do backup. A descoberta é o objetivo do exercício, e ela aconteceu num teste, não numa indisponibilidade real.

Repita o exercício com periodicidade definida e após qualquer mudança importante no papel, nas ferramentas ou na hospedagem do agente. Cada rodada deve ser mais curta e menos surpreendente que a anterior.

Como a Be Human trata backup e restauração?

A Be Human trata backup e restauração como parte da operação do agente, não como um projeto separado. Ao longo de um projeto, a configuração, as skills, as definições de ferramentas, a memória e os limites de aprovação do agente são documentados como parte do contexto operacional dele, e as credenciais são acompanhadas como referências com responsáveis nomeados, sem serem copiadas para o backup. A operação gerenciada pode incluir verificações periódicas de restauração, revisão de permissões após uma restauração e mudanças controladas, com histórico de versões registrado. A empresa mantém o controle das contas e dos dados, de modo que uma restauração nunca dependa de uma única pessoa nem apenas da Be Human. Para entender quem faz o quê nesse trabalho recorrente, veja o modelo de responsabilidade compartilhada em agentes de IA e, para o lado da portabilidade, como evitar dependência de fornecedor de IA em agentes.

Perguntas frequentes

Preciso fazer backup do próprio modelo de IA? Na maioria dos cenários empresariais, não. O modelo é fornecido por um provedor e pode ser acessado de novo ou substituído. O que você precisa salvar é tudo o que torna o agente seu: instruções, memória, skills, definições de ferramentas e regras de permissão. Registre qual modelo e qual versão o agente usava, para poder reproduzir o comportamento ou comparar com um substituto.

Com que frequência fazer o backup de um agente de IA? Ajuste a frequência à velocidade com que cada parte muda. Configuração e skills devem ser salvas sempre que mudarem, como parte do processo de atualização. A memória que cresce todos os dias merece uma exportação automática regular, enquanto os documentos de origem normalmente já estão protegidos pelos backups habituais de arquivos. Pergunte quanto aprendizado recente você aceitaria perder e defina a periodicidade a partir dessa resposta.

Posso guardar chaves de API e senhas no backup? Evite. Mantenha os segredos em um cofre dedicado e coloque no backup do agente apenas um inventário de referências: para que serve cada credencial, quem é o responsável, qual o escopo e como reemiti-la. Assim o backup pode ser compartilhado com segurança com quem precisa dele, e a rotação após um incidente fica muito mais simples.

Como saber se a restauração realmente funcionou? Execute os casos de teste salvos no agente restaurado e compare os resultados com o esperado, incluindo os casos em que ele deve recusar ou pedir aprovação. Verifique também se as permissões correspondem às do original e se ele se conecta apenas aos sistemas que deveria. Se uma pessoa que não construiu o agente consegue concluir a restauração seguindo o procedimento escrito, o backup está em boa forma.

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