Aller au contenu

Configurer le modèle IA

Futuh s’appuie pour sa couche IA sur gomlo_ai_agent et utilise LiteLLM comme commutateur. Vous définissez un modèle principal et un ou plusieurs modèles de secours, et le système bascule quand le principal échoue. Canon par défaut : Mistral Large 2512 via OpenRouter.

Décider qui supporte le coût IA

Section titled “Décider qui supporte le coût IA”

Ceci passe avant la configuration technique car cela conditionne la clé que vous allez saisir.

  • Fédéré : votre instance consomme le modèle IA du Hub Central sans clés propres. La facture arrive à ACPP, qui la répercute dans le forfait annuel fédéré. Recommandé sauf raison contraire.
  • Local : votre instance apporte son propre compte OpenRouter. La facture vous parvient directement. Utile si vous disposez d’un budget IA spécifique ou de contraintes sur le fournisseur.

Le choix se trouve dans le champ Mode de facturation IA. Le modifier par la suite nécessite une coordination avec le Hub Central. [VERIFY: nom exact du champ dans l’UI v0.1]

Configurer le fournisseur principal

Section titled “Configurer le fournisseur principal”
  1. Ouvrez Paramètres → Futuh → IA → Fournisseurs et cliquez sur Nouveau.
  2. Renseignez Nom (par exemple, OpenRouter principal).
  3. Dans Fournisseur, choisissez openrouter. Autres valeurs : openai, anthropic, mistral, ollama.
  4. Dans URL de base, laissez https://openrouter.ai/api/v1.
  5. Collez votre Clé API. Elle est chiffrée et visible uniquement par les administrateurs.
  6. Cochez Actif et enregistrez.

Enregistrer les modèles disponibles

Section titled “Enregistrer les modèles disponibles”
  1. Ouvrez Paramètres → Futuh → IA → Modèles et cliquez sur Nouveau.
  2. Donnez un Nom lisible (par exemple, Mistral Large 2512).
  3. Dans Identifiant, saisissez le slug exact du fournisseur : mistralai/mistral-large-2512, anthropic/claude-sonnet-4, openai/gpt-4o.
  4. Associez le Fournisseur créé précédemment.
  5. Si vous souhaitez l’utiliser pour des tâches impliquant des images, cochez Prend en charge la vision.
  6. Enregistrez. Répétez pour chaque modèle disponible.

Mettre en place la bascule automatique

Section titled “Mettre en place la bascule automatique”

Si le modèle principal échoue (erreur réseau, quota épuisé, limite de débit), le système essaie le suivant. La configuration se fait dans l’agent.

  1. Ouvrez Paramètres → Futuh → IA → Agents et sélectionnez l’agent (par exemple, Silvio).
  2. Dans Modèle principal, choisissez le modèle à utiliser en premier (canon Futuh : Mistral Large 2512).
  3. Dans Modèles de secours, ajoutez dans l’ordre les modèles vers lesquels basculer. Recommandation canon : GPT-4o en deuxième, Claude Sonnet 4 en troisième. La diversité de fournisseurs réduit le risque de panne simultanée.
  4. Ajustez Température et Tokens maximum si vous avez une préférence. Valeurs par défaut : 0,3 et 2048.
  5. Enregistrez.

Vérifier que tout fonctionne

Section titled “Vérifier que tout fonctionne”
  1. Ouvrez Discuss et entrez dans le canal de l’agent configuré.
  2. Posez une question courte : « Quels modules Futuh ai-je actifs ? ».
  3. Vérifiez que la réponse arrive en moins de dix secondes et cite correctement les modules.
  4. Pour tester la bascule automatique, désactivez temporairement le fournisseur principal et recommencez. La réponse devrait arriver de la même façon avec un délai de 2-3 secondes.

Résolution des problèmes fréquents

Section titled “Résolution des problèmes fréquents”
  • « No active provider ». Aucun fournisseur n’est actif. Retournez dans Fournisseurs et cochez-en au moins un.
  • « I cannot help with that » en anglais. Le modèle refuse le contenu selon sa propre politique. Vérifiez le system_prompt de l’agent : il lui manque probablement du contexte Futuh.
  • Coût IA mensuel plus élevé que prévu. Ouvrez Paramètres → Futuh → IA → Journal des invocations et filtrez par modèle. Cause fréquente : un agent avec max_tokens très élevé qui génère de longues réponses.

Prochaines étapes

Section titled “Prochaines étapes”