Durante a janela de migração, um AI Server pode atender ambas as gerações simultaneamente: aplicativos modernos do AI Suite e ferramentas compatíveis com OpenAI na porta primária chaveada, governada e medida, e clientes pré-v2 que utilizam o protocolo local-AI legado em um listener de compatibilidade dedicado na porta clássica <a href="#ref-1">[1]</a>. Esse listener é habilitado deliberadamente, com escopo restrito apenas à superfície legada, e possui uma data de desativação compilada após a qual se recusa a se vincular.
Sem dia de bandeira
Como os sites atualizam gradualmente, o listener de compatibilidade mantém as integrações antigas funcionando inalteradas enquanto tudo o que é novo chega na porta primária governada <a href="#ref-1">[1]</a>. A atualização migra a configuração legada automaticamente na primeira execução ao detectar a configuração antiga, para que um site brownfield não enfrente um dia de bandeira ou um script quebrado no primeiro dia.
Com escopo e nunca competindo com uma instalação padrão
O listener atende apenas a superfície legada; tudo o mais retorna 404 <a href="#ref-2">[2]</a>. Ele é sem chave por necessidade de compatibilidade, então trate seu escopo de vinculação adequadamente, mantendo-o em loopback a menos que um alcance LAN seja realmente necessário e, nesse caso, protegendo-o com firewall. Ele nunca compete com uma instalação padrão real: se algo já estiver usando a porta clássica, o daemon ignora o listener de compatibilidade e registra isso no log em vez de travar. A porta primária não é afetada, mantendo a mesma governança, chaves, painel e métricas de qualquer outra implantação.
Uma desativação que você pode planejar
Após a data de desativação compilada, o listener para de se vincular, com uma linha clara no log, para que o caminho de compatibilidade tenha um fim definido em vez de uma responsabilidade indefinida <a href="#ref-1">[1]</a>. Redirecione cada consumidor legado para a interface compatível com OpenAI da porta principal com uma chave no seu próprio ritmo e, quando o último for movido, desative o ouvinte. Nada quebra no primeiro dia e tudo estará moderno até o fim do suporte.