Architecture : Fournisseur, Modèle, Groupe
FIM One organise la configuration des LLM en trois niveaux :Ajouter un fournisseur
1
Ouvrir la page Modèles
Accédez à Admin (barre latérale) et sélectionnez l’onglet Modèles.
2
Cliquer sur Ajouter un fournisseur
Cliquez sur le bouton Ajouter un fournisseur dans la zone supérieure droite de la section Fournisseurs.
3
Sélectionner un préréglage ou utiliser un point de terminaison personnalisé
La boîte de dialogue affiche des boutons de préréglage pour les fournisseurs courants : OpenAI, Anthropic (Claude), Google Gemini, DeepSeek, Mistral AI et OpenAI Compatible (point de terminaison personnalisé). Cliquer sur un préréglage remplit automatiquement le nom du fournisseur et l’URL de base.Choisissez OpenAI Compatible si votre fournisseur n’est pas répertorié (par exemple, un relais tiers, Ollama ou tout autre point de terminaison compatible OpenAI).
4
Entrer les identifiants
Remplissez les champs obligatoires :
- Nom du fournisseur — Un libellé convivial (par exemple, « Mon compte OpenAI »). Ceci est uniquement pour votre référence.
- URL de base — Le point de terminaison API. Les préréglages remplissent ceci automatiquement. Pour les points de terminaison personnalisés, entrez l’URL complète (par exemple,
http://localhost:11434/v1pour Ollama). - Clé API — La clé API de votre fournisseur. Pour les modèles locaux (Ollama), entrez une chaîne non vide (par exemple,
ollama).
5
Enregistrer
Cliquez sur Créer. Le fournisseur apparaît dans la liste, prêt pour que vous y ajoutiez des modèles.
Ajouter un modèle
1
Développer un fournisseur
Sur la page Modèles, cliquez sur le chevron à côté d’un fournisseur existant pour le développer et voir ses modèles.
2
Cliquer sur Ajouter un modèle
Cliquez sur le bouton Ajouter un modèle qui apparaît sous le fournisseur développé.
3
Entrer les détails du modèle
Remplissez les deux champs obligatoires :
- Nom d’affichage — Un nom lisible affiché dans l’interface utilisateur (par exemple, « GPT-4o », « Claude Sonnet »). Peut être n’importe quoi.
- Nom du modèle (API) — L’identifiant exact du modèle envoyé à l’API (par exemple,
gpt-4o,claude-sonnet-4-6,deepseek-chat). Doit correspondre à ce que votre fournisseur attend.
4
Configurer les paramètres avancés (facultatif)
Cliquez sur le bouton bascule Avancé pour révéler les paramètres supplémentaires : Jetons de sortie maximaux, Taille du contexte, Température, Appel de fonction natif et Mode JSON. Consultez la section Paramètres avancés ci-dessous pour plus de détails sur chacun.
5
Enregistrer
Cliquez sur Créer. Le modèle apparaît sous son fournisseur et est maintenant disponible pour l’attribution aux groupes de modèles.
Paramètres avancés
Chaque modèle dispose de paramètres avancés qui contrôlent la façon dont FIM One interagit avec l’API du fournisseur pour l’extraction de sortie structurée. Ces paramètres se trouvent sous le bouton bascule Avancé dans la boîte de dialogue de création/modification du modèle.Appel de fonction natif
Nom du paramètre : Native Function Calling (stocké soustool_choice_enabled)
Par défaut : ACTIVÉ
Contrôle si FIM One utilise tool_choice forcé pour l’extraction de sortie structurée. C’est le niveau 1 dans la chaîne de dégradation de sortie structurée — la méthode la plus fiable quand le modèle la supporte.
Quand désactiver :
- Votre modèle retourne des erreurs comme
"tool_choice 'specified' is incompatible with thinking enabled"— courant avec les modèles à réflexion toujours activée (DeepSeek R1, Kimi K2.5) - Les demandes de sortie structurée sont régulièrement lentes avec une pénalité d’environ 10 secondes par appel, suivie d’une retombée à JSON Mode de toute façon
tool_choice="auto", qui fonctionne avec tous les modèles indépendamment de ce paramètre.
Ce paramètre affecte uniquement la sélection d’outil forcée utilisée pour l’extraction de sortie structurée (planification DAG, annotation de schéma). Il n’affecte pas l’agent ReAct, qui décide librement quand appeler des outils en utilisant
tool_choice="auto".Mode JSON
Nom du paramètre : JSON Mode (stocké sousjson_mode_enabled)
Valeur par défaut : ACTIVÉ
Contrôle si FIM One utilise response_format=json_object pour la sortie structurée. Ceci est le Niveau 2 dans la chaîne de dégradation.
Quand désactiver :
- Votre fournisseur rejette le préfixage de message assistant — principalement les relais AWS Bedrock, qui génèrent l’erreur
"This model does not support assistant message prefill"
Température
Par défaut : 0.7 (hérité du paramètre global s’il n’est pas défini) Contrôle le caractère aléatoire de la sortie du modèle. Plage : 0 (déterministe) à 2 (très créatif).Lorsque le raisonnement/la réflexion étendue est activé pour les modèles Anthropic, la température est automatiquement forcée à 1.0 par le système. Vous n’avez pas besoin de la définir manuellement.
Tokens de sortie maximum
Le nombre maximum de tokens que le modèle peut générer dans une seule réponse. Laissez vide pour utiliser la valeur par défaut du système (64 000). Pour les modèles locaux avec une VRAM limitée, définissez explicitement une valeur inférieure (par exemple, 8192).Taille du contexte
La taille de la fenêtre de contexte du modèle en tokens. Laissez vide pour utiliser la valeur par défaut du système (128 000). Définissez cette valeur pour correspondre à la capacité réelle de votre modèle — pour les modèles locaux, cela est souvent 4K-32K selon le modèle et la mémoire disponible.Configuration recommandée
La plupart des modèles fonctionnent correctement avec les paramètres par défaut (les deux bascules activées). Ajustez uniquement si vous rencontrez des erreurs ou une latence inutile. Le tableau ci-dessous couvre les fournisseurs et modèles courants. Les données proviennent des balises de capacité UniAPI et ont été vérifiées par rapport au comportement à l’exécution en date du 2026-03-22. Les capacités des modèles changent fréquemment — si vous rencontrez des erreurs, consultez la dernière documentation de votre fournisseur.Règles rapides
- FC natif ACTIVÉ pour les modèles avec support d’appel de fonction (la plupart des modèles modernes)
- FC natif DÉSACTIVÉ pour les modèles avec réflexion toujours activée qui rejettent
tool_choiceforcé - Mode JSON ACTIVÉ pour la plupart des modèles (paramètre par défaut sûr)
- Mode JSON DÉSACTIVÉ uniquement pour les relais AWS Bedrock (rejet de préfixe)
Matrice de Configuration par Fournisseur
OpenAI
Anthropic (Claude)
Google Gemini
DeepSeek
xAI (Grok)
Qwen (Alibaba Cloud)
Zhipu (GLM)
Moonshot (Kimi)
MiniMax
ByteDance (Doubao)
Meta (Llama)
”—” en Sortie Max signifie que le fournisseur n’a pas signalé de limite. En pratique, ces modèles supportent généralement 4K-16K jetons de sortie. Définissez Max Output Tokens explicitement dans les paramètres Avancés du modèle si vous avez besoin d’une valeur spécifique.
Groupes de modèles
Les groupes de modèles vous permettent d’assigner des modèles à des rôles spécifiques et de basculer entre les configurations en un seul clic.Rôles
FIM One utilise trois rôles de modèle. Chaque rôle sert un objectif différent dans le pipeline d’exécution :Création d’un groupe de modèles
1
Ouvrir la section Groupes
Sur la page Admin > Modèles, faites défiler jusqu’à la section Groupes de modèles.
2
Cliquer sur Ajouter un groupe
Cliquez sur le bouton Ajouter un groupe.
3
Nommer le groupe
Entrez un nom descriptif (par exemple, « Production (OpenAI) », « Budget (DeepSeek) », « Local Dev »).
4
Assigner des modèles aux rôles
Pour chaque rôle (Général, Rapide, Raisonnement), sélectionnez un modèle dans la liste déroulante. La liste déroulante affiche tous les modèles actifs des fournisseurs actifs, groupés par nom de fournisseur. Vous pouvez laisser un rôle non assigné — il reviendra au modèle Général (ou aux modèles configurés par ENV si Général n’est pas assigné non plus).
5
Enregistrer
Cliquez sur Créer. Le groupe est maintenant disponible pour activation.
Activation d’un groupe
Pour activer un groupe de modèles, utilisez le menu déroulant ou la commande d’activation sur la page Modèles. Un seul groupe peut être actif à la fois. L’activation d’un groupe applique immédiatement ses attributions de modèles à toutes les nouvelles conversations. Pour désactiver le groupe actuel (revenir aux modèles configurés par ENV), sélectionnez l’option de désactivation.Escalade de modèle consciente du domaine
Lorsque l’auto-routeur détecte un domaine spécialisé — juridique, médical ou financier — le système escalade automatiquement la sélection du modèle au-delà des attributions de rôle normales :- Mode ReAct : Le modèle général est remplacé par le modèle de raisonnement (
registry.get_by_role("reasoning")). Cela signifie que l’emplacement Raisonnement dans votre Groupe de modèles n’est pas seulement utilisé pour les étapes DAGmodel_hint="reasoning"— il sert également de cible d’escalade pour les tâches ReAct spécifiques au domaine. - Mode DAG : Le contexte du domaine est injecté dans l’invite du planificateur, le guidant pour assigner
model_hint="reasoning"aux étapes nécessitant une précision spécialisée.
REASONING_LLM_MODEL).
Variables d’environnement associées :
Secours ENV
Lorsqu’aucun groupe de modèles configuré par l’administrateur n’est actif, FIM One se replie sur la configuration basée sur ENV :
Les modèles configurés par l’administrateur ont toujours la priorité sur les variables ENV. La vérification de l’état du système considère les deux sources — tant qu’un groupe de modèles actif ou des variables ENV valides sont configurés, le sous-système LLM signale un état sain.
Pour la référence ENV complète, consultez Variables d’environnement.
Exportation et importation
La page Modèles prend en charge l’exportation de l’intégralité de votre configuration de fournisseur et de modèle (fournisseurs, modèles et groupes) sous forme de fichier JSON, et son importation sur une autre instance. Ceci est utile pour :- Migrer la configuration entre les environnements de développement, de staging et de production
- Partager une configuration de modèle éprouvée avec les membres de l’équipe
- Sauvegarder votre configuration avant d’apporter des modifications