Pi Agent Interaktiver Modus
Dieses Kapitel stellt umfassend die Kernoperationen im interaktiven Modus von Pi Agent vor, einschließlich Slash-Befehlen, Modellverwaltung und Tastaturbedienung.
Slash-Befehlsreferenz
Die Eingabe im Editorbereich/löst eine automatische Befehlsvervollständigung aus.
Die folgenden sind gängige integrierte Befehle im interaktiven Modus von Pi Agent:
| Befehl | Funktion | Beschreibung |
|---|---|---|
| /login | Anmeldeanbieter | Wählen Sie OAuth-Abonnement- oder API-Key-Anbieter zur Authentifizierung aus |
| /logout | Abmelden | Gespeicherte Authentifizierungs-Anmeldedaten löschen |
| /model | Modell wechseln | Modellauswahl öffnen und nach Namen suchen; drücken Sie im Auswahlfeld Ctrl+S, um sie als Startstandard zu speichern |
| /thinking | Reasoning-Stufe wechseln | Auswahl für die Reasoning-Stufe öffnen; drücken Sie im Auswahlfeld Ctrl+S, um sie als Startstandard zu speichern |
| /scoped-models | Modellbereichsverwaltung | Liste der für den Zykluswechsel mit Ctrl+P verfügbaren Modelle festlegen |
| /settings | Einstellungsbereich | Integrierte Einstellungsoberfläche öffnen: Reasoning-Stufe, Design, Nachrichtenzustellung, Transportprotokoll usw. |
| /resume | Sitzung fortsetzen | Historische Sitzung auswählen und wiederherstellen |
| /new | Neue Sitzung | Eine brandneue Konversation starten |
| /name | Sitzung benennen | Einen lesbaren Namen für die aktuelle Sitzung festlegen |
| /session | Sitzungsinformationen | Sitzungsdateipfad, ID, Nachrichtenanzahl, Token-Nutzung und Kosten anzeigen |
| /tree | Sitzungsbaum-Navigation | Zu einem beliebigen Knoten im Konversationsbaum springen, um die Konversation fortzusetzen |
| /trust | Projekt vertrauen | Vertrauensentscheidungen für Projekte speichern, um nicht bei jedem Start gefragt zu werden |
| /fork | Sitzung forken | Eine neue Sitzungsdatei aus einer vorherigen Benutzernachricht forken |
| /clone | Sitzung klonen | Den aktuell aktiven Zweig in eine neue Sitzungsdatei kopieren |
| /compact | Kontext komprimieren | Konversationsverlauf manuell komprimieren, um Platz im Kontextfenster freizugeben |
| /copy | Antwort kopieren | Die letzte Antwort der KI in die Zwischenablage kopieren |
| /export | Sitzung exportieren | Als HTML- oder JSONL-Datei exportieren |
| /import | Sitzung importieren | Sitzung aus einer JSONL-Datei importieren und wiederherstellen |
| /share | Sitzung teilen | Als privaten GitHub Gist hochladen, einen teilbaren HTML-Link generieren |
| /reload | Hot Reload | Erweiterungen, Skills, Prompt-Vorlagen, Designs, Kontextdateien und Tastenkürzel-Konfigurationen neu laden |
| /hotkeys | Tastenkürzel-Hilfe | Eine Liste aller Tastenkürzel anzeigen |
| /changelog | Änderungsprotokoll | Verlauf der Versionsupdates anzeigen |
| /quit | Beenden | Pi Agent beenden |
Neben integrierten Befehlen können Erweiterungen auch benutzerdefinierte Befehle registrieren.
Skills werden automatisch als/skill:name-Befehl registriert, während Prompt-Vorlagen über/template-namezum Aufrufen verwendet werden.
Modellverwaltung
Die Modellverwaltung umfasst drei Aspekte: Modelle wechseln, den Bereich für den zyklischen Wechsel festlegen und Reasoning-Stufen anpassen.
Die entsprechenden Befehle und Tastenkürzel werden unten vorgestellt.
Modell wechseln (/model und Ctrl+L)
Verwenden Sie den Befehl/modeloderCtrl+L, um die Modellauswahl zu öffnen und alle verfügbaren KI-Modelle zu durchsuchen.
In der Modellauswahl können Sie nach Namen suchen; nach der Auswahl drücken Sie Ctrl+S, um sie als Standard beim Start zu speichern.
Hier ist ein Ablauf zum Öffnen der Modellauswahl und Wechseln von Modellen:
/model ┌ 选择模型（输入关键词过滤，↑/↓ 移动，Enter 确认）： │ > anthropic/claude-sonnet-4-5 │ anthropic/claude-opus-4-1 │ openai/gpt-4o │ google/gemini-2.5-pro └ 已切换到 anthropic/claude-sonnet-4-5
Die Modelle in der Liste hängen von den Anbietern ab, die Sie konfiguriert haben; die tatsächliche Anzeige kann vom Beispiel abweichen.
Schneller zyklischer Wechsel (Ctrl+P)
Ctrl+PZyklisch vorwärts durch Modelle wechseln,Shift+Ctrl+Prückwärts wechseln.
Der Wechselbereich wird durch den Befehl/scoped-modelsoder die EinstellungenenabledModelsgesteuert.
Reasoning-Stufe (Shift+Tab)
Shift+TabDurch die Reasoning-Stufen wechseln.
Die Rahmenfarbe des Editors ändert sich mit der Stufe und vermittelt Ihnen ein intuitives Gefühl für die aktuelle Reasoning-Tiefe:
| Stufe | Anwendungsszenario |
|---|---|
| off | Kein Reasoning (allgemeine Aufgaben) |
| minimal / niedrig | Leichtes Reasoning (Routine-Coding) |
| mittel | Moderates Reasoning |
| hoch / xhigh | Tiefes Reasoning (komplexe Probleme) |
| max | Maximales Reasoning (extrem komplexe Logik) |
Drücken Sie im /thinking-Selektor Ctrl+S, um die aktuelle Stufe als Standard beim Start zu speichern.
Vom Modell nicht unterstützte Reasoning-Stufen werden nicht wirksam und erscheinen nicht in der Umschaltliste.
Die Fähigkeiten des Modells bestimmen die Obergrenze der Reasoning-Ebenen.
Shell-Befehlsintegration
Sie können Shell-Befehle direkt im Editorbereich ausführen, ohne Pi Agent zu verlassen:
| Präfix | Verhalten | Ausgabebehandlung | Anwendungsfall |
|---|---|---|---|
| ! | Führen Sie den Befehl aus und senden Sie die Ausgabe an die KI | Für die KI sichtbar | Lassen Sie die KI Testergebnisse, Lint-Ausgabe, Git-Status anzeigen |
| !! | Führen Sie den Befehl aus, ohne die Ausgabe an die KI zu senden | Nur lokale Anzeige | Dateien öffnen, Umgebung anzeigen, schnelle Prüfungen |
Anwendungsbeispiel:
!npm test !git diff --stat !python -m pytest -v !!cat ~/.zshrc !!ls -la
Unten führen Sie!npm testaus; der tatsächliche Effekt nach der Ausführung: Die Ausgabe wird lokal angezeigt und auch an die KI übergeben.
!npm test > [email protected] test > vitest run PASS src/utils/format.test.ts (6 tests) 12ms PASS src/utils/parse.test.ts (4 tests) 8ms Test Files 2 passed (2) Tests 10 passed (10)
!Die Befehlsausgabe verbraucht das Kontextfenster der KI.
Wenn die Ausgabe groß ist (z. B. vollständige Protokolle), erwäge,!!zu verwenden, oder leite die Ausgabe in eine Datei um und lasse die KI sie dann lesen.
Deep Dive in die Nachrichtenwarteschlange
Die Nachrichtenwarteschlange ermöglicht es dir, Anweisungen zu senden, während die KI arbeitet, was die Interaktionseffizienz erheblich verbessert:
| Nachrichtentyp | Tastenkürzel | Auslösezeitpunkt | Typisches Szenario |
|---|---|---|---|
| Steuerung | Enter | Wird eingefügt, nachdem alle Tool-Aufrufe in der aktuellen Runde ausgeführt wurden, vor dem nächsten LLM-Aufruf | Wenn die KI eine Sequenz von read → edit → bash-Aufrufen ausführt und du ihre Richtung mittendrin korrigieren möchtest |
| Folgeanfrage | Alt+Enter | Wird erst eingefügt, nachdem die KI alle Arbeit abgeschlossen hat (keine weiteren Tool-Aufrufe mehr auszuführen) | Neue Anforderungen anhängen, nachdem die KI die aktuelle Aufgabe beendet hat |
| Abbrechen und abrufen | Escape | Die aktuelle Operation abbrechen und die in der Warteschlange befindlichen Nachrichten zurück in den Editor-Bereich abrufen | Sofort anhalten, wenn die KI vom Kurs abkommt, und die in die Warteschlange gestellten Anweisungen zurückholen |
| Nur in der Warteschlange befindliche Nachrichten abrufen | Alt+Up | Brechen Sie den aktuellen Vorgang nicht ab, sondern geben Sie nur die in der Warteschlange befindlichen Nachrichten an den Editorbereich zurück | Wenn Sie in die Warteschlange gestellte Inhalte umschreiben möchten, aber die KI nicht unterbrechen müssen |
Sie können in den Einstellungen mitsteeringModeundfollowUpModedie Nachrichtenversandstrategie steuern.
Unter Windows und WSL wird Alt+Enter oft vom Terminal belegt (zum Beispiel belegt Windows Terminal es standardmäßig mit der Vollbildumschaltung). In diesem Fall ist Ctrl+Q tatsächlich die Standardtaste zum Senden von Follow-up-Nachrichten.
Editor-Funktionen
Der Editorbereich bietet erweiterte Funktionen wie Dateireferenzen, Pfadvervollständigung und mehrzeilige Eingabe, wodurch weniger zwischen Tools gewechselt werden muss.
| Merkmal | Bedienmethode |
|---|---|
| Dateireferenzsuche | Geben Sie @ ein, um die Fuzzy-Suche nach Projektdateien auszulösen |
| Pfad-Autovervollständigung | Tab drücken, um Pfade automatisch zu vervollständigen |
| Mehrzeilige Eingabe | Shift+Enter für eine neue Zeile (in Windows Terminal Ctrl+Enter verwenden) |
| Bild einfügen | Ctrl+V (Windows verwendet Alt+V, WSL ebenfalls Alt+V) oder ein Bild in das Terminal ziehen und ablegen |
| KI-Antwort kopieren | Ctrl+X kopiert die aktuell ausgewählte Nachricht in /tree und kopiert in anderen Szenarien die letzte KI-Antwort |
| Externer Editor | Ctrl+G öffnet einen externen Editor, um den aktuellen Inhalt zu bearbeiten |
Weitere ErweiterungenBei mehrzeiliger Eingabe ist "Windows Terminal verwendet Ctrl+Enter" eine automatische Anpassung unter Windows Terminal, nicht der Standardwert in keybindings.json.