Sistemas legados carregam décadas de regra, mesmo quando sua interface ou documentação parece antiga. Entregar ao agente um usuário de banco ou acesso remoto genérico parece contornar a falta de API, mas transfere toda a complexidade para um ponto com autoridade demais.
Uma integração segura cria uma fronteira: dentro da rede, um componente conhece o legado; para fora, publica somente operações de negócio nomeadas, parametrizadas e observáveis.
Em uma frase
A ausência de API não justifica acesso irrestrito: transforme necessidades específicas em contratos estreitos dentro da fronteira privada.
Por que SQL livre é uma abstração perigosa
Uma tabela raramente representa toda a regra. Atualizar status pode exigir histórico, estoque, validação fiscal e evento para outro sistema. Uma instrução aparentemente correta pode quebrar invariantes ou não acionar processos dependentes. Mesmo consultas podem expor colunas e empresas além do necessário.
O risco aumenta quando o modelo monta consulta. Prompt injection, ambiguidade ou mudança de esquema encontra uma linguagem expressiva demais. O agente precisa pedir “consultar ordem autorizada”, não decidir como navegar por todas as tabelas.
Menor privilégio vale também para tokens e conectores
A RFC 9700 recomenda limitar privilégios de tokens ao mínimo e restringir a audiência ao recurso de destino, reduzindo impacto de vazamento. O princípio se aplica mesmo quando o legado não usa OAuth: credencial e operação devem alcançar apenas o necessário.
A OpenAPI mostra o valor de um contrato compreensível por pessoas e máquinas. Um gateway pode criar contrato semelhante sobre procedure, fila ou serviço interno, sem expor o mecanismo subjacente ao agente.
Exemplo composto: consultar e bloquear um lote
Um WMS fictício não possui API. O gateway roda dentro da rede e publica duas operações: consultar lote por código e solicitar bloqueio com motivo permitido. A consulta usa visão restrita; o bloqueio chama uma procedure aprovada que preserva as regras existentes. Não existe endpoint “executar SQL”.
O agente envia parâmetros validados depois da permissão. A ação de bloqueio pede aprovação conforme perfil e devolve o identificador do WMS. Logs técnicos ficam no gateway; a evidência de negócio liga solicitante, lote, motivo, aprovação e resultado. O exemplo é ilustrativo.
O contrato mínimo do gateway privado
Cada operação precisa de nome de negócio, descrição, parâmetros tipados, validações, tempo limite, política de repetição, retorno e classificação de consequência. O gateway inicia conexão de saída quando possível, autentica a plataforma e mantém credenciais do legado dentro da rede.
Use lista permitida de operações, não endereços ou consultas recebidos por texto. Separe ambientes e empresas, limite recursos, registre versão e monitore saúde. Se o gateway não confirma requisito essencial, a execução deve parar de forma explícita.
Antes de publicar uma operação do legado
- Existe método oficial — API, procedure, fila ou serviço — que preserva regra de negócio?
- A credencial acessa somente objetos, empresa e ações necessários?
- Entradas são tipadas, limitadas e independentes de SQL, código ou URL livre?
- O retorno confirma estado real e traz identificador para reconciliação?
- Atualização, revogação, monitoramento e contingência têm responsável?
Como a Uiless ajuda
O gateway privado da Uiless conecta serviços dentro da rede e publica somente operações nomeadas. A plataforma chama essas ferramentas depois de validar empresa, pessoa, permissão e aprovação. Segredos permanecem no servidor e o modelo nunca recebe SQL livre.
Isso permite colocar uma experiência moderna sobre legado sem abrir a infraestrutura nem reescrever o sistema inteiro. A equipe começa pelas capacidades de maior valor e mantém uma fronteira clara para evoluir depois.
Compare opções em API, RPA ou integração direta e veja a visão ampla em automatizar sem trocar o ERP.
