16.3 Configuration
La page de configuration du module d’IA est accessible via Accueil > Configuration > Modules/Application > Ai > (icône engrenage) ou directement depuis le lien Configuration dans la barre d’administration. Elle comporte quatre onglets.
Onglet 1 — Paramètres
Accès : Configuration du module d’IA > Paramètres
Figure 16.2 – Onglet Paramètres — choix du fournisseur et clé API
Cet onglet permet de définir le fournisseur d’IA à utiliser et les informations de connexion associées. Service IA à utiliser — liste déroulante avec les fournisseurs disponibles :
| Fournisseur | Description |
|---|---|
| ChatGPT (OpenAI) | Service d’OpenAI (GPT-4, GPT-4o, etc.) |
| Groq (LPU Inference) | Inférence ultra-rapide via des puces LPU |
| Mistral AI | Modèles Mistral (mistral-small, mistral-large, pixtral…) |
| DeepSeek | Modèles DeepSeek |
| Perplexity (Sonar) | Moteur de recherche augmenté par IA |
| Zhipu AI (GLM) | Fournisseur chinois GLM |
| Custom | URL personnalisée compatible OpenAI API |
| Anthropic (Claude) | Modèles Claude d’Anthropic |
| Google Gemini | Modèles Gemini de Google |
Clé pour l’API IA — saisissez la clé API obtenue auprès du fournisseur choisi. Elle est masquée après enregistrement.
URL du point de terminaison — l’URL de l’API du fournisseur est préremplie automatiquement selon le service sélectionné (ex. https://api.mistral.ai/v1/ pour Mistral AI). Modifiez-la uniquement pour un usage Custom.
Après avoir renseigné ces champs, cliquez sur ENREGISTRER.
Zone de test — un champ de texte en bas de page vous permet de tester immédiatement la connexion à l’API en envoyant un prompt libre.
Onglet 2 — Prompt et modèles IA personnalisés
Accès : Configuration du module d’IA > Prompt et modèles IA personnalisés
Figure 16.3 – Onglet Prompts personnalisés — pré/post-saisie et modèles par fonctionnalité
Cet onglet est divisé en deux sections.
Prompts personnalisés
Vous pouvez définir des prompts personnalisés pour chaque fonctionnalité où l’IA intervient. Par défaut, une entrée Génération de texte (Contenu de l’email) est présente. Vous pouvez en ajouter d’autres via le bouton +. Chaque prompt comprend :
| Champ | Rôle |
|---|---|
| Pré-saisie | Texte injecté automatiquement avant le contenu généré (ex. formule d’appel : Bonjour [__THIRDPARTY_NAME__],) |
| Post-saisie | Texte injecté automatiquement après le contenu généré (ex. signature : Bien cordialement, [USER_SIGNATURE]) |
| Liste noire de mots | Mots interdits que l’IA ne doit pas utiliser dans ses réponses |
| Test | Bouton permettant de tester le prompt immédiatement |
Astuce — Les variables entre crochets doubles ([__THIRDPARTY_NAME__], [USER_SIGNATURE]) sont des substitutions automatiques Dolibarr. Utilisez-les pour personnaliser le contenu généré.
Modèles d’IA par fonctionnalité
Cette section permet de spécifier quel modèle utiliser pour chaque type de traitement, indépendamment du modèle par défaut. Laissez vide pour utiliser le modèle par défaut du fournisseur.
| Fonctionnalité | Exemple de modèle Mistral |
|---|---|
| Texte (défaut) | mistral-small-latest |
| Image | pixtral-12b-latest |
| Vidéo | — |
| Audio | — |
| Transcription | — |
| Traduction | — |
| Analyse de documents | pixtral-12b-latest |
Onglet 3 — Chat Assistant
Accès : Configuration du module d’IA > Chat Assistant
Figure 16.4 – Onglet Chat Assistant — activation de l’assistant conversationnel
Cet onglet permet d’activer l’assistant conversationnel privé intégré à Dolibarr.
Enable the chat AI assistant — activez ce toggle pour faire apparaître un assistant de chat IA accessible à vos utilisateurs depuis l’interface Dolibarr. Cet assistant est privé (accessible uniquement aux utilisateurs authentifiés de votre instance).
Note — L’assistant chat utilise le même fournisseur et la même clé API que ceux configurés dans l’onglet Paramètres.
Onglet 4 — Serveur MCP
Accès : Configuration du module d’IA > Serveur MCP
Figure 16.5 – Onglet Serveur MCP — activation et configuration de l’accès externe
Figure 16.6 – Configuration complète du serveur MCP — clé API et exemple Claude Desktop
Le Model Context Protocol (MCP) est un protocole ouvert qui permet à des assistants IA externes (comme Claude Desktop d’Anthropic) d’accéder à vos données Dolibarr en lecture pour répondre à des questions métier ou effectuer des actions.
Enable MCP Server — activez ce toggle pour exposer le serveur MCP de votre instance Dolibarr.
Accès externe
| Champ | Description |
|---|---|
| Service User | Utilisateur Dolibarr utilisé par le serveur MCP pour accéder aux données. Créez de préférence un utilisateur dédié (ex. « AI Bot ») avec des droits Lecture seule pour limiter les risques. |
| API Key | Clé d’API générée par Dolibarr. Cliquez sur GENERATE NEW KEY pour en créer une. Elle est nécessaire pour que les outils externes puissent se connecter. |
| Endpoint URL | URL du point d’entrée MCP, à communiquer à votre outil externe. Exemple : http://localhost:8082/ai/server/mcp_server.php |
Configuration Claude Desktop
Dolibarr génère automatiquement un exemple de configuration pour Claude Desktop (claude_desktop_config.json) :
{
"mcpServers": {
"dolibarr": {
"command": "node",
"args": ["/path/to/mcp-bridge.js"],
"env": {
"DOLIBARR_URL": "http://localhost:8082/ai/server/mcp_server.php",
"DOLIBARR_API_KEY": "YOUR_KEY_HERE"
}
}
}
}Copiez ce bloc dans votre fichier claude_desktop_config.json en remplaçant YOUR_KEY_HERE par la clé API générée et /path/to/mcp-bridge.js par le chemin réel du bridge MCP.
Avertissement — Sécurité — en activant le serveur MCP avec un accès externe, l’assistant IA peut lire les données de votre Dolibarr. Utilisez impérativement un utilisateur dédié avec des droits minimaux.
