Apportez votre propre fournisseur d'IA

Archyl inclut des fonctionnalités d'IA pour la découverte d'architecture, l'analyse d'ADR, le chat, les insights et les agents managés. Par défaut, tout cela tourne sur un modèle géré par Archyl. Les organisations qui ont une relation existante avec un fournisseur d'IA — pour des raisons de conformité, contractuelles ou de résidence des données — peuvent acheminer chaque requête d'IA via leur propre fournisseur avec leurs propres identifiants.

Quand BYO Provider est activé :

  • Chaque fonctionnalité d'IA est acheminée via le fournisseur que vous configurez
  • L'application des quotas d'Archyl (requêtes chat, découverte d'IA, exécutions d'agents) est ignorée — votre fournisseur vous facture directement l'usage des tokens
  • La sélection de modèle par fonctionnalité vous permet de mixer les modèles (par exemple Claude Sonnet pour le chat, Claude Opus pour la découverte)

C'est un paramètre au niveau de l'organisation ; seuls les administrateurs de l'organisation peuvent le configurer.

Fournisseurs supportés

Fournisseur Description Modèle par défaut
OpenAI API OpenAI directe sur api.openai.com gpt-5.6-luna
Anthropic API Messages d'Anthropic directe (Claude) claude-sonnet-4-6
Google API Generative Language de Google (Gemini) gemini-2.0-flash
AWS Bedrock API Bedrock Converse — couvre Anthropic Claude, Mistral, Llama, Titan, Cohere anthropic.claude-sonnet-4-20250514-v1:0
Compatible OpenAI Tout endpoint qui parle le format OpenAI Chat Completions — Azure OpenAI, GitHub Models, OpenRouter, Mistral La Plateforme, Groq, Together AI, Fireworks, DeepInfra, vLLM, llama.cpp, etc. (selon le fournisseur)

L'adaptateur compatible OpenAI est une configuration unique qui couvre une longue liste de fournisseurs. Vous fournissez une URL de base et une clé d'API, et Archyl parle à l'endpoint comme s'il s'agissait d'OpenAI.

Configuration

Étape 1 — Ouvrez l'onglet IA

Allez dans Paramètres de l'organisation → IA. L'onglet n'est visible que pour les administrateurs.

Étape 2 — Choisissez un fournisseur

Sélectionnez l'une des cinq cartes de fournisseur. Chaque carte a ses propres exigences en matière d'identifiants :

  • OpenAI / Anthropic / Google — clé d'API uniquement
  • Compatible OpenAI — clé d'API + URL de base (ex. https://api.openrouter.ai/api/v1, https://api.mistral.ai/v1, https://models.github.ai/inference)
  • AWS Bedrock — identifiants au format <access_key_id>:<secret_access_key> (avec un suffixe :<session_token> optionnel pour les identifiants STS), plus une région AWS (ex. us-east-1)

Étape 3 — Configurez les modèles par fonctionnalité (optionnel)

Chaque fonctionnalité d'IA peut utiliser un modèle différent. Laissez n'importe quel champ vide pour revenir au défaut du fournisseur.

Fonctionnalité Description
Chat Assistant chat en streaming
Découverte Découverte d'IA sur tout le dépôt — nécessite une sortie JSON fiable
Analyse de structure Phase 1 de la découverte (système + conteneurs)
Affinage des relations Phase 3 de la découverte (liens entre conteneurs)
Analyse d'ADR Extrait des champs structurés depuis le markdown ADR
Analyse de fichier Passe de détail par fichier
Génération de titres de doc Génération groupée de titres pour la documentation
Insights Insights d'architecture générés par IA
Agents managés Modèle utilisé par les exécutions d'agents managés (voir Agents managés)

Utilisez l'identifiant exact du modèle tel que publié par le fournisseur (claude-opus-4-5, gpt-4o, mistral-large-latest, anthropic.claude-sonnet-4-20250514-v1:0, etc.). Archyl le passe directement.

Étape 4 — Testez la connexion

Cliquez sur Tester la connexion. Archyl émet une complétion minimale contre le fournisseur configuré avec vos identifiants. Une coche verte confirme que les identifiants fonctionnent ; une erreur fait remonter la réponse du fournisseur pour que vous puissiez corriger la configuration avant de sauvegarder.

Étape 5 — Activez et enregistrez

Cochez Activer le fournisseur BYO pour cette organisation et cliquez sur Enregistrer les paramètres. La prochaine requête d'IA de n'importe qui dans l'organisation — chat, découverte, exécution d'agent, import d'ADR — sera acheminée via votre fournisseur.

Comportement des quotas

Quand BYO Provider est désactivé (par défaut), l'usage d'IA est décompté contre le quota mensuel de votre abonnement :

  • Opérations de découverte d'IA
  • Requêtes chat
  • Exécutions d'agents managés

Quand BYO Provider est activé, les trois quotas sont contournés pour l'organisation. Vous payez votre fournisseur directement pour les tokens utilisés ; Archyl ne limite plus ces fonctionnalités. Votre abonnement par siège s'applique toujours pour tout le reste (fonctionnalités de collaboration, limites d'équipe, etc.).

Le contournement prend effet immédiatement lorsque vous activez la bascule et s'inverse immédiatement lorsque vous la désactivez.

Sécurité

Les clés d'API sont chiffrées au repos en AES-256-GCM avec la clé de chiffrement de la plateforme. Elles ne sont jamais renvoyées dans les réponses d'API — une fois enregistrées, l'UI affiche •••••••• ainsi qu'un indicateur « clé enregistrée », et la clé n'est déchiffrée qu'en mémoire quand une requête d'IA doit être faite.

Pour remplacer une clé existante, saisissez la nouvelle valeur et enregistrez. Pour la supprimer entièrement, cliquez sur Supprimer la configuration, ce qui efface l'entrée et réinitialise l'organisation à l'IA gérée par la plateforme.

Seuls les administrateurs de l'organisation peuvent lire ou modifier ces paramètres. Les membres continuent à utiliser les fonctionnalités d'IA de manière transparente — l'acheminement leur est invisible.

Agents managés

Quand BYO Provider est activé, les exécutions d'agents managés tournent entièrement sur votre fournisseur, avec vos identifiants. Le modèle d'Archyl n'est jamais utilisé en repli.

Fournisseur Agents managés Modèle
Anthropic Supporté Modèle Agents managés, sinon claude-sonnet-4-6
AWS Bedrock Supporté (modèles Anthropic Claude) Modèle Agents managés, sinon anthropic.claude-sonnet-4-20250514-v1:0 ; les profils cross-région comme eu.anthropic.claude-sonnet-4-5-20250929-v1:0 fonctionnent aussi
OpenAI Supporté Modèle Agents managés, sinon gpt-5.6-luna
Compatible OpenAI Supporté si l'endpoint implémente l'API Responses d'OpenAI Modèle Agents managés — obligatoire, il n'y a pas de valeur par défaut
Google Pas encore supporté —

Si le fournisseur ne peut pas exécuter d'agents, ou si aucun modèle n'est défini pour un endpoint compatible OpenAI, le lancement d'une exécution échoue avec un message explicite au lieu de tourner sur un modèle que vous n'avez pas choisi.

Dépannage

« Tester la connexion » échoue avec 401 / 403. Vérifiez que la clé est collée correctement sans espace autour. Pour Bedrock, assurez-vous que le format est <access_key_id>:<secret_access_key> (séparés par deux-points) et que la région correspond à une région où le modèle a été activé dans votre compte AWS.

« baseUrl is required for openai_compatible provider ». Le champ URL de base est obligatoire pour l'adaptateur compatible OpenAI. Il doit pointer vers la racine de l'API, par exemple https://api.openrouter.ai/api/v1 — sans /chat/completions à la fin.

La découverte retourne du JSON invalide. Les prompts d'Archyl sont calibrés pour le mode JSON strict d'OpenAI. Certains fournisseurs/modèles renvoient le JSON dans des blocs de code markdown ou ajoutent des commentaires. Passez à un modèle avec une fiabilité forte du mode JSON (par exemple gpt-4o, claude-sonnet-4-6, gemini-2.0-flash) pour les fonctionnalités Découverte, Analyse de structure et Affinage des relations spécifiquement — le chat et les autres fonctionnalités sont plus permissifs.

Le chat fonctionne mais la découverte échoue sur Bedrock. Certains IDs de modèles Bedrock nécessitent du Provisioned Throughput ou des profils d'inférence cross-région spécifiques. Vérifiez que le modèle est activé pour votre compte dans la console Bedrock et que la région choisie correspond à la disponibilité du modèle.

Fonctionnalités liées