Como Administradores Corporativos Configuram o JetBrains AI Enterprise para Encaminhar Solicitações de Chat a Modelos Locais Compatíveis com OpenAI

Empresas em setores altamente regulamentados, como instituições financeiras, defesa, saúde e infraestrutura crítica, enfrentam restrições rigorosas de conformidade ao adotar ferramentas de assistência de código com inteligência artificial. Regulamentações como LGPD, GDPR, PCI-DSS e políticas internas de prevenção contra perda de dados (DLP) proíbem expressamente o envio de código-fonte confidencial e lógica de negócios para modelos comerciais em nuvem pública (como OpenAI ou Anthropic Claude hospedados em serviços multilocatários).

Para viabilizar a adoção dessas tecnologias sem violar os requisitos regulatórios, a JetBrains disponibiliza o JetBrains AI Enterprise, módulo corporativo gerenciado centralizadamente por meio do JetBrains IDE Services. Ao implantar o IDE Services dentro de uma rede corporativa isolada ou desconectada (air-gapped), os administradores de sistemas podem configurar endpoints internos compatíveis com a API OpenAI — hospedados em ferramentas como vLLM, llama.cpp, LM Studio ou gateways internos de IA — e direcionar todas as interações de chat do JetBrains AI Assistant exclusivamente para a infraestrutura própria da empresa.

Este guia prático explica detalhadamente como configurar endpoints locais compatíveis com OpenAI no JetBrains IDE Services, distribuir políticas por meio de perfis corporativos e garantir o isolamento absoluto do código-fonte.

Separação de Arquitetura: AI Chat vs. Autocompletar de Código

Antes de iniciar a configuração, os administradores devem compreender como o ecossistema JetBrains AI divide suas operações:

1. AI Chat Interativo e Ações Contextuais: O painel de chat, explicação de trechos de código, sugestões de refatoração, geração de testes unitários e elaboração de mensagens de commit comunicam-se via chamadas HTTP padrão compatíveis com OpenAI (/v1/chat/completions). Os administradores podem apontar essas funções para qualquer cluster interno de inferência que execute modelos abertos (como Qwen 2.5 Coder, Llama 3.3 ou DeepSeek Coder).
2. Autocompletar de Código Nativo: A completação de linha única ou multilinhas em tempo real exige latência na escala de milissegundos. Em ambientes corporativos isolados, o JetBrains AI Enterprise utiliza o motor proprietário JetBrains Mellum, instalado on-premises em servidores dedicados equipados com GPUs NVIDIA (como L40, H100 ou H200).

Ao combinar um servidor local compatível com OpenAI para as conversas de chat com uma instância on-premises do Mellum para o autocompletar, a organização alcança cobertura total das ferramentas de IA em ambiente 100% air-gapped, eliminando qualquer risco de vazamento de código.

Pré-requisitos e Preparação do Ambiente

Antes de acessar a interface de administração do JetBrains IDE Services, certifique-se de que a infraestrutura atenda aos seguintes requisitos:

• Servidor JetBrains IDE Services: Instalado na rede interna corporativa (via Helm Charts no Kubernetes ou contêineres Docker) e acessível sob um certificado TLS interno confiável.
• Licenciamento do AI Enterprise Ativo: Habilitado na conta corporativa JetBrains Account e provisionado na aba License & Activation da instância do IDE Services.
• Cluster de Inferência Local Compatível com OpenAI: Um serviço de inferência em execução na rede interna que exponha uma API no formato padrão da OpenAI (como http://vllm-cluster.internal:8000/v1 ou via gateway corporativo https://ai-gateway.corp.internal/v1).
  • Motores compatíveis incluem vLLM, llama.cpp, LM Studio ou proxies internos customizados.
  • O endpoint deve suportar chamadas para /v1/chat/completions.
  • O tokenizer do modelo deve estar configurado com o respectivo template de chat (chat template).
• Requisitos nos Computadores dos Desenvolvedores: Estações de trabalho devem possuir o JetBrains Toolbox App (versão 2.5.1 ou superior) instalado e conectado ao servidor corporativo do IDE Services.

Passo 1: Implantar e Testar o Servidor Local Compatível com OpenAI

Certifique-se de que o cluster de inferência esteja respondendo e acessível pelo host do JetBrains IDE Services. Exemplo de inicialização com vLLM em ambiente corporativo:

vllm serve Qwen/Qwen2.5-Coder-32B-Instruct \
  --host 0.0.0.0 \
  --port 8000 \
  --dtype auto \
  --tensor-parallel-size 2 \
  --api-key token-secreto-interno \
  --chat-template /caminho/para/chat_template.jinja

Execute uma chamada de validação a partir da rede interna para confirmar a conectividade e autenticação:

curl -X POST https://ai-gateway.corp.internal/v1/chat/completions \
  -H "Authorization: Bearer token-secreto-interno" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen/Qwen2.5-Coder-32B-Instruct",
    "messages": [{"role": "user", "content": "Ping"}]
  }'

Se o serviço retornar um JSON com a resposta do modelo, o endpoint está pronto para integração.

Passo 2: Adicionar o Provedor OpenAI Compatible no IDE Services

O gerenciamento é centralizado no console administrativo web do JetBrains IDE Services:

1. Faça login na Web UI do JetBrains IDE Services com uma conta de administrador.
2. Na barra lateral de navegação, acesse Configuration e abra a aba License & Activation.
3. Role até a seção AI Enterprise e clique em Settings.
4. Acesse a aba AI Providers.
5. Clique em Add provider e selecione OpenAI Compatible no menu.
6. Preencha os campos obrigatórios na janela de configuração:
   • Endpoint: Insira a URL base do gateway ou servidor de inferência (por exemplo, https://ai-gateway.corp.internal/v1 ou http://vllm.internal:8000/v1). Não adicione o sufixo /chat/completions, pois a IDE monta os caminhos finais automaticamente.
   • Authentication / API Key: Informe o Bearer Token ou chave estática exigida pelo gateway interno. Se o gateway utilizar cabeçalhos personalizados, defina o nome e o valor do header nos campos correspondentes.
   • Model Name: Informe o identificador exato do modelo disponibilizado pelo servidor (como Qwen/Qwen2.5-Coder-32B-Instruct ou meta-llama/Llama-3.3-70B-Instruct).
   • Tokens: Ajuste os limites de Max input tokens (contexto máximo de entrada) e Max output tokens (geração máxima de saída) em conformidade com o orçamento de VRAM das GPUs da infraestrutura.
7. Clique em Test connection para validar o handshake de rede e a integridade da comunicação.
8. Após a confirmação bem-sucedida, clique em Save para registrar o provedor.

Passo 3: Definir o Provedor Local como Padrão da Organização

Para impedir que desenvolvedores usem provedores externos ou nuvens públicas por engano:

1. Na lista de AI Providers, localize o provedor compatível com OpenAI recém-criado.
2. Marque-o como Default (padrão).
3. Verifique se outros provedores externos estão habilitados (como o JetBrains AI em nuvem ou OpenAI Platform público) e desmarque-os como padrão ou desative-os. Observe que, de acordo com as regras do sistema, se o JetBrains AI for marcado como padrão, ele deve ser o único; para que provedores locais sejam o padrão, o JetBrains AI precisa ser desmarcado.
4. Caso sua empresa também execute o JetBrains Mellum localmente, navegue até a aba Code Completion e defina o Mellum como provedor de completamento.
5. Clique em Save para salvar a política global.

Passo 4: Configurar Perfis Corporativos (Profiles) e Atribuir Usuários

O JetBrains IDE Services utiliza Profiles para gerenciar e distribuir versões de IDEs, plugins obrigatórios, configurações de segurança e acessos ao AI Enterprise:

1. Na Web UI do IDE Services, acesse a página Profiles.
2. Abra o perfil da equipe de engenharia (por exemplo, Perfil de Engenharia Principal) ou clique em Create profile para criar um novo.
3. No painel de configuração do perfil, localize a seção AI Enterprise.
4. Certifique-se de que o AI Enterprise está habilitado para o perfil.
5. No menu de seleção de provedores, selecione Default provider (que aponta para o endpoint local configurado).
6. Associe o perfil aos grupos de desenvolvedores desejados ou marque-o como perfil padrão para todos os membros da empresa.
7. Clique em Save changes para consolidar a distribuição.

Passo 5: Validar a Experiência do Desenvolvedor nas IDEs

Após a publicação das diretrizes pelo administrador, os computadores dos desenvolvedores são atualizados de forma autônoma:

1. Conexão via Toolbox App: O desenvolvedor abre o JetBrains Toolbox App e faz login no servidor corporativo do IDE Services via SSO ou link de convite.
2. Sincronização de Políticas: O Toolbox App entra no modo Enterprise, instala as configurações do perfil atribuído nas IDEs (IntelliJ IDEA, PyCharm, etc.) e ativa o plugin AI Assistant.
3. Uso da Ferramenta de Chat:
   • Ao abrir o painel lateral do AI Assistant na IDE, o chat conecta-se diretamente ao modelo on-premises estabelecido pela empresa.
   • O desenvolvedor pode enviar prompts, gerar testes e refatorar trechos de código com assistência imediata.
   • Todas as requisições e dados de contexto trafegam unicamente pela rede interna, sem transitar pela internet pública.
4. Bloqueio Administrativo: No menu Settings | Tools | AI Assistant | Providers & API keys da IDE, as opções de Bring Your Own Key (BYOK) individual e configurações de modelos externos permanecem travadas pela política corporativa, impedindo desvios operacionais.

Melhores Práticas de Operação e Segurança Corporativa

Para assegurar estabilidade e conformidade em ambientes de produção, adote as seguintes recomendações:

Gestão de Certificados TLS de Autoridade Interna (Internal CA)

Em redes fechadas ou air-gapped, os endpoints comumente utilizam certificados assinados por uma autoridade certificadora interna corporativa. É crucial que o certificado raiz da CA interna esteja instalado e seja confiável tanto no ambiente onde roda o JetBrains IDE Services quanto nos sistemas operacionais dos desenvolvedores, evitando falhas de handshake TLS no streaming de respostas.

Dimensionamento de GPU e Concorrência

As interações no chat de IDEs contêm contextos extensos com árvores sintáticas e trechos de múltiplos arquivos.

• No vLLM, configure recursos como PagedAttention, Continuous Batching e Chunked Prefill para manter a latência de primeiro token (TTFT) estável em picos de uso.
• Limite os tokens máximos de entrada no IDE Services para evitar que prompts extensos causem erros de memória insuficiente (OOM) nas GPUs locais.

Auditoria e Centralização por Gateway de API

Adote um gateway reverso corporativo (como Kong, Envoy ou Nginx) entre o IDE Services e o cluster de inferência para registrar métricas de uso, identidade dos usuários e contagem de tokens. Isso garante conformidade integral com exigências de auditoria de setores críticos.

Ao unificar o JetBrains IDE Services e o JetBrains AI Enterprise com modelos on-premises compatíveis com OpenAI, as organizações capacitam seus desenvolvedores com inteligência artificial avançada enquanto mantêm o código-fonte integralmente protegido dentro de seu perímetro de segurança.

Referências

• AI Enterprise in isolated infrastructure | IDE Services Documentation
• Manage AI Enterprise | IDE Services Documentation
• JetBrains Mellum | IDE Services Documentation
• Profiles | IDE Services Documentation
• User Guide: Connect to IDE Services Server | IDE Services Documentation