Use o seu próprio fornecedor de IA: OpenAI, Claude, Gemini ou Bedrock no Archyl

A primeira vez que apresentei o Archyl a uma equipa de arquitetura da Fortune 500, a conversa estava a correr genuinamente bem — até ao minuto 23.

"Isto é ótimo. A sério. Mas a nossa equipa de segurança não nos vai deixar enviar código pela vossa IA. Temos um contrato com a Anthropic via Bedrock. Tudo tem de passar por esse endpoint."

Já tinha ouvido variações da mesma frase uma dúzia de vezes. Empresas diferentes, fornecedores diferentes, a mesma parede:

"Já pagamos Azure OpenAI." "Os nossos dados têm de ficar em eu-central-1." "Os jurídicos aprovaram a Mistral, não o que quer que estejam a usar." "Podemos usar o nosso próprio contrato de GitHub Models? Está incluído com os lugares que já comprámos."

Até hoje, a resposta era sempre: ainda não.

Hoje já é. Cada funcionalidade de IA do Archyl pode agora ser encaminhada pelo seu fornecedor de IA, com a sua chave de API, no seu contrato. Escolha entre OpenAI, Anthropic (Claude), Google (Gemini), AWS Bedrock, ou qualquer endpoint compatível com OpenAI — e os limites de quota do Archyl deixam de se aplicar porque paga ao fornecedor diretamente.

Vou explicar o que mudou, porque é mais importante do que parece, e como ativar.

Porque é que isto é mais do que "adicionámos um campo de configuração"

O Archyl é construído à volta da IA. A descoberta de arquitetura lê o seu repositório e gera um modelo C4. A análise de ADR transforma markdown em decisões estruturadas. O assistente de chat responde a perguntas pelos seus projetos. Os agentes geridos executam tarefas multi-passo contra a sua codebase. Os insights fazem emergir problemas de arquitetura antes de se tornarem incidentes.

Durante dois anos, tudo isto correu num modelo que eu escolhi, pago por uma chave OpenAI que eu possuía. A maioria dos clientes estava perfeitamente feliz com isso — é uma relação com fornecedor a menos para gerir. Mas "a maioria" não é "todos", e os clientes que eu estava a perder eram os que mais queria: grandes organizações de engenharia com práticas de arquitetura sérias e orçamentos reais.

O que os bloqueava não era o preço. Eram outras três coisas:

  1. Residência de dados. A equipa de segurança deles tinha aprovado um fornecedor específico numa região específica. O meu não estava na lista, e adicionar um fornecedor leva meses.
  2. Contratos existentes. Já tinham negociado preços enterprise com a Anthropic, Azure OpenAI, AWS Bedrock ou Mistral. Pagarem-me para marcar tokens de outro fornecedor não fazia sentido para as compras.
  3. Compliance. RGPD, SOC 2, HIPAA, reguladores financeiros. A trilha de auditoria tem de aterrar no tenant deles, não no meu.

A solução tinha de lhes dar três coisas ao mesmo tempo: a chave deles, o modelo deles, e sem dupla faturação por uso de IA. É exatamente isso que o BYO Provider faz.

O que pode ligar

Cinco fornecedores entregues hoje. Quatro são integrações nativas de primeira classe; um é um adaptador genérico que cobre uma cauda longa de endpoints compatíveis com uma única configuração.

OpenAI — api.openai.com diretamente com a sua chave. Modelo padrão é gpt-5.4-mini, mas pode sobrepor por funcionalidade.

Anthropic (Claude) — a Messages API, com streaming. Padrão claude-sonnet-4-6. É onde a maioria das equipas enterprise acaba por aterrar.

Google (Gemini) — a Generative Language API com modo JSON nativo. Padrão gemini-2.0-flash.

AWS Bedrock — a Converse API, que é unificada sobre todos os modelos alojados no Bedrock. Uma integração cobre Anthropic Claude no Bedrock, Mistral, Llama, Titan, Cohere — o que a sua conta tiver ativado. Fornece credenciais AWS na forma <access_key_id>:<secret_access_key> (com session token STS opcional), mais a sua região.

Compatível com OpenAI (tudo o resto) — um adaptador, um campo de URL base. Esta única integração cobre Azure OpenAI, GitHub Models, OpenRouter, Mistral La Plateforme, Groq, Together AI, Fireworks, DeepInfra, vLLM, llama.cpp, e praticamente qualquer outro endpoint que fale o formato OpenAI Chat Completions. Aponta para o URL base, cola uma chave, está feito.

Este último foi o mais divertido de desenhar. A cada seis meses aparece um novo fornecedor "30% mais barato que a OpenAI com a mesma qualidade" — e todos convergem para o formato OpenAI precisamente porque toda a gente se integrou contra ele. Tratar esta cauda longa como um único fornecedor com URL base configurável significa que ganhamos esses novos endpoints de graça, e não tem de esperar que eu os adicione.

Um modelo por funcionalidade, não apenas um fornecedor

Encaminhar cada funcionalidade do Archyl pelo gpt-5.4-mini é uma escolha que fiz para a plataforma. Não é a escolha certa para todos os clientes. A descoberta é pesada em tokens e beneficia de um modelo de raciocínio forte. O chat precisa da sensação de streaming. Os agentes geridos são essencialmente moldados para Claude. A geração de títulos de doc pode correr no mais barato.

Por isso quando ativa o BYO Provider, não escolhe um modelo — escolhe um padrão e depois sobrepõe por funcionalidade:

  • Chat
  • Descoberta (e as suas três sub-fases: estrutura, refinamento, análise de ficheiro)
  • Análise de ADR
  • Geração de títulos de doc
  • Insights
  • Agentes geridos

Deixe qualquer campo em branco e ele recai no padrão sensato do fornecedor. Preencha com o identificador exato de modelo — claude-opus-4-5, gpt-4o, mistral-large-latest, anthropic.claude-sonnet-4-20250514-v1:0, o que for — e o Archyl passa-o diretamente.

Isto importa mais do que parece. Um cliente quer Claude Sonnet para chat (latência baixa) e Claude Opus para descoberta (qualidade de raciocínio). Outro quer Bedrock Llama para tudo exceto agentes geridos, que quer na Anthropic direto. Ambos estão a um par de dropdowns da sua configuração ideal.

O que acontece à sua quota

Esta é a parte que as compras realmente se importam. Os planos gratuitos e pagos do Archyl incluem cada um uma quota mensal de operações de descoberta de IA, queries de chat e execuções de agentes geridos. Essa quota existe para cobrir a minha conta da OpenAI.

Quando o BYO Provider está ativado, toda essa aplicação de quota é ignorada. O seu fornecedor fatura-lhe diretamente o uso. O Archyl deixa de contar contra o seu teto mensal porque não está a consumir a despesa de IA agrupada do Archyl.

Em termos práticos: uma organização no plano Business com BYO Provider ativado obtém descoberta ilimitada, chat ilimitado, execuções de agentes ilimitadas — limitadas apenas pelo que está disposto a gastar com a Anthropic ou AWS. O preço do lugar do Archyl cobre a plataforma; você cobre os tokens.

Para organizações que querem ficar no modelo gerido pela plataforma, nada muda. O toggle é opt-in, desativado por padrão, reversível num clique.

Como ativar

Definições → separador IA. Cinco passos, talvez dois minutos:

  1. Escolha o seu fornecedor.
  2. Cole a sua chave de API. (Para Bedrock: <access_key_id>:<secret_access_key> mais a região AWS.)
  3. Sobreponha opcionalmente os modelos por funcionalidade. Deixe em branco para usar o padrão do fornecedor.
  4. Carregue em Testar conexão — o Archyl faz ping ao seu fornecedor com uma pequena completion para confirmar que as credenciais funcionam antes de confirmar.
  5. Ative Ativar e Guardar.

É só isso. O próximo pedido de IA de qualquer pessoa na organização — descoberta, chat, execução de agente, importação de ADR — flui pelo seu fornecedor, no seu modelo, com a sua chave.

As chaves de API são encriptadas em repouso usando AES-256-GCM com a chave de encriptação da plataforma, nunca devolvidas nas respostas da API (a UI mostra •••••••• e um indicador "chave guardada"), e apenas desencriptadas em processo quando um pedido precisa de ser feito. Remover a configuração apaga a chave.

Apenas administradores da organização podem configurar isto. Os membros verão as funcionalidades de IA continuar a funcionar de forma transparente — o encaminhamento é invisível para eles.

O que se segue

Algumas coisas já estão na roadmap baseadas em conversas iniciais com clientes:

  • Bedrock Provisioned Throughput para organizações com contratos de capacidade reservada.
  • Override de fornecedor por projeto, para que uma equipa a trabalhar num projeto sensível possa encaminhar apenas esse projeto por um endpoint específico enquanto o resto da organização usa o padrão.
  • Audit log de BYO, mostrando exatamente que funcionalidade chamou que fornecedor com que modelo, para equipas de compliance que precisam de o demonstrar.

Se algum destes desbloquearia — ou se há um sexto fornecedor que devo adicionar — adoraria ouvir. Responda a este post, escreva-me no chat in-app, ou marque 20 minutos.

Se tem estado à espera que "já usamos {o seu fornecedor de IA}" deixasse de ser um bloqueador para adotar o Archyl, esta é a release. Lance uma organização, coloque a sua chave, e encaminhe cada funcionalidade de IA pelo contrato que já tem.

A sua arquitetura, o seu fornecedor, a sua chave. O produto continua o mesmo — só a fatura é que se move.