Start / Seminare / Pi Coding Agent Praxis
Modul
Session Management
8 Kapitel in diesem Modul-Video · Laufzeit
Transkript
Der gesprochene Text dieses Moduls zum Mitlesen, Überfliegen und Durchsuchen. Ein Klick auf einen Zeitstempel springt an die Stelle im Video.
Fortgeschrittenes Session Management
0:00 Dieses Modul behandelt die aus meiner Sicht auffälligste Besonderheit von Pi: den Session-Baum. Bei den meisten Werkzeugen ist ein Gespräch eine Liste — oben alt, unten neu. Bei Pi ist es ein Baum, in dem Sie zurückgehen, abzweigen und Alternativen nebeneinander verfolgen können. Der Leitsatz lautet deshalb: Eine Session ist ein Baum, kein Protokoll.
0:20 Wir schauen uns an, wie Sessions gespeichert werden, wie man Arbeit wieder aufnimmt, was Klonen von Verzweigen unterscheidet — und wie lange Sitzungen durch Zusammenfassung beherrschbar bleiben.
Sessions beherrschen
0:32 Acht Kapitel. Und ein Hinweis, warum sich dieser Aufwand lohnt: Der Baum ist kein Selbstzweck. Er löst ein reales Problem — dass man in einer längeren Arbeitssitzung irgendwann in eine Richtung läuft, die nicht trägt, und dann entweder alles verwirft oder mit einem verunreinigten Verlauf weiterarbeitet. Mit einem Baum können Sie zurück zur Gabelung gehen, ohne das Bisherige zu verlieren.
0:54 Am Ende des Moduls sollten Sie drei Werkzeuge sicher unterscheiden können, die man leicht verwechselt: Baum, Verzweigung und Klon. Vier Punkte. Erstens die Speicherung: Textdateien im Zeilenformat, jeder Eintrag mit eigener und mit Elternkennung, dazu ein aktives Blatt — die technische Grundlage für alles Weitere. Zweitens die Wiederaufnahme mit ihren vier Wegen. Drittens die drei Verzweigungswerkzeuge, die tatsächlich drei verschiedene Dinge tun.
1:21 Und viertens die Compaction, also die automatische Zusammenfassung, samt ihren Einstellwerten. Der letzte Punkt erklärt nebenbei ein Phänomen aus Modul fünf: warum ein Agent Absprachen zu vergessen scheint.
Sessions als Arbeitskontext verstehen
1:34 Beginnen wir mit der Grundlage. Wo liegen Sessions, und welche Struktur haben sie? Beides ist erfreulich transparent — Sie können jederzeit selbst nachsehen. Pi speichert Gespräche automatisch als Textdateien im Zeilenformat, in einem Verzeichnis unterhalb des persönlichen Pi-Ordners, organisiert nach Arbeitsverzeichnis.
1:54 Jeder Eintrag hat eine eigene Kennung und die Kennung seines Vorgängers; die aktuelle Position ist das aktive Blatt des Baums. Der Vergleich: ein Laborbuch, in dem Sie an einer Stelle einen zweiten Ast beginnen können, ohne die erste Versuchsreihe zu durchstreichen. Und weil es Textdateien sind, können Sie sie lesen, sichern und weitergeben.
2:14 Vier Punkte. Arbeit ist nicht flüchtig — Sie können Tage später fortsetzen, ohne neu zu erklären. Die Baumstruktur erlaubt Alternativen ohne Kopieren. Es gibt eine Startoption für einen bewusst flüchtigen Lauf, wenn Sie ausdrücklich keine Spur wollen — für eine kurze Frage genau richtig. Und Sessions können benannt werden, beim Start oder später.
2:35 Diesen letzten Punkt unterschätzen fast alle: Zwanzig unbenannte Sitzungen sind nach einer Woche nicht mehr auseinanderzuhalten. Das Prinzip dieser Tabelle ist Abgrenzung — und sie ist der Kern des ganzen Moduls. Der Baum arbeitet innerhalb einer Datei und erzeugt Alternativen. Die Verzweigung erzeugt eine neue Datei ab einer früheren Nachricht. Das Klonen verdoppelt den aktuellen Ast in eine eigene Datei.
3:00 Und die Zusammenfassung kürzt den Kontext, ohne zu verzweigen. Die Fußnote gibt die Regel: Erst den Zweck klären, dann das Werkzeug wählen. Diese vier sind nicht vier Namen für dasselbe, sondern vier verschiedene Operationen.
Bestehende Arbeit wieder aufnehmen
3:15 Jetzt der Handgriff, den Sie täglich brauchen werden. Es gibt vier Wege zurück in eine Sitzung — und einer davon ist so kurz, dass er sich schnell einprägt. Es gibt drei Wege beim Start: die letzte Sitzung fortsetzen, die Auswahl durchsuchen oder eine bestimmte Sitzung per Pfad oder Kennung ansprechen. In der laufenden Sitzung öffnet ein eigener Befehl den Auswahldialog für das aktuelle Projekt.
3:38 Der Vergleich: Sie schlagen das Laborbuch an der letzten Seite auf — oder blättern gezielt zu einem Versuch, an den Sie sich erinnern. Und weil Sitzungen je Arbeitsverzeichnis getrennt liegen, sehen Sie im Projekt nur die Sitzungen dieses Projekts. Der Auswahldialog kann mehr, als man zunächst sieht: suchen, sortieren, umbenennen.
3:57 Es gibt Tastenkürzel, um auf benannte Sitzungen zu filtern und um zu löschen — Aufräumen gehört dazu, sonst wächst die Liste ins Unübersichtliche. Weitere Kürzel zeigen Pfade und ändern die Sortierung. Und der praktische Rat zum Schluss: Benannte Sitzungen sind nach Tagen noch verständlich, unbenannte nicht. Nehmen Sie sich die drei Sekunden für einen Namen; sie zahlen sich in der Woche darauf aus.
4:21 Worauf es hier ankommt, sind fünf verschiedene Absichten in fünf Zeilen. Die kürzeste Option setzt einfach fort — das ist Ihr Standardhandgriff morgens. Die zweite öffnet die Suche. Die dritte springt per Teilkennung direkt an eine bestimmte Sitzung, praktisch wenn Sie eine Kennung aus einem Ticket haben. Die vierte vergibt beim Start einen Namen. Und die fünfte ist die flüchtige Variante für eine kurze Frage.
4:45 Die Fußnote erinnert an ein Detail mit Überraschungspotenzial: Das Arbeitsverzeichnis entscheidet mit, welche Sitzungen Sie sehen.
Nachrichten gezielt steuern
4:54 Jetzt eine feine Unterscheidung, die im Alltag viel Reibung nimmt. Es gibt drei verschiedene Arten, Text in eine laufende Arbeit zu geben — und die Programmierschnittstelle benennt sie ausdrücklich. Die drei Begriffe stehen so in der Schnittstelle: eine Aufgabe stellen, die laufende Arbeit lenken, eine Anschlussaufgabe anhängen.
5:13 Diese Dreiteilung ist eine gute Denkhilfe, auch wenn Sie interaktiv arbeiten. Der Vergleich: Sie geben einen Auftrag, Sie rufen dem Kollegen etwas hinterher, während er arbeitet — oder Sie sagen ihm, was er danach machen soll. Drei völlig verschiedene Dinge, die man im Chatfenster leicht in eine Nachricht mischt. Und genau diese Mischung ist die Ursache widersprüchlicher Ergebnisse.
5:35 Lenken ist billiger als abbrechen und neu formulieren — das gilt für Tokens wie für Ihre Zeit. Eine Anschlussaufgabe hält den erarbeiteten Kontext, statt ihn wegzuwerfen. Ein neuer Auftrag mitten im Lauf erzeugt widersprüchliche Ziele, und das Modell entscheidet dann selbst, welches gilt. Und der vierte Punkt ist eine Geduldsempfehlung: Wer zu früh eingreift, verliert brauchbare Zwischenergebnisse.
5:59 Lassen Sie den Agenten den Gedanken zu Ende bringen, wenn er in eine plausible Richtung läuft. Vier Fehler beim Steuern. Drei Aufträge in einer Nachricht — dann priorisiert der Agent, und zwar nicht unbedingt wie Sie. Lenken, ohne den Grund zu nennen; ein „nein, anders" erzeugt eine zufällige Variation statt einer Korrektur.
6:19 Themenwechsel per Nachschub statt in einer neuen Sitzung, wodurch der alte Kontext mitwirkt. Und widersprüchliche Korrekturen, ohne die alte zurückzunehmen — das ist der häufigste, weil man vergisst, was man vor zehn Minuten gefordert hat. Ein Satz wie „vergiss die vorige Anweisung" hilft mehr, als man denkt.
Aufgaben in Warteschlangen organisieren
6:39 Jetzt ein Kapitel über etwas, das Pi bewusst nicht mitbringt: eine Aufgabenverwaltung. Die Ordnung müssen Sie selbst herstellen — und dafür gibt es einen guten Grund. Pi hat keine eingebaute To-do-Verwaltung; das steht ausdrücklich unter den Weglassungen. Reihenfolge und Warteschlange organisieren Sie also selbst: eine Aufgabe in Arbeit, die nächsten als Anschlussaufgaben oder als Notiz im Projekt — oder über eine Erweiterung, die genau das ergänzt.
7:06 Meine Einschätzung: Für die meisten Teams ist die Notiz im Repository sogar besser als eine Liste im Werkzeug. Denn eine Liste im Werkzeug sieht nur, wer das Werkzeug offen hat. Parallele Aufträge in einer Sitzung verwässern den Kontext — Sie kennen das Prinzip aus Modul fünf. Eine Liste im Repository ist reviewbar, ein Chatverlauf nicht; sie ist damit auch für Kolleginnen und Kollegen sichtbar.
7:30 Anschlussaufgaben halten die Reihenfolge sichtbar, statt sie im Kopf zu behalten. Und getrennte Themen verdienen getrennte Sitzungen. Wenn Sie merken, dass Sie in einer Sitzung zwei Dinge gleichzeitig verfolgen, ist das ein guter Zeitpunkt für einen Schnitt. Der rote Faden: schriftlich, sortiert, sequenziell. Sie sammeln Aufgaben schriftlich — im Repository, nicht im Verlauf. Die Reihenfolge ergibt sich aus Abhängigkeiten.
7:55 Dann bearbeiten Sie eine Aufgabe je Sitzung und schließen sie ab. Anschlussaufgaben stellen Sie erst nach der Abnahme des Schritts, nicht vorher; das verhindert, dass auf einem unfertigen Zustand aufgebaut wird. Und Erledigtes wird gestrichen, damit Offenes sichtbar bleibt. Die Fußnote nennt den Ausweg für Anspruchsvolle: Wer eine Warteschlange im Werkzeug will, baut sie als Erweiterung.
Sessions klonen
8:19 Jetzt das erste der drei Verzweigungswerkzeuge. Klonen ist das einfachste — und wenn Sie den Unterschied zu den anderen beiden kennen, greifen Sie später sicher zum richtigen. Der Klon-Befehl verdoppelt den aktuell aktiven Ast in eine eigene Sitzungsdatei. Beide Sitzungen haben denselben Vorlauf, entwickeln sich danach aber unabhängig weiter.
8:40 Der Vergleich: Sie kopieren ein halbfertiges Dokument, um zwei Fassungen zu schreiben. Nichts wird geteilt, nichts wirkt zurück — es sind zwei getrennte Dateien. Das ist der Unterschied zum Baum, wo alles in einer Datei bleibt. Und es ist der Unterschied zur Verzweigung, die an einer früheren Stelle ansetzt. Nützlich ist das Klonen, wenn ein erarbeiteter Stand als Ausgangspunkt mehrfach dienen soll — etwa ein Kontext, für den Sie zwanzig Minuten Analyse gebraucht haben.
9:09 Der ursprüngliche Verlauf bleibt unangetastet. Und ein praktischer Hinweis: Zwei Dateien heißen zwei Namen. Wer nicht benennt, verwechselt sie garantiert. Wenn Sie hingegen Alternativen innerhalb einer Datei wollen, ist der Baum das richtige Mittel — dazu kommen wir in zwei Kapiteln. In dieser Übung sichern Sie einen erarbeiteten Kontext als Startpunkt für zwei unabhängige Arbeiten.
9:32 Das Erfolgskriterium ist mechanisch prüfbar: zwei benannte Sitzungen, beide mit dem gemeinsamen Vorlauf, je eine eigene Fortsetzung. Der Lerneffekt liegt im Benennen — und darin, hinterher zu merken, wie schnell man ohne Namen die Orientierung verliert. Nehmen Sie eine echte Analyse aus Ihrem Projekt als Ausgangspunkt, dann haben Sie am Ende zwei nützliche Sitzungen statt einer Übung.
Alternative Lösungswege über Forks untersuchen
9:55 Jetzt das Werkzeug, das ich am spannendsten finde: die Verzweigung. Sie erlaubt etwas, das mit einem linearen Verlauf gar nicht geht — denselben Auftrag zweimal unter geänderten Bedingungen zu stellen. Der Verzweigungsbefehl erzeugt eine neue Sitzungsdatei ab einer früheren Nutzernachricht; beim Start gibt es dieselbe Möglichkeit als Option.
10:16 So lässt sich derselbe Auftrag erneut durchspielen — mit anderem Modell, anderer Denktiefe oder anderer Formulierung. Der Vergleich: das kontrollierte Experiment. Gleiche Ausgangslage, eine geänderte Variable, vergleichbares Ergebnis. Das ist etwas, das man in der Arbeit mit Sprachmodellen selten hat und ausgesprochen nützlich ist, sobald man Entscheidungen begründen muss.
10:38 Vergleichbarkeit ist der Gewinn: gleicher Ausgangspunkt, andere Variable. Das macht Verzweigungen ideal für Modellvergleiche — genau die Frage aus Modul zwei, welches Modell sich für welche Aufgabe lohnt — und für Entwurfsalternativen. Der ursprüngliche Weg bleibt vollständig erhalten, Sie riskieren also nichts. Und die Ergebnisse lassen sich über den Export-Befehl nebeneinanderlegen und im Team diskutieren.
11:02 Damit wird aus einem Bauchgefühl eine Entscheidungsgrundlage. Der rote Faden ist wissenschaftliche Disziplin im Kleinen. Sie arbeiten bis zum Entscheidungspunkt und benennen den Stand. Dann setzen Sie die Verzweigung an der letzten gemeinsamen Nachricht an. Im Zweig ändern Sie genau eine Variable — das ist die entscheidende Regel.
11:23 Beide Ergebnisse prüfen Sie gegen dasselbe Kriterium, das Sie vorher festgelegt haben. Und dann führen Sie den Gewinner weiter und behalten den Verlierer als Notiz. Die Fußnote sagt es unmissverständlich: eine Variable je Zweig, sonst ist der Vergleich wertlos.
Session Trees navigieren
11:39 Jetzt das dritte Werkzeug und das Herzstück: der Baum. Damit können Sie einen Irrweg verlassen, ohne die Sitzung zu verwerfen — und das ist im Alltag überraschend oft nützlich. Der Baum-Befehl zeigt die Struktur der aktuellen Sitzung. Navigiert wird mit den Pfeiltasten, Zweige lassen sich falten, und man kann Beschriftungen setzen.
11:59 Wichtig ist die Auswahl-Logik: Wählen Sie eine Nutzernachricht, landet ihr Text im Editor — Sie können ihn also verändert erneut abschicken. Wählen Sie einen Eintrag des Agenten, wandert das aktive Blatt an diese Stelle, und Sie arbeiten von dort weiter. Der Vergleich: ein Lesezeichen mit Radiergummi. Sie gehen zurück und schreiben von dort weiter, ohne das Alte zu löschen.
12:22 Ein Irrweg lässt sich verlassen, ohne die Sitzung zu verwerfen — der Hauptgewinn. Beschriftungen machen Verzweigungen später verständlich, was bei drei oder vier Ästen schnell wichtig wird. Der Wechsel des aktiven Blatts verändert nur den weiteren Verlauf, nicht das Vergangene. Und alles bleibt in einer Datei — kein Dateisalat, anders als beim Klonen.
12:41 Das ist der Grund, warum ich für Alternativen innerhalb einer Aufgabe immer den Baum empfehle und die Verzweigung für echte Experimente reserviere. In dieser Übung kehren Sie innerhalb einer Sitzung zu einem früheren Stand zurück und setzen von dort einen anderen Weg fort. Das Erfolgskriterium verlangt zwei markierte Zweige — also auch die Beschriftung, damit Sie hinterher noch wissen, welcher welcher ist.
13:04 Und wer mag, nimmt die Stretch-Variante und lässt den verlassenen Zweig zusammenfassen. Damit sind wir schon beim letzten Kapitel: Genau diese Zusammenfassung beim Zweigwechsel ist eine der eleganteren Funktionen von Pi.
Lange Sessions durch Zusammenfassungen und Compaction beherrschbar halten
13:17 Zum Abschluss die Mechanik, die lange Sitzungen überhaupt möglich macht. Und gleichzeitig die Erklärung für das Phänomen des „vergesslichen" Agenten aus Modul fünf. Nähert sich der Kontext dem Limit, fasst Pi älteren Verlauf zusammen. Automatisch geschieht das, wenn der Kontext das Fenster minus einer Reserve übersteigt — die Reserve liegt standardmäßig bei etwa 16.000 Tokens.
13:41 Ein zweiter Wert bestimmt, wie viel jüngster Verlauf ungekürzt bleibt: rund 20.000 Tokens. Und es gibt einen Befehl für die manuelle Zusammenfassung, optional mit Fokus. Der Vergleich: das Protokoll einer langen Besprechung. Die Beschlüsse bleiben, die Nebensätze gehen. Die Zusammenfassung wird als Eintrag angehängt — nichts wird gelöscht, die Datei bleibt vollständig.
14:04 Schnittpunkte liegen nie zwischen Werkzeugaufruf und Ergebnis, weil diese beiden zusammengehören; ein durchdachtes Detail. Beim Wechsel zwischen Zweigen kann Pi den verlassenen Zweig zusammenfassen und die Zusammenfassung an der neuen Stelle anhängen — Sie nehmen also das Gelernte mit, ohne den ganzen Irrweg erneut zu durchlaufen.
14:22 Und die Automatik lässt sich abschalten, der manuelle Befehl bleibt. Worauf es hier ankommt, sind drei Werte mit klarer Bedeutung. Der Schalter für die Automatik. Die Reserve für die Antwort — wer sehr lange Antworten braucht, erhöht sie. Und das Nahgedächtnis, also der ungekürzte jüngste Verlauf; wer viel Detailtreue in der aktuellen Arbeit braucht, erhöht diesen Wert.
14:44 Beachten Sie, dass diese Einstellungen projektlokal gesetzt werden können — ein Projekt mit langen Analysesitzungen darf andere Werte haben als eines mit kurzen. Und die Fußnote zeigt den nützlichsten Handgriff: die Zusammenfassung mit Fokus lenken.
Arbeit, die nicht verloren geht
15:00 Drei Sätze zum Mitnehmen. Sessions sind Textbäume je Arbeitsverzeichnis — und Benennen lohnt sich mehr als jede andere Kleinigkeit in diesem Modul. Baum, Verzweigung und Klon lösen drei verschiedene Aufgaben; wer sie unterscheidet, arbeitet deutlich souveräner. Und die Compaction hält lange Sitzungen arbeitsfähig, statt sie abzuschneiden — mit zwei Werten, die Sie selbst einstellen können.
15:23 Damit ist der inhaltliche Teil des Seminars abgeschlossen. Im letzten Modul führen wir alles an einem echten Projekt zusammen.
Lieber mit Trainer? Dieses Modul ist Teil unserer Team-Schulungen — mit Übungen, Ihrem eigenen Code und Fragen, die ein Video nicht beantwortet. Mehr erfahren →