Régler la configuration LLM

La page LLM Config dans la barre latérale, c'est là où vous allez au-delà du « je colle une clé d'API et c'est parti » par défaut. Vous n'en avez probablement pas besoin pour votre première session. Revenez-y quand vous voudrez :

  • Connecter un second fournisseur, ou une seconde clé sur le même fournisseur.
  • Changer le modèle qu'utilise un site d'appel (dialogue, décomposition de mission, recherche…).
  • Mettre en place une chaîne de fallback (la configuration principale échoue → on retente sur la suivante).
  • Rhabiller toute la configuration en un clic avec un mode.

Un sélecteur Projet se trouve en haut de la page : System (default) modifie la configuration partagée ; choisir un projet restreint vos changements à ce projet.

Les six onglets

La page est organisée en six onglets : Fournisseurs, Outils, Préréglages, Sites d'appel, Invites, Modes.

  1. Fournisseurs — les fournisseurs que vous avez connectés et les identifiants (clés d'API) attachés à chacun. C'est ici que vivent les clés.
  2. Outils — l'outillage des agents de code pour la flotte de coders : l'outil, la variante et le modèle par défaut avec lesquels tournent les coders, et combien peuvent tourner en même temps. La plupart des testeurs n'y touchent jamais.
  3. Préréglages — des configurations de modèle sauvegardées, construites en étapes. L'étape 0 est la configuration principale ; les étapes suivantes forment la chaîne de fallback.
  4. Sites d'appel — chaque endroit où le produit appelle un modèle, groupé Research / Planning / Build. C'est ici qu'on attache un préréglage ou qu'on gère les substitutions existantes d'un site. C'est le levier principal que vous utiliserez.
  5. Invites — ajustements du prompt système par site : ajouter un préambule devant le prompt par défaut, ou le remplacer entièrement, avec un aperçu Invite effective.
  6. Modes — des bascules en un clic qui appliquent une configuration nommée sur tous les sites d'appel à la fois.

Choses courantes à faire

Ajouter un fournisseur et une clé

Ouvrez l'onglet Fournisseurs. Cliquez Ajouter un fournisseur et renseignez un Nom, le Type de fournisseur (Anthropic, OpenAI / Synthetic, Ollama ou JetBrains) et, si besoin, un Point d'accès (laissez vide pour le défaut du fournisseur). Dépliez ensuite la ligne du fournisseur et cliquez Ajouter un identifiant : donnez un Libellé à la clé, éventuellement un Groupe de limite et une Priorité, puis collez la Clé API.

Cliquez Tester sur la ligne de l'identifiant pour vérifier que la clé s'authentifie. La ligne du fournisseur a aussi son propre bouton Tester — il teste l'identifiant actif de plus haute priorité.

Un fournisseur peut porter plusieurs identifiants. Ils sont essayés par ordre de priorité, et les boutons ▲/▼ déplacent une clé plus tôt ou plus tard dans cet ordre. Une clé qui se met à échouer peut être mise en Quarantaine (et réactivée plus tard) sans la supprimer.

Choisir le modèle d'un site d'appel

Ouvrez l'onglet Sites d'appel. Les sites sont groupés par couche — Research (sites de dialogue et de recherche), Planning (décomposition de mission), Build (exécution). Trouvez la carte voulue — par exemple Dialogue, ou Mission Decomposition — et dépliez-la. Choisissez un préréglage dans le menu déroulant — Select preset — pour l'appliquer à ce site — attacher un préréglage est la façon de choisir le modèle. La section Substitutions du site en dessous liste les substitutions déjà en vigueur sur le site ; le bouton ✕ en réinitialise une à sa valeur par défaut.

Dialogue est le site le plus bavard ; la décomposition est là où s'écrivent les plans de mission. Monter ou descendre l'un des deux d'un cran de modèle est la façon la moins chère d'arbitrer entre qualité et coût.

Mettre une chaîne de fallback en place

Les chaînes de fallback vivent dans les préréglages. Ouvrez l'onglet Préréglages et créez ou modifiez un préréglage : c'est une liste d'étapes (Steps), où l'étape 0 est la configuration principale et chaque étape supplémentaire est essayée tour à tour si la précédente échoue. Attachez le préréglage aux sites d'appel qui vous intéressent depuis l'onglet Sites d'appel.

Une chaîne courante : une étape Anthropic d'abord, une étape Synthetic ensuite. Au quotidien on tourne sur votre quota Anthropic ; s'il est épuisé, l'étape Synthetic à forfait prend le relais.

À part ça, au sein d'un même fournisseur, plusieurs identifiants basculent entre eux par ordre de priorité (voir plus haut) — pas besoin de préréglage pour ça.

Appliquer un mode

L'onglet Modes porte des bascules de configuration complète nommées — des cartes comme Economy Mode, Max Intelligence, Synthetic Only, Local (Ollama) ou Reset All. Cliquez Apply sur une carte pour prévisualiser et l'appliquer sur tous les sites d'appel d'un coup. Vous pouvez aussi capturer votre configuration actuelle comme nouveau mode (Capture Current State as Mode), et un historique en bas de page enregistre qui a appliqué quoi, et quand.

Basculer sur un modèle Synthetic.new

ARDS reconnaît les modèles Synthetic par le préfixe hf: (par ex. hf:deepseek-ai/DeepSeek-V3.2). Connectez un identifiant Synthetic sur un fournisseur OpenAI / Synthetic, puis choisissez un modèle hf: dans une étape de préréglage.

À savoir

  • Les changements s'appliquent immédiatement. Le prochain appel (tour de dialogue, prochaine tâche) utilise la nouvelle config. Les appels en cours finissent sur la config sur laquelle ils ont démarré.
  • Chaque appel est snapshoté. La page LLM Snapshots est une visionneuse par appel — elle enregistre la configuration résolue et la provenance de chaque appel LLM. Interrogez-la par plage de temps et par site d'appel pour retracer « quel setup a produit cette sortie ». Le texte requête/réponse capturé est purgé après 7 jours ; les lignes de snapshot après 30.
  • Les surprises de coût sont réelles. Monter tout d'un cran de modèle peut multiplier la dépense plusieurs fois. Surveillez la page Costs après de gros changements.

Quand laisser tranquille

Pour vos trois ou quatre premières missions, laissez les défauts en place : les sites de dialogue partent sur Opus, la recherche et la décomposition de mission sur Sonnet 4.5. La page LLM Config est puissante mais expose beaucoup — ne la réglez pas avant d'avoir senti le comportement de base.