Integrar agentes de IA a sistemas legados sem reescrever tudo

Você normalmente não precisa reescrever um sistema antigo antes de um agente de IA conseguir trabalhar com ele. Três padrões estreitos cobrem a maioria dos casos: uma ponte somente leitura, que permite ao agente consultar dados ao vivo, uma exportação agendada, que lhe entrega uma cópia controlada, e um ponto de escrita limitado a poucas ações, validadas e registradas. O sistema de registro continua onde está, e o agente nunca recebe mais alcance do que a tarefa exige.

Principais pontos

• Reescrever raramente é o primeiro passo certo. Comece pela interface mais simples que o sistema existente já oferece.
• O acesso somente leitura deve ser o padrão, com exportações usadas quando as consultas ao vivo são lentas, frágeis ou indisponíveis.
• A escrita funciona melhor como poucas ações nomeadas, com validação, idempotência e regra de aprovação humana para tudo que movimenta dinheiro, contata clientes ou altera registros fiscais ou legais.
• Cada ponte precisa de um responsável, de um registro do que o agente leu ou escreveu e de uma forma de desligá-la sem tocar no sistema legado.

Por que reescrever costuma ser o primeiro passo errado

Substituir um sistema antigo é um projeto com cronograma, orçamento e riscos próprios. Uma empresa que quer um agente para ajudar com dúvidas de pedidos, consulta de estoque ou papelada administrativa raramente precisa que a substituição aconteça antes. Ela precisa de um jeito controlado de ler o que o sistema antigo sabe e, para um conjunto pequeno de tarefas, registrar um resultado nele. Uma reescrita também move os registros, o que significa que o projeto do agente herda todos os problemas de migração de dados antes de mostrar qualquer valor.

Uma ponte mantém o registro onde ele está. O sistema legado continua sendo a fonte da verdade, a equipe que conhece suas particularidades segue trabalhando nele, e o agente opera por uma porta estreita. Se essa porta acabar com o tamanho errado, você a ajusta sem reconstruir o sistema inteiro.

Três padrões para trabalhar com um sistema antigo

Dê nome ao padrão antes de construir qualquer coisa, porque cada um carrega riscos diferentes.

• Ponte somente leitura: o agente consulta o sistema por meio de uma view do banco de dados, um endpoint de relatórios ou uma API do fornecedor com permissões apenas de leitura. Ele pode responder perguntas e preparar rascunhos, mas não pode alterar um registro.
• Tarefa de exportação: um processo agendado copia um conjunto definido de registros para um armazenamento separado, como um arquivo, uma tabela ou um índice de documentos. O agente trabalha a partir da cópia, o que protege o sistema ao vivo da carga e de edições acidentais.
• Ponto de escrita estreito: uma ação pequena e documentada, como anexar uma nota a um chamado ou criar uma linha de rascunho de pedido, que o agente pode acionar. Ele aceita apenas os campos que você listou, verifica-os antes de chegarem ao sistema e registra quem ou o que pediu a alteração.

As exportações têm um problema de atualidade. Uma cópia feita durante a madrugada não reflete um cancelamento feito ao meio-dia, então o agente deve informar o horário dos dados que usou. As pontes somente leitura evitam essa defasagem, mas dependem de o sistema legado suportar consultas sem desacelerar as pessoas que o usam. Os pontos de escrita estreitos são os mais úteis e os mais perigosos dos três, e por isso devem ser o último padrão a entrar, não o primeiro.

Qual padrão serve para cada tarefa?

Não escolha um único padrão para o sistema inteiro. Decida tarefa por tarefa, usando estas perguntas.

• O agente só precisa responder uma pergunta ou preparar um resumo? Use uma ponte somente leitura ou uma exportação.
• A resposta pode ter algumas horas de idade? Normalmente uma exportação basta, e ela pesa menos no sistema ao vivo.
• A tarefa precisa do status atual, como o estoque disponível neste momento? Use uma consulta somente leitura com tempo limite e uma mensagem clara de contingência.
• A tarefa cria ou altera um registro? Desenhe uma ação de escrita estreita, com campos, limites e regra de aprovação escritos antes de qualquer código.
• Um registro errado seria difícil de desfazer, ou chegaria a um cliente, fornecedor ou órgão regulador? Mantenha uma pessoa na etapa de aprovação, mesmo que o agente prepare a alteração.

As respostas costumam apontar um padrão por tarefa, e um mesmo sistema legado acaba atendendo aos três. Isso é normal. O objetivo é um conjunto de caminhos separados, cada um com interruptor próprio, e não uma conexão ampla.

Construa a ponte somente leitura e a exportação

A maior parte do trabalho aqui é de definição, não de código. Antes de conectar qualquer coisa, escreva o que o agente pode ver e por quê.

• Formule em uma frase a pergunta de negócio que a ponte precisa responder.
• Liste as tabelas, relatórios ou endpoints exatos necessários e deixe de fora todo o resto, incluindo dados pessoais que a tarefa não usa.
• Crie uma credencial que pertença ao agente, e não a um funcionário, e conceda apenas as permissões de leitura da lista. As diretrizes de autorização da OWASP são uma boa referência para separar quem pode agir do que pode ver.
• Para exportações, defina a agenda, o formato do arquivo ou da tabela, por quanto tempo as cópias são mantidas e quem pode excluí-las.
• Marque cada resposta com o horário em que os dados foram lidos ou exportados, para que quem lê possa avaliar a atualidade.
• Teste com registros que você conhece bem e compare a resposta do agente com o que um funcionário vê na tela que costuma usar.

Para um aprofundamento no caso de banco de dados, veja como conectar um agente de IA ao banco de dados só com leitura.

Mantenha a escrita estreita

Um ponto de escrita é um produto pequeno, e merece a mesma disciplina de uma API usada por desenvolvedores externos. As orientações da Anthropic sobre como escrever ferramentas para agentes apontam na mesma direção: nomes claros, entradas restritas e resultados previsíveis importam mais que amplitude. Mantenha a lista curta o bastante para que uma pessoa a revise em uma única sentada.

• Cada ação faz uma coisa só, como adicionar uma nota a um caso ou criar um orçamento em rascunho. Evite qualquer chamada geral de atualização.
• As entradas são validadas segundo as regras do próprio sistema legado antes do envio, e pedidos recusados devolvem um motivo simples.
• Cada envio carrega uma chave única, para que uma nova tentativa após um tempo limite não crie um segundo registro. Provedores de pagamento como o Stripe documentam essa abordagem para requisições repetidas. A mesma ideia vale para um ajuste de estoque ou uma nota de caso, como explica o guia sobre como evitar ações duplicadas em IA.
• A ação grava um registro com a requisição, quem a pediu, o horário e o resultado.
• Ações que movimentam dinheiro, contatam pessoas de fora da empresa ou alteram registros fiscais ou legais exigem que uma pessoa identificada aprove cada mudança.
• O agente não pode ampliar as próprias permissões nem acrescentar ações. Mudanças na lista de endpoints passam pela mesma revisão de qualquer outra mudança de sistema.

Registros legados costumam conter texto livre digitado por pessoas ou importado de formulários, e esse texto pode incluir instruções que o agente não deveria seguir. Trate o conteúdo dos registros como dado, nunca como comando. As orientações da OWASP sobre prevenção de injeção de prompt descrevem esse risco e os controles que o reduzem.

Teste, monitore e faça a passagem

Cenário ilustrativo: um distribuidor regional guarda estoque e histórico de pedidos em um programa de gestão que roda há muitos anos e oferece apenas uma exportação básica. Os gerentes de contas querem um agente que responda sobre disponibilidade e prepare rascunhos de pedidos de reposição.

A equipe começa com uma exportação noturna, para que o agente responda sobre o histórico de pedidos sem tocar no sistema ao vivo. Depois acrescenta uma consulta somente leitura para o estoque atual, com tempo limite e uma mensagem que informa quando a checagem ao vivo falhou. Só depois de várias semanas de respostas registradas, revisadas pela equipe de contas, considera um endpoint para rascunhos de pedido. Esses rascunhos só entram no sistema legado depois que um gerente de contas os aprova. Cada etapa tem interruptor próprio, então um problema em um caminho não para os outros.

Antes de qualquer ponte entrar em produção, confira-a com uma lista de aceitação escrita, como a de checklist para aceitar uma integração de agente de IA. Depois do lançamento, observe os sinais que importam: exportações que falham, carimbos de data desatualizados, escritas recusadas e aprovações que demoram a chegar a uma pessoa.

A Be Human segue esta mesma ordem. A primeira etapa define um papel útil, a memória e as ferramentas de que ele precisa, os limites de aprovação e um critério de sucesso observável. A operação gerenciada depois cobre o monitoramento das pontes, avaliações recorrentes das respostas do agente, manutenção quando o sistema legado muda sua interface, revisões de permissões e resposta a incidentes quando uma credencial ou uma exportação falha. O agente mantém sua identidade, sua memória e seu contexto operacional sob controle da empresa, e os registros legados permanecem onde a empresa os guarda.

Se você não tem certeza de qual sistema ou tarefa começar, o diagnóstico gratuito de IA da Be Human pode ajudar a encontrar a primeira tarefa que vale entregar a um agente.

Perguntas frequentes

Um agente de IA consegue trabalhar com um sistema legado que não tem API? Sim, mas o caminho muda. Views do banco de dados, relatórios agendados ou exportações de arquivos podem servir como fontes somente leitura mesmo sem uma interface moderna. Quando nada disso existe, uma conexão via navegador pode ser possível, mas ela é mais frágil e exige controles mais rígidos, por isso verifique o que existe antes de escolher um padrão.

Preciso mover meus dados para um sistema novo antes de um agente conseguir ajudar? Não. O padrão de ponte existe para que o sistema legado possa continuar sendo o registro da verdade. Migrar dados é uma decisão separada, com justificativa própria, e um projeto de agente não deve depender de uma migração para começar a gerar valor.

Uma cópia dos dados é segura para o agente usar? Uma cópia pode ser segura quando contém apenas os campos que a tarefa precisa, é armazenada com acesso restrito e é excluída em um cronograma definido. Os principais riscos são informação desatualizada e dados pessoais saindo da finalidade original. Marque cada resposta com o horário em que a cópia foi feita.

Quem deve aprovar a primeira ação de escrita? Alguém que seja responsável pelo resultado do negócio e entenda o registro legado, normalmente um líder de operações trabalhando com quem mantém o sistema. A aprovação deve ser registrada para cada ação ou para uma classe definida de ações. Revise o registro após as primeiras semanas e, então, restrinja ou amplie a regra conforme o que você observar.

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