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 Keatic ERP. 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é à Keatic ERP. 
 Enable the chat AI assistant — activez ce toggle pour faire apparaître un assistant de chat IA accessible à vos utilisateurs depuis l'interface Keatic ERP. 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 Keatic ERP 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 Keatic ERP. 
 Accès externe 
 Champ Description Service User Utilisateur Keatic ERP 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 Keatic ERP. 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 
 Keatic ERP génère automatiquement un exemple de configuration pour Claude Desktop (claude_desktop_config.json) : 
 { 

"mcpServers": { 

"keatic ERP": { 

"command": "node", 

"args": ["/path/to/mcp-bridge.js"], 

"env": { 

"KEATIC_URL": "http://localhost:8082/ai/server/mcp_server.php", 

"KEATIC_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 Keatic ERP. Utilisez impérativement un utilisateur dédié avec des droits minimaux.