--- title: Fournisseur d'IA description: Connectez un point de terminaison compatible OpenAI pour AI Chat et l'AI Agent : activez le module, entrez les identifiants et testez. url: https://nexcmp.com/fr/docs/ai/ai-providers/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # Fournisseur d'IA {#ai-provider} > **Où dans l'administration :** System › Settings › AI provider (`/settings/ai`). L'interrupteur du module d'IA se trouve à cet endroit ainsi que dans System › Admin › License & updates (`/license`), carte **Module**. ## Description {#what-it-does} AI Chat (chat de support automatique) et l'AI Agent (administration de VM en langage clair) ne sont pas livrés avec un modèle intégré. Vous choisissez **votre propre fournisseur** : tout service proposant une `chat/completions` API compatible **OpenAI** — par exemple OpenAI, OpenRouter, une passerelle LiteLLM ou votre propre serveur vLLM. NexCMP stocke le point de terminaison et la clé API (chiffrés) et les utilise pour chaque fonctionnalité d'IA. Vous payez directement le fournisseur. ## Prérequis {#requirements} | Élément | Prérequis | |---|---| | Endpoint | Une URL de base compatible OpenAI (`https://api.openai.com/v1`, `https://ai.example.com/v1`). NexCMP ajoute `/chat/completions` à une URL se terminant par `/v1` ; pour toute autre URL, il ajoute `/v1/chat/completions` ; une URL se terminant déjà par `/chat/completions` est utilisée telle quelle. | | Modèle | Un modèle qui prend en charge **l'appel d'outils (fonctions)**. L'AI Chat et l'Agent en dépendent tous les deux. | | Clé API | Une clé pour cet endpoint. Préférez une clé dotée d'un **plafond de dépenses** côté fournisseur (par exemple, une clé virtuelle LiteLLM avec un budget mensuel). | | Réseau | Le serveur du panneau doit pouvoir joindre l'endpoint via HTTP(S). Une URL saisie dans le formulaire ne peut pointer vers Internet que sur les ports 80, 443, 8080 ou 8443 ; pour utiliser une adresse interne, enregistrez d'abord le fournisseur puis testez. | | Dépendances | Le module **AI** est activé. Pour l'Agent, consultez [AI Agent](https://nexcmp.com/fr/docs/ai/ai-agent/#requirements). | ## Préparer l'infrastructure {#prepare-the-infrastructure} 1. Inscrivez-vous auprès du fournisseur et créez une clé API. Si le fournisseur prend en charge les budgets ou les limites de taux, définissez une limite mensuelle. 2. Notez l'**URL de base** et le **nom du modèle** exact (et éventuellement jusqu'à quatre modèles de secours). 3. Testez-la depuis le serveur NexCMP avant de la saisir : ```bash curl -s https://ai.example.com/v1/chat/completions \ -H "Authorization: Bearer XXXX" -H "Content-Type: application/json" \ -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Reply with one word: OK"}]}' ``` Une réponse JSON avec `choices[0].message.content` indique que l'endpoint fonctionne. ## Connecter dans NexCMP {#connect-in-nexcmp} 1. Ouvrez **System › Settings › AI provider**. 2. Dans la carte **Module AI**, activez le module (**on**). Tant qu'il n'est pas activé, les clients ne voient ni l'AI Chat ni l'AI Agent dans le portail. (Vous pouvez également l'activer dans **License & updates**.) 3. Dans la carte **Connection**, renseignez : | Champ | Exemple | Remarques | |---|---|---| | Utiliser ce fournisseur | activé | Requiert une base URL, un modèle et une clé pour être activé. | | Nom d'affichage | `LiteLLM` | Jusqu'à 60 caractères. | | Base URL (compatible OpenAI) | `https://ai.example.com/v1` | `http://` ou `https://`, jusqu'à 300 caractères, sans espaces. | | Clé API du fournisseur | `sk-XXXX` | Stockée de manière chiffrée ; par la suite, seuls les 4 derniers caractères sont affichés. Laissez vide pour conserver la clé enregistrée. | | Modèle par défaut | `gpt-4o-mini` | Lettres, chiffres et `- _ . / : @`. | | Modèles de secours | `gemini-2.5-flash` | Séparés par des virgules, jusqu'à 4. Utilisés en cas d'échec du modèle par défaut. | | Niveau de raisonnement | Par défaut (non envoyé) | `Minimal`, `Low`, `Medium` ou `High`. Pour les modèles de raisonnement (Gemini, série o), un niveau bas répond beaucoup plus rapidement. Laissez sur Défaut pour les modèles normaux. | 4. Cliquez sur **Save**, puis sur **Test connection**. Le test envoie une question courte et affiche `Connected — , ms` ou l'erreur renvoyée par le fournisseur. ![Page AI provider avec le module AI activé et le formulaire de connexion rempli avec des valeurs d'exemple](https://nexcmp.com/fr/docs/images/ai/ai-providers-01-connection.webp) ### Ce que fait l'enregistrement {#what-saving-does} - Les paramètres du fournisseur sont enregistrés en tant qu'entrée de configuration unique et la clé est chiffrée avec AES-256-GCM, liée à cet usage, à l'aide de la clé principale de l'installation. - Les paramètres de support **Primary model** et **Fallback model** (utilisés par l'AI Chat) sont automatiquement définis sur votre modèle par défaut et votre premier modèle de secours. - La modification est consignée dans le journal d'audit (endpoint, modèle, indication de changement de clé — jamais la clé). ## Vérification {#verify} 1. **Test connection** s'affiche en vert. 2. Connectez-vous au portail en tant que client test : le menu propose désormais **AI Chat** (ou la bulle de chat) et **AI Agent**. 3. Posez la question "What is my balance?" à l'AI Chat. Une réponse indiquant votre véritable solde prouve que le fournisseur gère correctement les appels d'outils. ## Limites et notes {#limits-notes} - **Un seul fournisseur.** NexCMP utilise un unique fournisseur configuré pour le Chat, l'Agent et l'investigation des tickets. Les modèles de secours assurent la résilience au sein de ce fournisseur. - **Sécurité des clés.** La clé enregistrée n'est envoyée qu'à l'endpoint enregistré. Si vous modifiez la Base URL, vous devez saisir à nouveau la clé avant de tester. - **Limites par client.** L'AI Chat est réservé aux clients connectés, avec des limites de messages par minute et par chat. L'Agent dispose d'une limite d'appels quotidienne par compte. Voir [AI Chat](https://nexcmp.com/fr/docs/ai/ai-chat/) et [AI Agent](https://nexcmp.com/fr/docs/ai/ai-agent/). - **Confidentialité.** Les questions des clients et les données lues par l'IA pour ce client (en lecture seule) sont envoyées à votre fournisseur. Mentionnez-le dans votre [politique de confidentialité](https://nexcmp.com/fr/docs/customers/legal/). - **Maîtrise des coûts.** NexCMP ne facture pas les coûts de l'IA ; utilisez les fonctionnalités de budget du fournisseur. - Le module peut être désactivé à tout moment : les éléments de menu de l'IA disparaissent et les routes de l'IA renvoient une erreur 404 `module_disabled`. Certaines tâches d'arrière-plan de l'AI Chat (analyse de tickets, réponses différées) prennent en compte le changement au prochain redémarrage du panneau. ## Dépannage {#troubleshooting} | Symptôme | Cause | Solution | |---|---|---| | `base_url must be an http(s) URL` | Schéma manquant ou espaces | Utilisez `https://host/v1`. | | `api_key is required to enable the provider` | Aucune clé enregistrée | Saisissez la clé et enregistrez. | | `base_url and model are required to enable the provider` | Champ vide | Remplissez les deux. | | "URL de base bloquée : http(s) public uniquement, ports 80/443/8080/8443" | Test d'une adresse interne non enregistrée ou d'un autre port | Enregistrez d'abord le fournisseur, puis testez. | | `api_key is required (enter the key again when you change the endpoint)` | L'URL de base diffère de celle enregistrée | Saisissez à nouveau la clé. | | `model: letters, digits and - _ . / : @` | Caractère invalide | Utilisez l'ID de modèle exact du fournisseur. | | `fallback_models: up to 4 model names` | Trop nombreux | Conservez-en quatre ou moins. | | Le test échoue avec l'erreur 401 | Clé incorrecte | Vérifiez la clé et l'endpoint. | | Le test échoue avec 404 ou "model not found" | Chemin ou modèle incorrect | Vérifiez l'URL de base (`/v1`) et l'ID du modèle. | | `Too many tests — wait a minute` (429) | Plus de 10 tests par minute | Patientez. | | Le portail n'affiche toujours pas le menu IA | Module désactivé ou fournisseur non "in use" | Activez le module et activez le fournisseur. |