---
title: AI Agent
description: Ermöglichen Sie Kunden die Verwaltung ihrer Linux-VMs durch die Beschreibung von Aufgaben in natürlicher Sprache.
url: https://nexcmp.com/de/docs/ai/ai-agent/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# AI Agent {#ai-agent}

> **Wo im Admin-Bereich:** System › Settings › AI provider (`/settings/ai`) — Modulschalter und Anbieter; System › Admin › License & updates (`/license`) — Modulschalter. **Wo im Portal:** AI Agent (`/ai/agent`) und die Seite `/chat/agent` oder der Modus **Agent** im Chat.

## Funktion {#what-it-does}

Der AI Agent verbindet sich über SSH mit einer eigenen Linux-VM des Kunden und führt Aufgaben aus, die in natürlicher Sprache beschrieben werden: „Systemzustand prüfen“, „Docker installieren“, „aktuelle Fehler finden“, „Speicherplatz freigeben“. Er zeigt jeden von ihm vorgeschlagenen Befehl sowie dessen Ausgabe an. Lesende Befehle können automatisch ausgeführt werden; alles, was den Server verändert, wartet darauf, dass der Kunde **Run** drückt.

## Anforderungen {#requirements}

| Komponente | Anforderung |
|---|---|
| KI-Modul und -Anbieter | Das Modul **AI** muss eingeschaltet sein und ein funktionierender [AI provider](https://nexcmp.com/de/docs/ai/ai-providers/) vorliegen. Der Agent benötigt zudem ein Modell, das Tool-Aufrufe unterstützt. |
| `openssh-client` auf dem Panel-Server | Der Agent führt Befehle mit dem hauseigenen `ssh`-Programm (`/usr/bin/ssh`) des Panels aus. Das Installationsprogramm installiert `openssh-client`; prüfen Sie dies mit `ssh -V`. Ohne diesen meldet der Agent „ssh client is not installed on the panel server“. |
| Kein separates SSH-Gateway | In der Standardinstallation wird das integrierte SSH verwendet und das `ssh-proxy`-Webterminal ist **nicht** erforderlich. Nur wenn die optionale *Web-SSH*-Funktion (`feature_ssh_web`) aktiviert und der `ssh-proxy`-Dienst installiert wurde, läuft der Agent stattdessen über `ssh-proxy`. |
| Netzwerk | Der Panel-Server muss die IP der VM über deren SSH-Port (standardmäßig 22) erreichen können. Überprüfen Sie Firewalls und Sicherheitsgruppen zwischen dem Panel und dem Gastnetzwerk. |
| VM | Kundenbesessen, **laufend**, nicht gesperrt, **Linux** (Windows-VMs werden abgelehnt), mit einer öffentlichen oder erreichbaren IP-Adresse. |
| SSH-Anmeldedaten | Der von NexCMP gespeicherte Anmeldeuser und das Passwort der VM (bei der Erstellung oder dem Zurücksetzen des Passworts gespeichert, verschlüsselt) oder der Operations-Key des Panels, sofern installiert. Ist keines von beiden vorhanden, gibt der Agent an, dass er sich nicht anmelden kann. |

## Infrastruktur vorbereiten {#prepare-the-infrastructure}

1. Überprüfen Sie den SSH-Client auf dem Panel-Server:

   ```bash
   ssh -V
   sudo apt-get install -y openssh-client   # only if missing
   ```

2. Überprüfen Sie, ob der Panel-Server SSH zu einer Gast-VM öffnen kann:

   ```bash
   nc -vz 198.51.100.10 22
   ```

   Ersetzen Sie die Adresse durch die IP einer Test-VM. Wenn dies fehlschlägt, beheben Sie zuerst das Routing oder die Firewall.
3. Stellen Sie sicher, dass der Gast die Passwort-Anmeldung für den von NexCMP gespeicherten Benutzer erlaubt (einige Cloud-Images deaktivieren dies) oder dass der Operations-Key des Panels auf dem Gast installiert ist.

## In NexCMP verbinden {#connect-in-nexcmp}

1. Schließen Sie [AI provider](https://nexcmp.com/de/docs/ai/ai-providers/) ab: Modul ein, Anbieter gespeichert, **Test connection** grün.
2. Auf der Admin-Seite ist nichts weiter konfiguriert. Der Modulschalter lässt die Einträge für den **AI Agent** im Kundenportal erscheinen.
3. Als Kunde: Öffnen Sie **AI Agent**, wählen Sie einen laufenden Server aus und klicken Sie auf **Choose server**. Die Seite testet SSH zunächst mit einem festen, harmlosen Befehl (es wird kein KI-Aufruf verwendet) und zeigt *SSH connected* oder den Grund für das Fehlschlagen an.
4. Geben Sie eine Aufgabe ein oder wählen Sie einen Schnellstart (*Systemzustand prüfen*, *Docker installieren*, *Nginx installieren*, *Letzte Fehler finden*, *Sicherheitsprüfung*, *Speicherplatz freigeben*).



## Wie Befehle ausgeführt werden {#how-it-runs-commands}

- **Herkunft:** Der Panel-Server führt mit dem System-`ssh`-Client jeweils einen nicht-interaktiven Befehl aus. Das Ziel ist immer die IP-Adresse der VM **aus der Datenbank**, niemals aus der Anfrage; es können nur laufende, entsperrte VMs des Eigentümers erreicht werden.
- **Authentifizierung:** Das gespeicherte Passwort wird über einen einmaligen `SSH_ASKPASS`-Helper an die Prozessumgebung übergeben — es wird weder auf der Festplatte gespeichert noch in der Befehlszeile übergeben. Host-Schlüssel werden nicht gepinnt (VMs werden mit neuen Schlüsseln neu installiert). Die Ausgabe pro Befehl ist auf 200 KB begrenzt und jeder Befehl hat ein Zeitlimit (60 Sekunden).
- **Agenten-Schleife:** Die KI schlägt Befehle vor und liest die Ausgaben; ein Durchgang endet nach maximal **10 Schritten**.
- **Modi:**

  | Modus | Verhalten |
  |---|---|
  | **Confirm** | Jeder Befehl wartet auf **Run**. |
  | **Auto** | Nur Befehle, die eine strenge Read-only-Positivliste passieren, werden automatisch ausgeführt (zum Beispiel `df -h`, `ps`, `journalctl`). Alles andere sowie alles, was der Parser nicht mit Sicherheit analysieren kann (Variablen, Befehlssubstitution, Umleitungen in Dateien), wartet auf **Run**. |

- **Risikokennzeichnungen:** Befehle, die Dateien überschreiben oder löschen, auf Festplatten schreiben, Konten oder SSH-Schlüssel ändern, Daten an einen externen Server senden, rohe Netzwerkverbindungen öffnen, verschleierten Code ausführen, ein Skript herunterladen und ausführen, die Maschine herunterfahren oder neu starten oder andere Server erreichen, zeigen immer **Needs confirmation** an, selbst im Auto-Modus.
- **Nicht vertrauenswürdige Ausgabe:** Die Befehlsausgabe wird dem Modell als nicht vertrauenswürdige Daten angezeigt; darin enthaltene Anweisungen werden nicht ausgeführt.

## Verifizierung {#verify}

1. Wählen Sie eine laufende Test-VM aus. Die Seite zeigt *SSH connected* an.
2. Geben Sie "Check CPU, RAM and disk" ein. Im Auto-Modus werden die Nur-Lese-Befehle ausgeführt und die Antwort fasst sie zusammen.
3. Geben Sie "Install Nginx" ein. Der Befehl zur Installation erscheint mit **Run** und **Skip**; es wird erst etwas ausgeführt, wenn Sie auf **Run** drücken.
4. Der Zähler oben zeigt die Anzahl der heute verwendeten KI-Aufrufe an (zum Beispiel `3/300`).

## Limits & Hinweise {#limits-notes}

- **Tägliches Limit:** 300 KI-Aufrufe pro Kunde und Tag (UTC); es wird um 00:00 UTC zurückgesetzt. Wenn es aufgebraucht ist, antwortet der Agent mit "Daily AI quota reached".
- **Gleichzeitigkeit:** Höchstens 2 Agenten-Läufe pro Kunde zur gleichen Zeit; eine Sitzung führt jeweils einen Durchgang aus.
- **Sitzungen:** bis zu 100 Nachrichten pro Sitzung, 4,000 Zeichen pro Nachricht. Eine Sitzung gehört zu einer VM; wird die VM gelöscht oder übertragen, wird die alte Sitzung schreibgeschützt.
- **Gesperrte oder gestoppte VM oder Windows:** Die VM wird als *Locked*, *Stopped*, *Windows* oder *No address* angezeigt und kann nicht ausgewählt werden.
- **Impersonierung:** Ein Administrator, der sich als Kunde ausgibt, kann die Anmeldeinformationsfunktionen des Agenten nicht verwenden (siehe [Log in as a customer](https://nexcmp.com/de/docs/customers/login-as/)).
- **Verantwortlichkeit:** Der Agent kann Fehler machen. Das Portal weist Kunden an, Befehle vor der Ausführung zu überprüfen. Teilen Sie Ihren Kunden in Ihren AGB mit, dass sie für die von ihnen genehmigten Befehle verantwortlich sind.
- Das Ausschalten des KI-Moduls entfernt die Agenten-Einträge und die Routen antworten mit 404 `module_disabled`.

## Fehlerbehebung {#troubleshooting}

| Symptom | Ursache | Behebung |
|---|---|---|
| "SSH-Client ist auf dem Panel-Server nicht installiert (apt install openssh-client)" | Keine `ssh`-Binärdatei | `sudo apt-get install -y openssh-client`. |
| "Der Agent konnte sich nicht anmelden" / `ssh: no saved credentials for this VM` | Kein gespeichertes Passwort und kein Operationsschlüssel | Setzen Sie das VM-Passwort im Portal zurück, damit es erneut gespeichert wird, oder installieren Sie den Operationsschlüssel. |
| "Der Server hat nicht rechtzeitig geantwortet" | Firewall, SSH lauscht nicht, VM ausgelastet | Testen Sie `nc -vz <ip> 22` vom Panel-Server aus; starten Sie `sshd` in der VM. |
| "SSH auf diesem Server nicht erreichbar" | Routing oder Sicherheitsgruppe | Erlauben Sie dem Panel-Server, die VM über Port 22 zu erreichen. |
| "VM läuft nicht" / "Forbidden" | VM gestoppt, gesperrt, gelöscht oder gehört nicht dem Kunden | Starten oder entsperren Sie sie oder wählen Sie eine andere. |
| "Nicht verfügbar: N (gestoppt, gesperrt oder Windows)" | Obergelistete Gründe | Die VM muss Linux sein und laufen. |
| "Das SSH-Gateway ist vorübergehend nicht verfügbar" | Web-SSH-Funktion aktiviert, aber `ssh-proxy` ist offline | Starten Sie `ssh-proxy` oder schalten Sie die Web-SSH-Funktion aus, um das integrierte SSH zu nutzen. |
| "Die KI antwortet zu langsam (über 90 Sekunden)" | Anbieter langsam | Verwenden Sie ein schnelleres Modell oder einen geringeren **Reasoning effort**. |
| "Tägliches KI-Kontingent erreicht" | 300 Aufrufe verbraucht | Warten Sie bis 00:00 UTC. |
| "Diese Sitzung läuft noch" | Ein anderer Durchlauf läuft gerade | Warten Sie oder drücken Sie **Stop**. |