--- title: KI-Anbieter description: Verbinden Sie einen OpenAI-kompatiblen AI-Endpunkt für AI Chat und AI Agent — Modul aktivieren, Endpunkt und Schlüssel eingeben, testen und Limits setzen. url: https://nexcmp.com/de/docs/ai/ai-providers/ applies_to: NexCMP 1.6.1 updated: 2026-11-02 --- # KI-Anbieter {#ai-provider} > **Wo im Admin-Bereich:** System › Settings › AI provider (`/settings/ai`). Der Schalter für das KI-Modul befindet sich dort sowie unter System › Admin › License & updates (`/license`), Karte **Module**. ## Funktion {#what-it-does} AI Chat (automatisierter Support-Chat) und der AI Agent (VM-Verwaltung in Klartext) werden ohne integriertes Modell ausgeliefert. Sie wählen **Ihren eigenen Anbieter**: jeden Dienst, der eine **OpenAI-kompatible** `chat/completions` API bereitstellt — zum Beispiel OpenAI, OpenRouter, ein LiteLLM-Gateway oder Ihren eigenen vLLM-Server. NexCMP speichert den Endpunkt und den API-Schlüssel (verschlüsselt) und verwendet sie für jede KI-Funktion. Sie bezahlen den Anbieter direkt. ## Anforderungen {#requirements} | Komponente | Anforderung | |---|---| | Endpoint | Eine OpenAI-kompatible Basis-URL (`https://api.openai.com/v1`, `https://ai.example.com/v1`). NexCMP hängt `/chat/completions` an eine URL an, die auf `/v1` endet; bei jeder anderen URL wird `/v1/chat/completions` angehängt; eine URL, die bereits auf `/chat/completions` endet, wird unverändert übernommen. | | Modell | Ein Modell, das **Tool- (Funktions-) Aufrufe** unterstützt. Sowohl AI Chat als auch der Agent basieren darauf. | | API-Schlüssel | Ein Schlüssel für diesen Endpunkt. Bevorzugen Sie einen Schlüssel mit einem **Ausgabenlimit** beim Anbieter (zum Beispiel ein virtueller LiteLLM-Schlüssel mit monatlichem Budget). | | Netzwerk | Der Panel-Server muss den Endpunkt über HTTP(S) erreichen können. Eine im Formular eingegebene URL darf nur auf Port 80, 443, 8080 oder 8443 ins Internet zeigen; um eine interne Adresse zu verwenden, speichern Sie den Anbieter zuerst und testen Sie ihn dann. | | Abhängigkeiten | Das **AI**-Modul ist eingeschaltet. Informationen zum Agenten finden Sie unter [AI Agent](https://nexcmp.com/de/docs/ai/ai-agent/#requirements). | ## Infrastruktur vorbereiten {#prepare-the-infrastructure} 1. Registrieren Sie sich beim Anbieter und erstellen Sie einen API-Key. Wenn der Anbieter Budgets oder Rate Limits unterstützt, legen Sie ein monatliches Limit fest. 2. Notieren Sie die **Basis-URL** und den exakten **Modellnamen** (sowie optional bis zu vier Fallback-Modelle). 3. Testen Sie ihn vor der Eingabe vom NexCMP-Server aus: ```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"}]}' ``` Eine JSON-Antwort mit `choices[0].message.content` bedeutet, dass der Endpunkt funktioniert. ## In NexCMP verbinden {#connect-in-nexcmp} 1. Öffnen Sie **System › Settings › AI provider**. 2. Schalten Sie das Modul in der Karte **Module AI** **ein**. Solange es ausgeschaltet ist, sehen Kunden weder AI Chat noch den AI Agent im Portal. (Sie können es auch unter **License & updates** umschalten.) 3. Füllen Sie in der Karte **Connection** Folgendes aus: | Feld | Beispiel | Hinweise | |---|---|---| | Diesen Anbieter verwenden | on | Benötigt eine Basis-URL, ein Modell und einen Schlüssel zum Einschalten. | | Anzeigename | `LiteLLM` | Bis zu 60 Zeichen. | | Basis-URL (OpenAI-kompatibel) | `https://ai.example.com/v1` | `http://` oder `https://`, bis zu 300 Zeichen, keine Leerzeichen. | | API-Key des Anbieters | `sk-XXXX` | Verschlüsselt gespeichert; danach werden nur die letzten 4 Zeichen angezeigt. Leer lassen, um den gespeicherten Schlüssel beizubehalten. | | Standardmodell | `gpt-4o-mini` | Buchstaben, Ziffern und `- _ . / : @`. | | Fallback-Modelle | `gemini-2.5-flash` | Kommagetrennt, bis zu 4. Wird verwendet, wenn das Standardmodell ausfällt. | | Reasoning-Aufwand | Standard (nicht gesendet) | `Minimal`, `Low`, `Medium` oder `High`. Bei Reasoning-Modellen (Gemini, o-Serie) antwortet eine niedrige Stufe viel schneller. Bei normalen Modellen auf Standard belassen. | 4. Klicken Sie auf **Save** und dann auf **Test connection**. Der Test sendet eine kurze Frage und zeigt `Connected — , ms` oder den vom Anbieter zurückgegebenen Fehler an. ![AI provider-Seite mit eingeschaltetem AI-Modul und mit Beispielwerten ausgefülltem Verbindungsformular](https://nexcmp.com/de/docs/images/ai/ai-providers-01-connection.webp) ### Auswirkungen des Speicherns {#what-saving-does} - Die Anbietereinstellungen werden als einzelner Konfigurationseintrag gespeichert und der Schlüssel wird mit AES-256-GCM, gebunden an diesen Zweck, unter Verwendung des Masterschlüssels der Installation verschlüsselt. - Die Support-Einstellungen **Primary model** und **Fallback model** (die vom AI Chat verwendet werden) werden automatisch auf Ihr Standard- und erstes Fallback-Modell gesetzt. - Die Änderung wird in das Audit-Log geschrieben (Endpunkt, Modell, ob sich der Schlüssel geändert hat — niemals der Schlüssel selbst). ## Verifizierung {#verify} 1. **Test connection** wird grün angezeigt. 2. Melden Sie sich als Testkunde im Portal an: Das Menü bietet nun **AI Chat** (oder das Chat-Symbol) und **AI Agent** an. 3. Fragen Sie den AI Chat „What is my balance?“. Eine Antwort, die Ihr reales Guthaben nennt, zeigt, dass der Anbieter Tool-Aufrufe korrekt verarbeitet. ## Limits & Hinweise {#limits-notes} - **Ein Anbieter.** NexCMP verwendet einen einzigen konfigurierten Anbieter für Chat, Agent und Ticket-Untersuchungen. Fallback-Modelle sorgen für Ausfallsicherheit innerhalb dieses Anbieters. - **Schlüsselsicherheit.** Der gespeicherte Schlüssel wird nur an den gespeicherten Endpunkt gesendet. Wenn Sie die Basis-URL ändern, müssen Sie den Schlüssel vor dem Testen erneut eingeben. - **Limits pro Kunde.** AI Chat ist nur für angemeldete Kunden mit Nachrichtenlimits pro Minute und Chat verfügbar. Der Agent hat ein tägliches Aufruflimit pro Konto. Siehe [AI Chat](https://nexcmp.com/de/docs/ai/ai-chat/) und [AI Agent](https://nexcmp.com/de/docs/ai/ai-agent/). - **Datenschutz.** Kundenfragen und die vom KI-Agenten gelesenen Daten (schreibgeschützt) für diesen Kunden werden an Ihren Anbieter übermittelt. Weisen Sie in Ihrer [privacy policy](https://nexcmp.com/de/docs/customers/legal/) darauf hin. - **Kostenkontrolle.** NexCMP erfasst keine KI-Kosten; nutzen Sie die Budgetfunktionen des Anbieters. - Das Modul kann jederzeit abgeschaltet werden: Die AI-Menüeinträge verschwinden und AI-Routen antworten mit 404 `module_disabled`. Einige Hintergrundprojekte von AI Chat (Ticket-Untersuchung, verzögerte Antworten) übernehmen die Änderung beim nächsten Neustart des Panels. ## Fehlerbehebung {#troubleshooting} | Symptom | Ursache | Behebung | |---|---|---| | `base_url must be an http(s) URL` | Fehlendes Schema oder Leerzeichen | Verwenden Sie `https://host/v1`. | | `api_key is required to enable the provider` | Kein Schlüssel gespeichert | Geben Sie den Schlüssel ein und speichern Sie. | | `base_url and model are required to enable the provider` | Leeres Feld | Beide ausfüllen. | | "Base-URL blockiert: nur öffentliches http(s), Ports 80/443/8080/8443" | Testen einer nicht gespeicherten internen Adresse oder eines anderen Ports | Speichern Sie den Anbieter zuerst und testen Sie dann. | | `api_key is required (enter the key again when you change the endpoint)` | Die Base URL unterscheidet sich von der gespeicherten | Geben Sie den Schlüssel erneut ein. | | `model: letters, digits and - _ . / : @` | Ungültiges Zeichen | Verwenden Sie die exakte Modell-ID des Anbieters. | | `fallback_models: up to 4 model names` | Zu viele | Behalten Sie höchstens vier bei. | | Test schlägt mit 401 fehl | Falscher Schlüssel | Überprüfen Sie den Schlüssel und den Endpunkt. | | Test schlägt mit 404 oder "model not found" fehl | Falscher Pfad oder falsches Modell | Überprüfen Sie die Basis-URL (`/v1`) und die Modell-ID. | | `Too many tests — wait a minute` (429) | Mehr als 10 Tests pro Minute | Warten Sie. | | Portal zeigt weiterhin kein AI-Menü | Modul aus oder Anbieter nicht "in use" | Schalten Sie das Modul ein und aktivieren Sie den Anbieter. |