O que é gateway de modelos
Gateway de modelos é o serviço que recebe a consulta da aplicação, encaminha ao provedor de IA e devolve a resposta. Ele centraliza a credencial, o endereço dos provedores e o registro de consumo em um único ponto.
Em vez de cada máquina guardar uma chave de API, a aplicação chama o gateway. O gateway usa a credencial armazenada e devolve o resultado. O agente de código continua rodando no computador, e a consulta ao modelo passa por esse intermediário.
O que ele centraliza
O gateway reúne três funções: autenticar a aplicação, escolher o provedor e registrar o consumo. Em uma empresa, isso permite que colegas usem os modelos sem receber a chave original. O administrador define o acesso de cada integrante e acompanha os limites de gasto.
A autenticação acontece entre a aplicação e o gateway, e a credencial do provedor fica no serviço. O contrato precisa definir a responsabilidade pelo consumo e a forma de encerrar o acesso quando um integrante deixa a empresa.
O que passa por ele
A consulta e a resposta passam pelo gateway. Isso significa que o conteúdo enviado ao modelo fica visível para o serviço que faz o encaminhamento. Antes de usar, confira a política de retenção, o local de armazenamento e o que o fornecedor pode fazer com as mensagens.
O secret que protege a chave também merece atenção. Uma configuração incorreta expõe a credencial do gateway, e a revogação precisa alcançar todas as aplicações que a utilizam.
Quando usar a conexão direta
A conexão direta faz sentido quando você controla a própria chave e o consumo. Ela reduz a dependência de um serviço intermediário e mantém a credencial na máquina, com o cuidado de não compartilhar o arquivo de configuração.
O gateway ganha valor quando várias aplicações ou integrantes usam os mesmos provedores. A centralização simplifica a troca de chave, o limite de gasto e a auditoria do uso.
O que conferir antes de contratar
Confira o caminho da consulta e a política de retenção. Veja o controle de acesso por integrante e a forma de revogar uma credencial. Verifique também se o serviço permite exportar o registro de consumo e como trata a indisponibilidade de um provedor.
Um proxy reverso e um gateway de modelos podem ocupar a mesma posição na arquitetura, mas resolvem problemas diferentes. O primeiro encaminha tráfego HTTP. O segundo conhece os provedores de modelo e o consumo de cada chamada.
Para revisar a configuração de acesso a modelos em um projeto, o Desenvolvimento Colaborativo da Dev Side Studio permite examinar o fluxo e as credenciais durante a sessão.
Dúvidas frequentes
Perguntas frequentes sobre Gateway de modelos
- Gateway substitui a conexão direta com o provedor?
- Não. Ele é uma opção de arquitetura para centralizar o acesso. A conexão direta continua válida quando cada aplicação usa a própria credencial.
- A chave fica mais protegida no gateway?
- A chave deixa de circular nas máquinas dos usuários e fica no serviço que faz o encaminhamento. A proteção depende do controle de acesso desse serviço.
- O gateway vê o conteúdo das consultas?
- Em geral, sim, porque a consulta passa por ele. Confira a política de retenção e o que o contrato permite fazer com as mensagens.
- O que acontece se o gateway ficar indisponível?
- A aplicação perde o caminho até o provedor. Preveja tratamento de erro e uma alternativa de acesso, quando o uso exigir continuidade.
Para continuar
Recursos relacionados
Documentação
OpenCode Console: provedores
Mostra o cadastro de provedores externos e o encaminhamento das consultas pelo serviço.
Abrir recursoDocumentação
LiteLLM: proxy
Apresenta um proxy para centralizar o acesso a modelos e acompanhar o uso por chave.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O gateway concentra a credencial usada pelo agente e permite acompanhar o consumo durante o desenvolvimento.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.