Dateikontext

Warum Dateikontext wichtig ist

Wenn Sie YeePilot bitten, eine Konfigurationsdatei zu ändern, ein Skript zu debuggen oder ein Protokoll zu analysieren, arbeitet die KI am besten, wenn sie den tatsächlichen Dateiinhalt sehen kann. Der Dateikontext ermöglicht es Ihnen, Dateien direkt in das Gespräch zu laden, damit die KI sie referenzieren, ihre Struktur verstehen und präzise Befehle generieren kann.

Ohne Dateikontext muss die KI Dateiformate und aktuelle Werte erraten. Mit Dateikontext kann sie genau sehen, was vorhanden ist, und gezielte Änderungen vorschlagen.

Dateien hinzufügen

Verwenden Sie den /file-Befehl gefolgt von einem Dateipfad:

> /file /etc/nginx/nginx.conf

YeePilot liest die Datei und fügt deren Inhalt zum KI-Kontext hinzu. Die KI kann nun den Dateiinhalt in ihren Antworten referenzieren und die Informationen nutzen, um genauere Befehle zu generieren.

Sie können mehrere Dateien einzeln hinzufügen:

> /file /etc/nginx/sites-available/myapp.conf
> /file /var/log/nginx/error.log
> /file /home/deploy/myapp/docker-compose.yml

Praktisches Beispiel

> /file /etc/nginx/nginx.conf
Added /etc/nginx/nginx.conf to context (2.1 KB)
 
> The site is returning 502 errors. Check the nginx config for issues
  and fix any problems you find.

Mit der geladenen Konfigurationsdatei kann die KI die tatsächlichen Server-Blöcke, Upstream-Definitionen und Proxy-Einstellungen lesen, anstatt blind zu arbeiten.

Geladene Dateien auflisten

Sehen Sie, welche Dateien sich aktuell im KI-Kontext befinden:

> /files

Dies zeigt alle geladenen Dateien mit ihren Größen:

Files in context:
  1. /etc/nginx/nginx.conf           (2.1 KB)
  2. /etc/nginx/sites-available/myapp.conf  (856 B)
  3. /var/log/nginx/error.log         (12.3 KB)
 
Total: 3 files, 15.3 KB

Dateien entfernen

Entfernen Sie eine Datei aus dem Kontext, wenn sie nicht mehr benötigt wird:

> /unfile /var/log/nginx/error.log

Dies gibt Kontextplatz für andere Dateien oder Gespräche frei. Das Entfernen von Dateien, mit denen Sie fertig sind, hilft, den Token-Verbrauch niedrig zu halten und die KI auf relevante Inhalte zu fokussieren.

Dateien hochladen

Der /upload-Befehl bietet eine alternative Möglichkeit, Dateien hinzuzufügen:

> /upload

Dies öffnet einen Dateiauswahl-Ablauf. Verwenden Sie ihn, wenn Sie Dateien interaktiv hinzufügen möchten, anstatt Pfade direkt einzugeben.

Limits

Der Dateikontext hat sinnvolle Grenzen, um eine Überlastung des KI-Kontextfensters zu verhindern:

Dateien, die das Limit pro Datei überschreiten, werden mit einer Meldung abgelehnt, die die Größenbeschränkung erklärt. Wenn die gesamte geladene Größe 512 KB überschreiten würde, müssen Sie einige Dateien entfernen, bevor Sie neue hinzufügen können.

Limits anpassen

Sie können diese Limits in Ihrer Konfigurationsdatei (~/.yeepilot/config.yaml) anpassen:

files:
  max_entries: 20
  max_file_size: 102400    # Bytes (100 KB)
  max_total: 524288        # Bytes (512 KB)

Das Erhöhen dieser Limits verbraucht mehr des KI-Kontextfensters pro Nachricht, was die Token-Kosten erhöht und die Kontextkomprimierung möglicherweise früher auslöst. Die Standardwerte funktionieren gut für die meisten Serververwaltungsaufgaben.

Live-Stream-Panel

Wenn YeePilots Agent Loop während einer mehrstufigen Aufgabe Dateibearbeitungen durchführt, zeigt das Live-Stream-Panel diese Änderungen in Echtzeit an. Dies gibt Ihnen Einblick in das, was die KI liest und ändert, während sie arbeitet.

Live-Stream umschalten

> /livestream

Dies schaltet das Live-Stream-Panel ein oder aus. Wenn es aktiviert ist, erscheint das Panel neben dem Hauptgespräch und zeigt:

• Dateiinhalte, die von der KI gelesen werden
• Vorgeschlagene Bearbeitungen, die mit Diffs hervorgehoben werden
• Echtzeit-Fortschritt bei Operationen über mehrere Dateien

Der Live-Stream ist besonders nützlich im Agentenmodus, wenn die KI eine Reihe von Dateiänderungen durcharbeitet, wie das Aktualisieren mehrerer Konfigurationsdateien oder das Anwenden von Änderungen über ein Projekt hinweg.

Gängige Workflows

Konfigurationsüberprüfung

Laden Sie eine Konfigurationsdatei und bitten Sie die KI, sie zu überprüfen:

> /file /etc/ssh/sshd_config
> Review this SSH configuration for security issues and suggest hardening changes

Die KI liest die tatsächlichen Konfigurationswerte und gibt spezifische Empfehlungen mit genauen Zeilenänderungen.

Protokollanalyse

Laden Sie eine Protokolldatei, um Hilfe beim Verstehen von Fehlern zu erhalten:

> /file /var/log/syslog
> What errors occurred in the last hour? Summarize the issues.

Für große Protokolldateien, die das Größenlimit überschreiten, lassen Sie die KI stattdessen bestimmte Abschnitte lesen:

> Show me the last 200 lines of /var/log/syslog that contain "error" or "fail"

Multi-Datei-Kontext

Wenn Sie an einer Aufgabe arbeiten, die mehrere zusammenhängende Dateien betrifft, laden Sie alle:

> /file /etc/nginx/nginx.conf
> /file /etc/nginx/sites-available/api.conf
> /file /etc/letsencrypt/renewal/api.example.com.conf
> /file docker-compose.yml
 
> Set up nginx as a reverse proxy for the Docker service on port 3000
  with SSL using the existing Let's Encrypt certificate

Mit allen relevanten Dateien geladen kann die KI die Docker-Service-Konfiguration, die vorhandenen SSL-Zertifikatspfade und das aktuelle nginx-Setup querverweisen, um eine vollständige und korrekte Konfiguration zu generieren.

Skriptentwicklung

Laden Sie ein bestehendes Skript, um Hilfe beim Erweitern oder Debuggen zu erhalten:

> /file /home/deploy/backup.sh
> This backup script is failing silently. Add proper error handling
  and send an email notification on failure.

Die KI sieht die aktuelle Skriptstruktur und kann Fehlerbehandlung hinzufügen, die zum bestehenden Codierungsstil und Logikfluss passt.

Tipps

• Laden Sie Dateien, bevor Sie danach fragen. Die KI gibt viel bessere Antworten, wenn sie den tatsächlichen Inhalt sehen kann, anstatt zu raten.
• Entfernen Sie Dateien, mit denen Sie fertig sind. Das hält den Kontext sauber und die Kosten niedrig.
• Verwenden Sie /files, um zu prüfen, was geladen ist, bevor Sie eine neue Aufgabe starten. Übrig gebliebene Dateien von einer vorherigen Aufgabe können die KI verwirren.
• Für sehr große Dateien bitten Sie die KI, bestimmte Abschnitte mit Befehlen wie head, tail oder grep zu lesen, anstatt die gesamte Datei in den Kontext zu laden.