Modèles et providers¶
Les modèles qu'un agent peut utiliser viennent des providers : des plugins de type provider
(page Plugins de l'administration). Trois sont livrés avec le produit.
| Provider | État par défaut | Usage |
|---|---|---|
claude |
actif | Modèles Claude d'Anthropic (compte d'abonnement ou clé API). Comportement historique. |
deepseek |
éteint | DeepSeek (deepseek-chat, deepseek-reasoner) par son point d'accès compatible Anthropic. Clé API. |
mock |
actif mais refusé sans autorisation | Faux modèle pour les tests. Réservé à la pile de test. |
Choisir un modèle¶
Un modèle s'écrit fournisseur/modèle (par exemple deepseek/deepseek-chat). Un nom seul
(claude-sonnet-5-5) désigne le premier provider actif qui le propose, à défaut claude.
La liste proposée dans l'interface (models.catalog) est calculée à partir des providers actifs ;
renseigner cette clé la remplace.
Comptes¶
Chaque compte modèle appartient à un provider (core.model.account.add accepte provider).
Un compte claude accepte un jeton OAuth ou une clé API ; deepseek et mock une clé API.
Un modèle n'utilise que les comptes de son propre provider. Un plafond d'usage met le compte en
pause jusqu'à son heure de reset et le tour est rejoué sur le compte suivant ; un refus 401 met le
compte en pause 24 h (jamais un repli de modèle : c'est le compte qui est en cause).
DeepSeek : choix explicite par agent¶
- Activer le plugin
provider-deepseek(modeon) et ajouter un comptedeepseek(clé API). - Dans l'agent, choisir le modèle
deepseek/deepseek-chat, ou l'ajouter à sa liste de repli.
DeepSeek n'est jamais dans une chaîne de repli globale : seuls les agents qui le nomment
l'utilisent. Les données envoyées à ce provider quittent l'Union européenne ; le domaine
api.deepseek.com est ajouté à la liste de sortie du run uniquement quand il est dans la chaîne.
Repli de modèle¶
Quand le modèle principal échoue pour une cause temporaire, le tour est rejoué sur le modèle suivant.
models.fallback: liste globalefournisseur/modèle, dans l'ordre d'essai.- Réglage
fallbackd'un agent : remplace la liste globale (c'est le seul endroit où un provider « sur choix explicite » comme DeepSeek est admis). models.fallback_on(oufallback_onde l'agent) : causes qui déclenchent le repli, parmilimit(plafond d'usage, comptes du provider épuisés),overloaded(529),server_error(5xx),timeout. Par défaut :limit,overloaded,server_error.
Le repli est toujours visible : colonnes modèle utilisé et raison du repli du run, ligne dans le
fil du run, événement model.fallback, métrique harness_gateway_model_fallbacks_total et la
mention « Modèle de repli : … » ajoutée à la réponse livrée (web et plateformes). Un 401 ne déclenche
jamais de repli. Si toute la chaîne échoue, l'erreur d'origine est rapportée.
Mock (tests)¶
provider-mock sert un faux point d'accès compatible Anthropic (/mock/anthropic) que la vraie CLI
Claude Code consomme dans le runner. Il est refusé (403) tant que l'instance n'a pas
HARNESS_ALLOW_MOCK_PROVIDER=1, variable posée uniquement par deploy/compose.test.yml. Ne jamais
la poser en production ; le mock est de toute façon écarté des chaînes de repli hors instance de test.