bemade-addons/ai_integration/models/doc_models.md

Documentation des Modèles AI Integration

Vue d'ensemble

Le module AI Integration fournit une infrastructure flexible pour intégrer différents fournisseurs d'IA dans Odoo. Il est conçu pour être extensible et permettre l'ajout facile de nouveaux fournisseurs.

Modèles Principaux

1. AI Provider (ai.provider)

• Description: Configuration de base des fournisseurs d'IA
• Champs principaux:
  • name: Nom du fournisseur
  • code: Code technique unique
  • description: Description détaillée
  • default_host: Hôte par défaut
  • active: État actif/inactif

2. AI Provider Instance (ai.provider.instance)

• Description: Instance spécifique d'un fournisseur d'IA
• Héritage: mail.thread, ai.base.mixin
• Champs principaux:
  • name: Nom de l'instance (ex: "OpenWebUI Production", "Ollama Local")
  • provider_id: Fournisseur associé
  • provider_type: Type de fournisseur (extensible par modules)
  • active: État actif/inactif
• Validation:
  • Vérifie la présence d'au moins un module fournisseur installé

3. AI Model (ai.model)

• Description: Modèles d'IA disponibles
• Champs principaux:
  • name: Nom du modèle
  • identifier: Identifiant technique (ex: gpt-3.5-turbo, mistral-7b)
  • provider_instance_id: Instance du fournisseur (cascade)
  • provider_type: Type de fournisseur (relié à l'instance)
  • active: État actif/inactif
  • sequence: Ordre d'affichage
• Validation:
  • Vérifie la présence d'au moins un module fournisseur installé

4. AI Generation Parameters (ai.generation.params)

• Description: Paramètres de génération pour les modèles d'IA
• Type: Modèle abstrait
• Champs principaux:
  • temperature: Contrôle de l'aléatoire (défaut: 0.7)
  • repeat_penalty: Pénalité de répétition (défaut: 1.1)
  • max_tokens: Nombre maximum de tokens (défaut: 2048)
  • stop_sequences: Séquences d'arrêt
  • frequency_penalty: Pénalité de fréquence (défaut: 0.0)
  • presence_penalty: Pénalité de présence (défaut: 0.0)

Configuration et Interfaces

1. Res Config Settings

• Description: Paramètres de configuration globaux
• Champs principaux:
  • default_provider_instance_id: Instance de fournisseur par défaut
  • default_model_id: Modèle par défaut
  • ai_batch_size: Taille du lot pour le traitement

2. Res Company

• Description: Extensions des paramètres de société
• Méthodes principales:
  • _get_default_provider_instance: Obtenir l'instance par défaut

3. AI Provider Interface (ai.provider.interface)

• Description: Interface abstraite pour les fournisseurs d'IA
• Méthodes requises:
  • send_message: Envoyer un message
  • get_models: Obtenir la liste des modèles
  • test_connection: Tester la connexion

Notes d'Implémentation

1. Architecture Modulaire:

   • Modules fournisseurs disponibles: ollama_ai_integration, chatgpt_ai_integration
   • Vérification de la présence d'au moins un module fournisseur avant création d'instances

2. Héritage et Extensions:

   • Les instances de fournisseur héritent de mail.thread et ai.base.mixin
   • Les paramètres de génération sont définis dans le modèle abstrait ai.generation.params

3. Configuration Hiérarchique:

   • Configuration globale > Paramètres société > Instance
   • Paramètres de génération personnalisables à plusieurs niveaux

4. Sécurité et Validation:

   • Vérifications de sécurité intégrées
   • Validation des modules requis
   • Gestion des paramètres de génération avec valeurs par défaut