🚀 Connecter les modèles personnalisés CodingPlanX à Dify

Grâce à ce tutoriel, vous pourrez facilement intégrer les interfaces API et les modèles fournis par CodingPlanX dans votre plateforme Dify, afin d'utiliser des capacités d'IA personnalisées.

📋 Prérequis

Avant de commencer la configuration, assurez-vous de remplir les conditions suivantes :

Accès à la plateforme Dify : Une version privée de Dify déjà déployée, ou un compte de service cloud officiel Dify.
Clé API (API Key) : Vous avez obtenu une clé API valide sur la plateforme CodingPlanX.

⚙️ Étapes de configuration

Étape 1 : Accéder aux paramètres des fournisseurs de modèles

Connectez-vous à la console Dify.
Cliquez sur « l'Avatar » en haut à droite de la page, et sélectionnez « Settings » (Paramètres) dans le menu déroulant.
Dans la barre de navigation à gauche, cliquez sur « Model Providers » (Fournisseurs de modèles).

Étape 2 : Ajouter un modèle personnalisé

Étant donné que CodingPlanX est compatible avec les standards d'interface d'OpenAI, nous devons utiliser l'option de configuration générique OpenAI-API-compatible fournie par Dify.

Faites défiler la page « Model Providers » vers le bas et trouvez l'option « OpenAI-API-compatible ».
Cliquez sur le bouton « Add Model » (Ajouter un modèle) sur la carte.

Étape 3 : Remplir les paramètres de configuration (Crucial)

Dans la fenêtre de configuration qui apparaît, veuillez remplir les paramètres strictement selon le tableau ci-dessous :

Nom du paramètre	Contenu à remplir / Exemple	Description
Type de modèle (Model Type)	`LLM`	Sélectionnez le type de modèle que vous souhaitez connecter (généralement LLM pour les grands modèles de langage).
Nom du modèle (Model Name)	Par exemple : `gpt-4-turbo` ou `claude-3-opus`	Obligatoire. Veuillez saisir le code exact du modèle pris en charge par CodingPlanX (ne vous trompez pas, sinon l'appel échouera).
Clé API (API Key)	`sk-xxxxxxxxxxxxxxxxxxx`	Obligatoire. Saisissez la clé API obtenue sur CodingPlanX.
URL du point de terminaison de l'API	`https://api.codingplanx.ai/v1`	Obligatoire. L'adresse de l'interface. (⚠️ Attention : il faut généralement ajouter le chemin `/v1` après le nom de domaine).
Longueur de contexte du modèle (Context)	`8192` (à remplir selon le modèle)	Le nombre maximum de Tokens supportés par le modèle, comme 4096, 8192, 128000, etc.
Limite maximale de Tokens (Max token)	`4096` (à remplir selon le modèle)	Le nombre maximum de Tokens autorisés pour une seule réponse.

> 💡 Astuces (Tips) : > * Concernant l'URL de l'API : Bien que le domaine de base soit https://api.codingplanx.ai, dans le mode de compatibilité de Dify, il est généralement nécessaire d'ajouter le suffixe /v1, soit https://api.codingplanx.ai/v1. > * Concernant le nom du modèle : Si vous n'êtes pas sûr du nom du modèle, veuillez consulter la documentation officielle de l'API de CodingPlanX pour obtenir le Model ID exact.

Étape 4 : Enregistrer et tester

Après avoir confirmé que toutes les informations sont correctes, cliquez sur « Save » (Enregistrer) en bas à droite.
Si la configuration est correcte, le système indiquera que l'enregistrement a réussi et affichera le modèle que vous venez d'ajouter dans la liste.

🧪 Vérification et utilisation

Une fois la configuration terminée, vous pouvez immédiatement tester ce modèle dans Dify :

Allez dans le « Studio » de Dify, créez ou ouvrez une application (comme un assistant de chat).
Dans la zone « Sélection du modèle » en haut à droite de la page de conception de l'application, cliquez sur le menu déroulant.
Trouvez le groupe OpenAI-API-compatible et sélectionnez le modèle CodingPlanX que vous venez d'ajouter.
Envoyez un message dans la fenêtre de débogage à droite (par exemple : "Bonjour, présente-toi s'il te plaît"). Si vous recevez une réponse normale de l'IA, la connexion est réussie ! 🎉

❓ Résolution des problèmes fréquents (FAQ)

Q1 : Que faire si un message "Connection failed" ou "Invalid API Key" s'affiche lors de l'enregistrement ?

Vérifiez si la API Key a été copiée dans son intégralité, sans espaces avant ou après.
Vérifiez si l'API endpoint URL comporte bien le suffixe /v1.
Confirmez que le réseau de votre serveur peut accéder normalement à https://api.codingplanx.ai.

Q2 : Le message "Model not found" apparaît lors du chat ?

C'est parce que le Nom du modèle (Model Name) saisi n'existe pas sur la plateforme CodingPlanX ou que vous n'avez pas l'autorisation de l'appeler. Veuillez vérifier attentivement l'orthographe du nom du modèle (attention aux majuscules/minuscules et aux tirets).

Q3 : La réponse est soudainement coupée ?

Veuillez vérifier si la Limite maximale de Tokens (Max token) dans la configuration n'est pas définie sur une valeur trop petite. Il est recommandé de l'augmenter (par exemple à 2048 ou 4096).