Infraestrutura de IA personalizada
Agentes de IA com sistemas legados: conecte sem reconstruir tudo
Como usar um conector controlado na frente do sistema legado para dar a agentes de IA acesso útil e limitado, sem reconstruir tudo do zero.

Agentes de IA podem trabalhar com sistemas legados sem reconstrução completa quando um conector fino e controlado fica entre o agente e o sistema de registro antigo. O conector expõe um conjunto pequeno de operações nomeadas, como consultar o status de um pedido ou preparar uma alteração para aprovação, e aplica as permissões, limites e registros que a empresa define. O sistema antigo continua fazendo bem o que já faz, e o agente recebe apenas o acesso que o seu papel exige.
Principais pontos
- Mantenha o sistema de registro onde ele está e coloque um conector na frente dele.
- Exponha poucas operações nomeadas, nunca acesso direto ao banco de dados nem automação de tela por padrão.
- Dê a cada operação sua própria permissão, limite de aprovação e entrada no registro.
- Construa e teste as operações de leitura antes das de escrita, e as de escrita antes de qualquer ação autônoma.
- Revise o acesso em uma agenda fixa, porque sistemas legados mudam devagar e muitas vezes sem aviso.
Por que sistemas legados travam agentes e por que a reconstrução costuma ser o primeiro passo errado
Os sistemas empresariais mais antigos guardam os registros em que a equipe confia: pedidos, notas fiscais, histórico de clientes, saldos de estoque. O problema é o acesso. O software pode não ter interface moderna, os arquivos de exportação chegam em lotes, o fornecedor pode ter deixado de atualizá-lo, e o único caminho prático até os dados pode ser a tela que uma pessoa usa todos os dias. Diante disso, a liderança costuma propor um projeto de substituição. Só que uma reconstrução leva tempo, mistura migração de dados com novos comportamentos e deixa a empresa sem o registro antigo durante a transição.
Um agente não precisa que o sistema inteiro seja moderno. Ele precisa de uma visão limitada de registros específicos e de um jeito de pedir um pequeno número de ações. É um problema mais estreito, e pode ser resolvido na frente do sistema que já existe.
O que um conector controlado faz, na prática
Um conector é um pequeno serviço que recebe uma solicitação do agente, verifica se ela é permitida, traduz a solicitação para a linguagem do sistema legado, executa a chamada e devolve um resultado reduzido. Ele também registra o que aconteceu. Na prática, cumpre quatro funções: valida as entradas, aplica autorização em cada solicitação, limita a quantidade de dados e de chamadas que passam por ele e grava uma entrada de registro que uma pessoa consegue ler depois.
O Model Context Protocol oferece uma forma comum de descrever ferramentas ao agente em um formato consistente, o que facilita revisar as operações do conector. A descrição importa menos que a regra por trás dela. A orientação de autorização da OWASP recomenda negar o acesso por padrão e verificar a permissão em cada solicitação, e não uma única vez quando a sessão começa. Aplique essa regra a cada operação exposta pelo conector.
Como colocar um conector na frente de um sistema antigo, passo a passo
O trabalho fica mais fácil de controlar quando segue uma sequência. Os passos abaixo partem do princípio de que uma equipe é responsável pelo sistema legado e um dono de negócio responde pelo resultado.
- Defina o único papel que o agente vai desempenhar e a decisão ou tarefa que esse papel apoia.
- Liste os registros e campos que esse papel precisa e marque os que ele nunca deve ver, como dados de pagamento ou dados pessoais fora da finalidade.
- Escreva cada operação como uma função nomeada, com entradas e saída definidas e uma mensagem de falha clara.
- Construa primeiro as operações de leitura e compare os resultados com a tela do sistema legado, usando uma amostra de registros que uma pessoa já conferiu.
- Adicione operações de escrita somente atrás de uma etapa de aprovação que uma pessoa nomeada possa aceitar ou recusar.
- Defina um limite de volume e um tempo máximo de resposta para cada operação, para que um laço com defeito não sobrecarregue o sistema antigo.
- Registre cada chamada com o solicitante, as entradas, o resultado e o horário, para que um incidente possa ser reconstruído depois.
- Escreva o critério de sucesso em termos simples antes do primeiro uso real, por exemplo: o agente responde corretamente às perguntas de status nos casos que um supervisor conferiu.
Cenário ilustrativo: um distribuidor opera sua gestão de pedidos em um software mais antigo que a maior parte da equipe atual. O time de atendimento quer um agente que responda perguntas sobre entregas sem interromper uma pessoa. O conector expõe uma única operação de leitura, que devolve o status, a data prevista e a última atualização de um número de pedido. Ele não enxerga preços nem dados bancários e não consegue alterar nada. Só depois que a versão de leitura roda sem problemas por um tempo, a equipe considera uma segunda operação, que inclui uma observação de entrega, e essa observação passa antes por uma aprovação humana.
Leitura primeiro, escrita depois
O valor costuma começar nas leituras, que carregam muito menos risco. As escritas exigem mais cuidado, porque sistemas legados costumam não ter as proteções que as plataformas modernas oferecem. Uma solicitação repetida pode criar um pedido duplicado. Um tempo esgotado pode deixar um registro atualizado pela metade. A documentação da Stripe sobre requisições idempotentes mostra o padrão que os provedores modernos usam: quem chama envia uma chave única, e o servidor devolve o resultado original se a mesma solicitação chegar de novo. Muitos sistemas antigos não oferecem nada parecido, então o conector precisa fornecer essa proteção por conta própria, com uma chave de solicitação guardada no seu próprio registro e verificada antes de qualquer escrita ser enviada.
Para cada escrita, decida quem aprova, quais informações o aprovador vê e o que acontece se ninguém responder. Mudanças no que um agente pode fazer também devem seguir um processo escrito. O guia sobre limites de aprovação humana para mudanças em agentes de IA descreve um formato prático para isso.
Como saber se o conector está funcionando?
Um conector precisa de evidências, e não apenas de uma demonstração bem-sucedida. Acompanhe as operações chamadas, o número de solicitações recusadas pela verificação de permissão, as falhas devolvidas pelo sistema legado, os tempos de resposta e as aprovações concedidas ou recusadas por cada pessoa. O material introdutório de observabilidade da OpenTelemetry descreve as categorias básicas, traces, logs e métricas, que tornam esse acompanhamento possível entre serviços. No início, você não precisa de um painel elaborado. Precisa de uma visão semanal que um gestor consiga ler em poucos minutos.
Teste também as respostas do agente com casos cujo resultado correto é conhecido. O guia de evals da OpenAI descreve a prática geral de escrever esses testes, e a nota da Anthropic sobre como desmistificar evals para agentes explica por que um conjunto pequeno e bem escolhido de casos é mais útil que um conjunto grande e vago. Mantenha o conjunto de testes junto do conector e execute-o novamente sempre que o sistema legado ou as instruções do agente mudarem.
O que pode dar errado com textos que o agente lê?
Um agente que lê e-mails, chamados ou documentos de clientes vai encontrar textos escritos por pessoas que podem querer manipulá-lo. Uma mensagem pode conter uma instrução, por exemplo pedindo que o agente revele dados ou execute uma ação fora do seu papel. As orientações da OWASP sobre prevenção de prompt injection e o OWASP Top 10 para aplicações com LLM tratam isso como um risco central. A defesa é arquitetural. O conector nunca deve tratar a saída do modelo como prova de permissão. Cada solicitação precisa ser verificada contra o papel, a operação e o registro, usando uma identidade limitada à tarefa, e não uma conta de serviço ampla com acesso a tudo.
Daí sai uma regra prática: se uma operação causar dano quando chamada por alguém que não deveria chamá-la, ela precisa de verificação de permissão e, no caso de escritas, de uma etapa de aprovação humana, independentemente de como o pedido foi formulado.
Por onde começar e como uma abordagem gerenciada ajuda
A Be Human projeta e opera infraestrutura de IA personalizada, na qual os agentes mantêm identidade, memória, canais, ferramentas, permissões e contexto operacional sob controle humano. Uma primeira etapa define um papel útil, a memória e as ferramentas que esse papel precisa, os limites de aprovação e um critério de sucesso observável. Depois, a operação gerenciada pode cobrir monitoramento, avaliações recorrentes, manutenção das integrações, revisão de permissões, resposta a incidentes e melhorias controladas. Isso importa para um conector, porque o sistema legado vai mudar e o conector precisará acompanhar essa mudança. Equipes que querem ver como as camadas se encaixam podem usar o mapa das camadas de infraestrutura de IA para líderes como ponto de partida para essa conversa.
Se você quer identificar a primeira tarefa que vale entregar a um agente, o diagnóstico gratuito de IA da Be Human é um bom lugar para começar.
Perguntas frequentes
Precisamos substituir o sistema legado antes que um agente possa usá-lo? Não. Na maioria dos casos, o sistema de registro continua onde está, e um conector oferece ao agente uma visão estreita e controlada dele. A substituição pode fazer sentido por outros motivos, mas não deve ser pré-requisito para o primeiro agente útil.
É seguro conectar um agente a um sistema antigo com registros fracos? Pode ser, desde que o conector acrescente os registros, as verificações de permissão e os limites de volume que o sistema antigo não tem. Comece com operações somente de leitura, para que um erro não consiga alterar nenhum registro enquanto os logs e testes amadurecem.
Quem deve aprovar as ações de escrita feitas por um agente? Uma pessoa nomeada que responda pelo resultado, normalmente o gestor do processo afetado pela escrita. O aprovador deve ver a alteração proposta, o motivo e a origem da solicitação, e o sistema deve registrar a decisão.
Como saber se o conector está gerando valor? Defina um critério de sucesso antes do lançamento, como o agente responder corretamente a um conjunto definido de perguntas, em casos que um supervisor conferiu. Depois, revise os logs, as falhas e os resultados dos testes em uma agenda regular, e mantenha o conector apenas onde as evidências mostrarem que ele ajuda.
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.


