🚀 Dify mit benutzerdefinierten CodingPlanX-Modellen integrieren

Mit diesem Tutorial können Sie die von CodingPlanX bereitgestellte API und die Modelle problemlos in Ihre Dify-Plattform integrieren, um benutzerdefinierte KI-Funktionen aufzurufen.

📋 Voraussetzungen

Bevor Sie mit der Konfiguration beginnen, stellen Sie bitte sicher, dass die folgenden Bedingungen erfüllt sind:

Zugriff auf die Dify-Plattform: Eine bereitgestellte private Dify-Version oder ein offizielles Dify-Cloud-Konto.
API Key: Ein gültiger API-Schlüssel (API Key), der auf der CodingPlanX-Plattform generiert wurde.

⚙️ Konfigurationsschritte

Schritt 1: Einstellungen des Modellanbieters öffnen

Melden Sie sich in der Dify-Konsole an.
Klicken Sie auf Ihren „Avatar“ in der oberen rechten Ecke und wählen Sie im Dropdown-Menü „Einstellungen“ (Settings).
Klicken Sie im linken Navigationsbereich auf „Modellanbieter“ (Model Providers).

Schritt 2: Benutzerdefiniertes Modell hinzufügen

Da CodingPlanX mit dem OpenAI-Schnittstellenstandard kompatibel ist, müssen wir die von Dify bereitgestellte allgemeine Konfigurationsoption OpenAI-API-compatible verwenden.

Scrollen Sie auf der Seite „Modellanbieter“ nach unten und suchen Sie die Option „OpenAI-API-compatible“.
Klicken Sie auf der Karte auf die Schaltfläche „Modell hinzufügen“ (Add Model).

Schritt 3: Konfigurationsparameter ausfüllen (Kernstück)

Füllen Sie im Popup-Konfigurationsfenster die Parameter strikt gemäß der folgenden Tabelle aus:

Parametername	Eingabe / Beispiel	Beschreibung
Modelltyp (Model Type)	`LLM`	Wählen Sie den Modelltyp aus, den Sie integrieren möchten (normalerweise Large Language Model LLM).
Modellname (Model Name)	z. B.: `gpt-4-turbo` oder `claude-3-opus`	Erforderlich. Bitte geben Sie den von CodingPlanX tatsächlich unterstützten Modellcode ein (nicht falsch schreiben, da sonst der Aufruf fehlschlägt).
API Key	`sk-xxxxxxxxxxxxxxxxxxx`	Erforderlich. Geben Sie den API-Schlüssel ein, den Sie von CodingPlanX erhalten haben.
API endpoint URL	`https://api.codingplanx.ai/v1`	Erforderlich. Die Schnittstellenadresse. (⚠️ Achtung: Normalerweise muss dem Domainnamen der Pfad `/v1` hinzugefügt werden).
Modell-Kontextlänge (Context)	`8192` (Je nach Modell anpassen)	Die maximale Anzahl von Token, die das Modell unterstützt, wie 4096, 8192, 128000 usw.
Max. Token-Limit (Max token)	`4096` (Je nach Modell anpassen)	Die maximale Anzahl von Token, die für eine einzelne Antwort generiert werden dürfen.

> 💡 Tipps: > * Zur API-URL: Obwohl die Basis-Domain https://api.codingplanx.ai lautet, muss im Kompatibilitätsmodus von Dify normalerweise das Suffix /v1 ergänzt werden, d. h. https://api.codingplanx.ai/v1 eingeben. > * Zum Modellnamen: Wenn Sie sich über den Modellnamen nicht sicher sind, lesen Sie bitte die offizielle API-Dokumentation von CodingPlanX, um die genaue Model-ID zu erhalten.

Schritt 4: Speichern und testen

Bestätigen Sie, dass alle Informationen korrekt eingegeben wurden, und klicken Sie unten rechts auf „Speichern“ (Save).
Wenn die Konfiguration korrekt ist, meldet das System eine erfolgreiche Speicherung, und das soeben hinzugefügte Modell wird in der Liste angezeigt.

🧪 Validierung und Nutzung

Nach Abschluss der Konfiguration können Sie das Modell sofort in Dify testen:

Gehen Sie zum Dify „Studio“ und erstellen oder öffnen Sie eine Anwendung (z. B. einen Chat-Assistenten).
Klicken Sie oben rechts auf der Anwendungs-Orchestrierungsseite im Bereich „Modellauswahl“ auf das Dropdown-Menü.
Suchen Sie die Gruppe OpenAI-API-compatible und wählen Sie Ihr soeben hinzugefügtes CodingPlanX-Modell aus.
Senden Sie eine Nachricht im Debug-Vorschaufenster auf der rechten Seite (z. B.: "Hallo, bitte stelle dich vor"). Wenn Sie eine normale KI-Antwort erhalten, war die Integration erfolgreich! 🎉

❓ Fehlerbehebung / Häufig gestellte Fragen (FAQ)

F1: Was tun, wenn beim Speichern "Connection failed" oder "Invalid API Key" angezeigt wird?

Überprüfen Sie, ob der API Key vollständig kopiert wurde und keine Leerzeichen davor oder danach enthält.
Überprüfen Sie, ob der API endpoint URL das Suffix /v1 korrekt hinzugefügt wurde.
Stellen Sie sicher, dass Ihr Servernetzwerk normal auf https://api.codingplanx.ai zugreifen kann.

F2: Beim Chatten wird "Model not found" angezeigt?

Dies liegt daran, dass der eingegebene Modellname (Model Name) auf der CodingPlanX-Plattform nicht existiert oder Sie keine Berechtigung zum Aufrufen haben. Bitte überprüfen Sie die Schreibweise des Modellnamens sorgfältig (achten Sie auf Groß-/Kleinschreibung und Bindestriche).

F3: Die Antwort wird plötzlich abgeschnitten?

Bitte überprüfen Sie, ob das Max. Token-Limit (Max token) in der Konfiguration zu niedrig eingestellt ist. Es wird empfohlen, diesen Wert zu erhöhen (z. B. auf 2048 oder 4096).