Aller au contenu

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

  1. Activer le plugin provider-deepseek (mode on) et ajouter un compte deepseek (clé API).
  2. 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 globale fournisseur/modèle, dans l'ordre d'essai.
  • Réglage fallback d'un agent : remplace la liste globale (c'est le seul endroit où un provider « sur choix explicite » comme DeepSeek est admis).
  • models.fallback_on (ou fallback_on de l'agent) : causes qui déclenchent le repli, parmi limit (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.