Use o seu próprio fornecedor de IA

O Archyl inclui funcionalidades de IA para descoberta de arquitetura, análise de ADR, chat, insights e agentes geridos. Por defeito, tudo isso corre num modelo gerido pelo Archyl. As organizações que têm uma relação existente com um fornecedor de IA — por razões de compliance, contratuais ou de residência de dados — podem encaminhar cada pedido de IA pelo seu próprio fornecedor com as suas credenciais.

Quando o BYO Provider está ativado:

• Cada funcionalidade de IA é encaminhada pelo fornecedor que configurar
• A aplicação de quotas do Archyl (queries de chat, descoberta de IA, execuções de agentes) é ignorada — o seu fornecedor fatura-lhe diretamente o uso de tokens
• A seleção de modelo por funcionalidade permite-lhe misturar modelos (p. ex. Claude Sonnet para chat, Claude Opus para descoberta)

É uma definição ao nível da organização; apenas os administradores da organização podem configurá-la.

Fornecedores suportados

O adaptador compatível com OpenAI é uma única configuração que cobre uma cauda longa de fornecedores. Fornece um URL base e uma chave de API, e o Archyl fala com o endpoint como se fosse OpenAI.

Configuração

Passo 1 — Abra o separador IA

Vá a Definições da organização → IA. O separador só é visível para administradores.

Passo 2 — Escolha um fornecedor

Selecione um dos cinco cartões de fornecedor. Cada cartão tem os seus próprios requisitos de credenciais:

• OpenAI / Anthropic / Google — apenas chave de API
• Compatível com OpenAI — chave de API + URL base (p. ex. https://api.openrouter.ai/api/v1, https://api.mistral.ai/v1, https://models.github.ai/inference)
• AWS Bedrock — credenciais no formato <access_key_id>:<secret_access_key> (com sufixo :<session_token> opcional para credenciais STS), mais uma região AWS (p. ex. us-east-1)

Passo 3 — Configure modelos por funcionalidade (opcional)

Cada funcionalidade de IA pode usar um modelo diferente. Deixe qualquer campo em branco para recair no padrão do fornecedor.

Use o identificador exato do modelo conforme publicado pelo fornecedor (claude-opus-4-5, gpt-4o, mistral-large-latest, anthropic.claude-sonnet-4-20250514-v1:0, etc.). O Archyl passa-o diretamente.

Passo 4 — Teste a conexão

Carregue em Testar conexão. O Archyl emite uma completion mínima contra o fornecedor configurado com as suas credenciais. Um visto verde confirma que as credenciais funcionam; um erro mostra a resposta do fornecedor para que possa corrigir a configuração antes de guardar.

Passo 5 — Ative e guarde

Marque Ativar fornecedor BYO para esta organização e carregue em Guardar definições. O próximo pedido de IA de qualquer pessoa na organização — chat, descoberta, execução de agente, importação de ADR — será encaminhado pelo seu fornecedor.

Comportamento de quotas

Quando o BYO Provider está desativado (padrão), o uso de IA conta contra a quota mensal da sua subscrição:

• Operações de descoberta de IA
• Queries de chat
• Execuções de agentes geridos

Quando o BYO Provider está ativado, as três quotas são ignoradas para a organização. Paga ao seu fornecedor diretamente pelos tokens usados; o Archyl deixa de limitar estas funcionalidades. A sua subscrição por lugar continua a aplicar-se a tudo o resto (funcionalidades de colaboração, limites de equipa, etc.).

A omissão entra em vigor imediatamente quando ativa o toggle e reverte imediatamente quando o desativa.

Segurança

As chaves de API são encriptadas em repouso usando AES-256-GCM com a chave de encriptação da plataforma. Nunca são devolvidas em respostas da API — uma vez armazenadas, a UI mostra •••••••• juntamente com um indicador "chave guardada", e a chave só é desencriptada em processo quando um pedido de IA precisa de ser feito.

Para substituir uma chave existente, digite o novo valor e guarde. Para a apagar por completo, carregue em Remover configuração, o que elimina a entrada e reverte a organização para a IA gerida pela plataforma.

Apenas administradores da organização podem ler ou modificar estas definições. Os membros continuam a usar as funcionalidades de IA de forma transparente — o encaminhamento é invisível para eles.

Agentes geridos

Quando o BYO Provider está ativado, as execuções de agentes geridos correm inteiramente no seu fornecedor, com as suas credenciais. O modelo do próprio Archyl nunca é usado como alternativa.

Se o fornecedor não conseguir executar agentes, ou se não houver modelo definido para um endpoint compatível com OpenAI, iniciar uma execução falha com uma mensagem explícita em vez de correr num modelo que não escolheu.

Resolução de problemas

"Testar conexão" falha com 401 / 403. Verifique novamente se a chave está colada corretamente sem espaços à volta. Para Bedrock, certifique-se de que o formato é <access_key_id>:<secret_access_key> (separados por dois pontos) e que a região corresponde a uma região onde o modelo foi ativado na sua conta AWS.

"baseUrl is required for openai_compatible provider". O campo URL base é obrigatório para o adaptador compatível com OpenAI. Deve apontar para a raiz da API, p. ex. https://api.openrouter.ai/api/v1 — sem /chat/completions no final.

A descoberta devolve JSON inválido. Os prompts do Archyl estão afinados para o modo JSON estrito da OpenAI. Alguns fornecedores/modelos devolvem JSON dentro de blocos de código markdown ou adicionam comentários. Mude para um modelo com forte fiabilidade no modo JSON (p. ex. gpt-4o, claude-sonnet-4-6, gemini-2.0-flash) especificamente para as funcionalidades Descoberta, Análise de estrutura e Refinamento de relações — chat e outras funcionalidades são mais permissivas.

O chat funciona mas a descoberta falha no Bedrock. Alguns IDs de modelos Bedrock requerem Provisioned Throughput ou perfis de inferência cross-região específicos. Verifique se o modelo está ativado para a sua conta na consola Bedrock e se a região escolhida corresponde à disponibilidade do modelo.

Funcionalidades relacionadas

• Descoberta por IA — usa o seu fornecedor configurado quando o BYO está ativado
• Execuções de agentes geridos — correm no seu fornecedor Anthropic, Bedrock, OpenAI ou compatível com OpenAI