Agent Loop

Was ist der Agent Loop?

Im Standardmodus folgt YeePilot einem einfachen Muster: Sie fragen, die KI schlägt einen Befehl vor, Sie genehmigen, er wird ausgeführt. Der Agent Loop geht weiter. Er ermöglicht der KI, komplexe, mehrstufige Aufgaben durchzuarbeiten, indem sie Dateien liest, Befehle ausführt, Ausgaben analysiert und entscheidet, was als Nächstes zu tun ist -- während Sie bei jedem Befehl in der Genehmigungsschleife bleiben.

Stellen Sie es sich als den Unterschied vor zwischen jemandem eine Anweisung nach der anderen zu geben und ein Ziel zu beschreiben und die Person die Schritte herausfinden zu lassen.

Den Agent Loop aktivieren

Es gibt zwei Möglichkeiten, den Agentenmodus zu aktivieren:

Mit dem Slash-Befehl

Geben Sie /think im Chat ein, um erweitertes Denken für die aktuelle Sitzung zu aktivieren:

> /think
Agent mode enabled (thinking: on)

Sie können auch eine Denkintensität angeben:

> /think high
Agent mode enabled (thinking: high)

Über die Konfiguration

Um den Agentenmodus standardmäßig zu aktivieren, setzen Sie dies in Ihrer Konfigurationsdatei (~/.yeepilot/config.yaml):

ai:
  agent_mode: true

Wie es funktioniert

Wenn Sie eine komplexe Aufgabe im Agentenmodus beschreiben, folgt YeePilot dieser Schleife:

1. Analysieren -- Die KI zerlegt Ihre Anfrage und bestimmt den ersten Schritt
2. Vorschlagen -- Sie generiert einen oder mehrere Befehle für den aktuellen Schritt
3. Genehmigen -- Sie überprüfen und genehmigen (oder lehnen ab) die vorgeschlagenen Befehle
4. Ausführen -- Genehmigte Befehle werden ausgeführt und die Ausgabe erfasst
5. Auswerten -- Die KI liest die Ausgabe, bestimmt, ob das Ziel erreicht ist, und entscheidet den nächsten Schritt
6. Wiederholen -- Schritte 2-5 wiederholen sich, bis die Aufgabe abgeschlossen ist oder das Iterationslimit erreicht wird

Die KI kann bis zu 25 Iterationen pro Aufgabe durchführen, bevor sie stoppt. Dieses Limit verhindert unkontrollierte Schleifen und hält die Kosten vorhersehbar.

Beispiel: Einen langsamen Server diagnostizieren

> The application at port 8080 is responding slowly. Diagnose the issue.

Im Agentenmodus könnte YeePilot diese Sequenz durcharbeiten:

1. Prüfen, ob der Prozess läuft und seine Ressourcennutzung (ps, top)
2. Aktuelle Anwendungsprotokolle auf Fehler untersuchen
3. Systemressourcen prüfen (CPU, Speicher, Festplatte, I/O)
4. Netzwerkverbindungen und Socket-Zustände betrachten
5. Kürzliche Systemänderungen oder Deployments überprüfen
6. Ergebnisse zusammenfassen und Lösungen vorschlagen

Bei jedem Schritt sehen Sie die vorgeschlagenen Befehle, genehmigen sie und sehen die Ergebnisse, bevor die KI zum nächsten Schritt übergeht.

Erweiterte Denkmodi

Der /think-Befehl akzeptiert ein Modus-Argument, das steuert, wie viel Reasoning die KI vor der Befehlsgenerierung durchführt:

Höhere Denkmodi verbrauchen mehr Token pro Schritt, erzeugen aber gründlichere Analysen. Für Routineaufgaben reicht low oder das Standard-on normalerweise aus. Zur Diagnose unklarer Probleme gibt high der KI mehr Raum, Möglichkeiten zu erwägen.

Was die KI im Agentenmodus tun kann

Während des Agent Loops hat die KI Zugriff auf mehrere Werkzeuge:

Befehle ausführen

Das primäre Werkzeug. Die KI schlägt Shell-Befehle zur Genehmigung und Ausführung vor. Jeder Befehl durchläuft weiterhin die Risikovalidierung und erfordert Ihre Bestätigung.

Dateien lesen

Die KI kann Dateien auf Ihrem System lesen, um Kontext zu sammeln. Zum Beispiel eine Konfigurationsdatei lesen, bevor Änderungen vorgeschlagen werden, oder eine Protokolldatei untersuchen, um einen Fehler zu verstehen.

Reading /etc/nginx/nginx.conf ...
 
Based on the configuration, the worker_processes is set to 1.
Given this server has 8 CPU cores, I recommend increasing it.
 
Plan:
  1. sed -i 's/worker_processes 1/worker_processes 8/' /etc/nginx/nginx.conf
 
Execute? [Y/n]

Dateien auflisten

Die KI kann Verzeichnisinhalte auflisten, um Projektstrukturen zu verstehen, relevante Dateien zu finden oder zu überprüfen, ob erwartete Dateien existieren.

Suchen

Die KI kann Dateiinhalte nach bestimmten Mustern durchsuchen und so Konfigurationswerte, Fehlermeldungen oder Code-Referenzen finden.

Kontrolle behalten

Der Agentenmodus umgeht keine Sicherheitsmechanismen:

• Jeder Befehl erfordert Ihre Genehmigung. Die KI kann nichts ausführen, ohne dass Sie Enter drücken.
• Risikoklassifizierung gilt weiterhin. DANGEROUS-Befehle werden markiert. BLOCKED-Befehle werden verweigert.
• Sie können jederzeit stoppen. Drücken Sie Ctrl+C oder geben Sie "stop" ein, um den Agent Loop zu beenden und zum Standardmodus zurückzukehren.
• Das Limit von 25 Iterationen verhindert Endlosschleifen. Wenn die KI die Aufgabe innerhalb von 25 Schritten nicht abgeschlossen hat, stoppt sie und fasst ihren Fortschritt zusammen.

Wann den Agentenmodus verwenden

Der Agentenmodus ist besonders wertvoll für:

• Diagnose-Workflows, bei denen der nächste Schritt von der Ausgabe des vorherigen abhängt
• Multi-Service-Setups, die mehrere Komponenten in Reihenfolge konfigurieren erfordern
• Fehlerbehebung, bei der die Ursache unbekannt ist und eine Untersuchung erfordert
• System-Audits, die mehrere Aspekte der Serverkonfiguration prüfen

Für einfache Einzelbefehl-Aufgaben ("show me disk usage") ist der Standardmodus schneller und effizienter.

Tipps für den Agentenmodus

• Seien Sie spezifisch bei Ihrem Ziel. "Set up a reverse proxy for the app on port 3000 with SSL via Let's Encrypt" gibt der KI ein klares Ziel, auf das sie hinarbeiten kann.
• Beginnen Sie mit /think medium für die meisten Aufgaben. Steigern Sie auf high, wenn die KI wichtige Aspekte zu übersehen scheint.
• Beobachten Sie den Token-Verbrauch. Der Agentenmodus verbraucht mehr Token als der Einzelschrittmodus. Verwenden Sie Ctrl+S, um Ihren Verbrauch zu prüfen.
• Lassen Sie die KI ihre Analyse beenden, bevor Sie mit neuen Anweisungen unterbrechen. Wenn Sie mitten im Loop umleiten, verliert die KI den Faden ihrer Untersuchung.