---
title: AI Chat im Admin-Bereich
description: Konfigurieren Sie NexCMP im Chat im Admin-Bereich: AI-Quelle wählen, Bestätigungskarten prüfen, Secrets sicher übergeben und tägliches Limit setzen.
url: https://nexcmp.com/de/docs/configure-with-ai/ai-chat-in-admin/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# AI Chat im Admin-Bereich {#ai-chat-in-the-admin}

> **Wo im Admin-Bereich:** AI Chat (`/agent`, eigener Menüeintrag) und der schwebende **Ask AI**-Button auf jeder Admin-Seite. Die Antwortquellen werden unter System › Settings › AI accounts (`/agent/accounts`) eingerichtet.

## Funktion {#what-it-does}

AI Chat ist ein in den Admin-Bereich integrierter Assistent. Sie beschreiben, was Sie tun möchten („Proxmox-Cluster verbinden“, „E-Mail einrichten“), der Assistent liest den aktuellen Status über die Admin-Tools aus, schlägt Änderungen vor und zeigt jede davon als **Bestätigungskarte** an. Nichts wird angewendet, bevor Sie auf **Confirm** drücken. Das **Ask AI**-Panel stellt denselben Chat in einer schmalen Seitenleiste dar, sodass Sie Fragen stellen können, während Sie eine Seite betrachten. Buttons wie **Do it for me** (in der [Setup progress checklist](https://nexcmp.com/de/docs/configure-with-ai/setup-checklist/) und in leeren Listen) öffnen ihn mit einer vorbereiteten Frage.

Es ist nicht der kundenorientierte [AI Chat](https://nexcmp.com/de/docs/ai/ai-chat/) und [AI Agent](https://nexcmp.com/de/docs/ai/ai-agent/), der Ihren Kunden dient.

## Anforderungen {#requirements}

| Komponente | Anforderung |
|---|---|
| Rolle | Ein angemeldeter Administrator. Chats, Schlüssel und Einstellungen gehören zu Ihrem Administratorkonto; andere Administratoren sehen diese nicht. |
| Eine Antwortquelle | Mindestens eine Verbindung: ein API-Schlüssel, eine Anmeldung, der eigene KI-Anbieter des Panels oder ein KI-CLI, bei dem Sie angemeldet sind. Siehe [AI accounts and subscriptions](https://nexcmp.com/de/docs/configure-with-ai/ai-accounts-and-subscriptions/). |
| Demo | Auf einem Demo-Panel können Sie alte Chats lesen, aber keine Nachrichten senden. |

## Auswählen, woher Antworten kommen {#choose-where-answers-come-from}

Wählen Sie die Quelle im Selektor unter der Eingabe aus (er listet die von Ihnen verbundenen Quellen auf). Unter **System › Settings › AI accounts** können Sie zudem eine Standardquelle, ein Standardmodell und das tägliche Limit festlegen.

| Source | Wie Sie es verbinden | Hinweise |
|---|---|---|
| OpenAI (ChatGPT-Modelle) | Einen API-Schlüssel von platform.openai.com einfügen | Wird von OpenAI nach Nutzung abgerechnet. |
| Anthropic (Claude) | Einen API-Schlüssel von console.anthropic.com einfügen | Wird von Anthropic nach Nutzung abgerechnet. |
| Google Gemini | Einen API-Schlüssel von aistudio.google.com einfügen oder **Sign in with Google** | Die Anmeldung mit Google erfordert einen OAuth-Client, den **Sie** in Ihrem eigenen Google Cloud-Projekt erstellen. |
| OpenRouter | Einen Schlüssel einfügen oder **Sign in with OpenRouter** | Ein Konto für viele Modelle. |
| Panel-KI-Anbieter | Bereits festgelegt unter System › Settings › AI provider | Derselbe Anbieter, den der AI Chat Ihrer Kunden nutzt. [AI provider](https://nexcmp.com/de/docs/ai/ai-providers/). |
| Claude-, ChatGPT- oder Gemini-Abonnement | Offizielles CLI installiert und auf dem Panel-Server angemeldet | Siehe [AI accounts and subscriptions](https://nexcmp.com/de/docs/configure-with-ai/ai-accounts-and-subscriptions/). |

Eingefügte Schlüssel werden verschlüsselt nur für Ihr Administratorkonto gespeichert. Sie werden nie wieder angezeigt und ein anderer Administrator kann sie nicht entschlüsseln.

## Den Chat verwenden {#use-the-chat}

1. Öffnen Sie **AI Chat** (oder klicken Sie auf **Ask AI**).
2. Klicken Sie auf **New chat** oder öffnen Sie einen früheren aus der Liste links.
3. Geben Sie Ihre Anfrage ein und drücken Sie die Eingabetaste (Shift+Enter startet eine neue Zeile). Sie können Bilder oder Textdateien (bis zu 4 pro Nachricht, je 3 MB) anhängen, um einen Fehler zu zeigen oder ein Dokument einzufügen.
4. Beobachten Sie, wie die Antwort eintrifft. Jedes vom Assistenten aufgerufene Werkzeug erscheint als einklappbare Karte mit dem Werkzeugname, seinen Argumenten und einem kurzen Ergebnis.
5. Drücken Sie **Stop**, um eine laufende Antwort abzubrechen. Pro Administrator läuft jeweils nur eine Antwort.

![AI Chat mit der Konversationsliste, einer Antwort mit Werkzeugkarten und der Eingabe mit Quellenauswahl und Secret-Feld](https://nexcmp.com/de/docs/images/configure-with-ai/ai-chat-in-admin-01-chat.webp)

Pro Nachricht erfolgen bis zu 10 Werkzeugrunden. Der Assistent merkt sich die letzten 30 Nachrichten des Chats. Ergebnisse von Werkzeugen werden dem Modell als Daten markiert übergeben, nicht als Anweisungen.

## Bestätigungskarten {#confirmation-cards}

Im AI Chat ist **jede Änderung eine Karte**, nicht nur Finanzaktionen. Der Assistent schlägt vor; Sie entscheiden.

Eine Karte zeigt:

- Einen Titel, der angibt, warum sie Aufmerksamkeit erfordert, zum Beispiel "changes a customer balance".
- Den Aufruf: Methode und Pfad.
- Eine Tabelle der Felder, die sich ändern: der aktuelle und der neue Wert. Geheime Werte werden als `••••` angezeigt.
- Ein Countdown (Karten laufen nach 5 Minuten ab).
- **Confirm** und **Reject**.

Durch **Confirm** wendet das Panel die Änderung selbst an und teilt dem Assistenten anschließend mit, was passiert ist. Der Assistent kann die Schaltfläche nicht drücken, sich nicht über die API autorisieren und wird angewiesen, niemals zu behaupten, eine Änderung sei angewendet worden, bevor sie bestätigt wurde. Wenn Sie die Seite neu laden, kommen noch gültige Karten zurück. Sie erscheinen auch ganz oben unter **System › Settings › API & AI agents** im Bereich „Waiting for your confirmation“.

![Bestätigungskarte mit der Kontostandsänderung, dem Countdown sowie den Schaltflächen Confirm und Reject](https://nexcmp.com/de/docs/images/configure-with-ai/ai-chat-in-admin-02-confirm.webp)

## Secrets {#secrets}

Passwörter und API-Schlüssel dürfen nicht über den Chattext übermittelt werden. Verwenden Sie das Feld **Secret** (Schloss-Symbol) neben der Eingabe:

1. Klicken Sie auf das Schloss-Symbol und geben Sie einen **Namen** (Buchstaben, Ziffern und Unterstrich, zum Beispiel `smtp_password`) sowie den **Wert** ein.
2. Verweisen Sie in Ihrer Nachricht auf den Namen: „use the secret smtp_password as the SMTP password“.
3. Der Assistent sieht immer nur einen Platzhalter, der für das Secret steht und so geschrieben ist:

   ```text
   {{secret:smtp_password}}
   ```

   Das Panel ersetzt ihn zum Zeitpunkt der Ausführung des Tools durch den echten Wert. Der Wert wird nicht im Chatverlauf gespeichert und nicht an die AI-Quelle gesendet.

Wenn Sie versehentlich etwas in die Nachricht einfügen, das wie ein Schlüssel aussieht, verschiebt das Panel es in denselben geschützten Speicher und maskiert es im Verlauf; betrachten Sie dies jedoch als Sicherheitsnetz und nicht als Methode. Secrets verbleiben nur im Speicher des Panels für die Konversation, in der sie eingegeben wurden, sowie bis zu einer Stunde nach der letzten Nachricht; ein Neustart des Panels löscht sie ebenfalls. Geben Sie sie erneut ein, falls der Assistent danach fragt.

Das Festlegen eines Secrets erfordert außerdem die `secrets:write`-Berechtigung für die Chatsitzung (siehe unten).

## Berechtigungen des Chats {#permissions-of-the-chat}

Jede Nachricht wird mit einem temporären Schlüssel ausgeführt, der für die Dauer der Antwort (höchstens 15 Minuten) existiert, nur vom Panel-Server aus funktioniert und ausschließlich über die Bestätigungskarten verwendet werden kann. Seine Gültigkeitsbereiche (Scopes) sind diejenigen, die unter **System › Settings › AI accounts › Chat session permissions** aktiviert sind. `admin:read` ist immer aktiv. Alle Scopes außer `secrets:write` sind standardmäßig aktiv; aktivieren Sie `secrets:write`, wenn der Assistent Passwörter und Schlüssel festlegen können soll (über das Secret-Feld). Auf einem Demo-Panel ist der Chat schreibgeschützt.

## Tägliches Ausgabenlimit {#daily-spending-cap}

AI Chat addiert die geschätzten Kosten der Antworten von API-Quellen. Das Standardlimit liegt bei **5 USD pro Administrator und Tag**. Legen Sie unter **AI accounts › Defaults for AI Chat** einen anderen Betrag fest (0 bedeutet kein Limit). Die Seite zeigt „used today“ an. Wenn das Limit erreicht ist, lehnt der Chat neue Nachrichten ab (`daily_cap`), bis zum nächsten Tag oder bis Sie das Limit anheben. Quellen, bei denen es sich um AI-CLI-Abonnements handelt, werden nicht mitgezählt, da diese über Ihr Abonnement abgerechnet werden.

## Verifizierung {#verify}

1. Klicken Sie unter **AI accounts** bei der Quelle auf **Test**. Als Antwort werden der Modellname und die Zeit in Millisekunden ausgegeben.
2. Fragen Sie im AI Chat: „Check my setup progress“. Die Antwort listet die Schritte aus der [Checkliste](https://nexcmp.com/de/docs/configure-with-ai/setup-checklist/) auf und es erscheint eine `setup_checklist`-Tool-Karte.
3. Bitten Sie um eine kleine Änderung, zum Beispiel „Set the brand name to Example Cloud“. Es erscheint eine Bestätigungskarte; drücken Sie **Confirm** und überprüfen Sie die Branding-Seite.
4. **API & AI agents › Activity** listet die Aufrufe mit dem Kanal `chat` auf.

## Limits & Hinweise {#limits-notes}

- Der Assistent verfügt über keine Shell und kann keine Dateien auf dem Server lesen. Er ruft ausschließlich die [Admin-Tools](https://nexcmp.com/de/docs/configure-with-ai/mcp-admin/#tools) auf.
- Änderungen, die von Schlüsseln niemals vorgenommen werden dürfen ([Liste](https://nexcmp.com/de/docs/configure-with-ai/admin-api-keys/#what-a-key-can-never-do)), können auch nicht über AI Chat vorgenommen werden.
- Überprüfen Sie die Arbeit des Modells. Eine Bestätigungskarte zeigt genau an, was gesendet wird; lesen Sie diese sorgfältig durch, insbesondere Preise und Beträge.
- API-Antworten werden vom AI-Anbieter abgerechnet. Das Limit ist ein Schätzwert; legen Sie daher auch beim Anbieter ein Ausgabenlimit fest.
- Eine CLI-Antwort stoppt nach 5 Minuten.

## Fehlerbehebung {#troubleshooting}

| Symptom | Ursache | Behebung |
|---|---|---|
| „Today's AI spending cap is reached“ (`daily_cap`) | Sie haben das tägliche Limit erreicht | Erhöhen Sie es in den KI-Konten oder warten Sie bis morgen. |
| "Eine andere Antwort läuft noch - warten oder auf Stop drücken" (`busy`) | Nur eine Antwort gleichzeitig pro Administrator | Drücken Sie **Stop** oder warten Sie. |
| Die Quelle erscheint nicht in der Auswahl | Sie ist nicht verbunden oder (Claude CLI) der Schalter „I understand“ ist aus | Verbinden Sie sie in den KI-Konten. |
| "das sieht nicht nach einem API-Schlüssel aus" | Der eingefügte Schlüssel enthält Leerzeichen oder ist zu lang | Fügen Sie nur den Schlüssel ein. |
| Test fehlgeschlagen | Falscher Schlüssel, kein Guthaben oder der Anbieter ist offline | Prüfen Sie den Schlüssel und die Abrechnung beim Anbieter. |
| Der Assistent gibt an, etwas nicht tun zu können | Der Chat-Sitzung fehlt die Berechtigung oder die Aktion ist für KI gesperrt | Aktivieren Sie die Berechtigung in den KI-Konten oder tun Sie dies im Admin-Bereich. |
| Eine Karte besagt, dass sie abgelaufen ist | Es sind mehr als 5 Minuten vergangen | Bitten Sie den Assistenten, die Änderung erneut vorzuschlagen. |
| CLI-Quelle meldet „usage limit“ oder „not logged in“ | Ihr Abonnementlimit oder Ihre Sitzung | Melden Sie sich erneut an oder warten Sie; siehe [AI accounts and subscriptions](https://nexcmp.com/de/docs/configure-with-ai/ai-accounts-and-subscriptions/). |