Eine Konversationssitzung erstellen

Konversationssitzungen sind der leichteste Einstieg in HagiCode. Wähle ein Projekt, stelle eine Frage und lass einen Agent das Repository lesen und antworten. Du entscheidest pro Sitzung, ob der Agent Dateien ändern darf.

Voraussetzungen

Bevor du eine Konversationssitzung startest, stelle sicher, dass du Folgendes erledigt hast:

• eine beliebige Installationsmethode (Microsoft Store oder Desktop) gemäß der Installationsanleitung abgeschlossen
• das Wizard Setup abgeschlossen, das deinen ersten Agent und mindestens ein Projekt erstellt
• dieses Projekt auf dem Sitzungsboard ausgewählt

Wofür dient eine Konversationssitzung?

Eine Konversationssitzung eignet sich am besten, wenn du zuerst verstehen und erst später ändern möchtest. Typische Einsatzzwecke sind:

• ein unbekanntes Repository schnell analysieren
• eine gezielte Frage zu einer Datei, einem Modul oder einem Fehler stellen
• eine kleine Änderung vornehmen, ohne sie als Proposal zu planen
• vor dem Senden Bilder, Standardphrasen oder frühere Nachrichten anhängen

Wenn deine Aufgabe bereits vom „Problem verstehen“ zum „strukturierte Änderung planen, prüfen und archivieren“ übergegangen ist, fahre mit Proposal-Sitzung erstellen fort. Diese Seite behandelt nur Konversationssitzungen.

Ablauf im Überblick

Phase	Was du tust	Was passiert
Erstellen	Klicke auf Create Normal Session und beschreibe, was du möchtest	Die Seitenleiste (Drawer) erfasst das Projekt, einen optionalen Titel, den Umfang und deine erste Nachricht
Starten	Wähle einen Agent unter Available Agents	Die Sitzung startet sofort und erscheint in der Spalte Execution
Lesen	Öffne die Sitzungskarte	Der Agent liest das Repository und antwortet; eine Session Complete-Karte fasst den Durchlauf zusammen
Entscheiden	Nutze den Modusschalter neben dem Nachrichtenfeld	Bleibe im Nur-Lese-Modus oder aktiviere den Bearbeitungsmodus, damit der Agent Dateien ändern darf
Kontext ergänzen	Nutze die Schaltflächen für Bild, Standardphrasen und Verlauf	Deine nächste Nachricht enthält mehr Kontext

Schritt 1: Die Sitzung erstellen

Wähle dein Projekt aus und klicke dann in der Symbolleiste über dem Board auf Create Normal Session (das Sprechblasen-Symbol).

Fülle den Drawer aus:

• Project (erforderlich) – standardmäßig das ausgewählte Projekt.
• Session title – optional; er wird zum Titel der Karte auf dem Board.
• Task scope – optional. Repos beschränkt die Sitzung auf Repositories eines MonoSpecs-Projekts, während Vault und Projects zusätzliches Referenzmaterial anhängen.
• What do you want to do? (erforderlich) – deine erste Nachricht. Mit Upload Image hängst du ein Bild an.

Das Panel Available Agents öffnet sich neben dem Drawer. Klicke auf einen Agent, und die Sitzung startet sofort. Die erste Karte ist der Laufzeit-Standard; über die zweite Liste kannst du für diesen einen Durchlauf einen anderen Agent wählen. Du kannst auch mit Ctrl/⌘ + Enter per Tastatur absenden.

Beginne mit einer Frage, nicht mit einer Änderung

Eine erste Nachricht wie „Was macht dieses Projekt in zwei Sätzen? Ändere keine Dateien.“ ist ein sicherer Weg, um zu prüfen, ob dein Agent und dein Projekt korrekt eingerichtet sind.

Schritt 2: Das Ergebnis lesen

Die neue Sitzung erscheint als Karte in der Spalte Execution mit einem Statusabzeichen. Klicke darauf, um die Sitzung zu öffnen.

• Die Kopfzeile zeigt Titel und Agent mit Archive, Delete Session, Open Code Server und einem …-Menü.
• Die Konversation listet deine Nachricht, die Tool-Aufrufe des Agents als kompakte Protokollzeilen und seine Antwort auf.
• Eine Session Complete-Karte schließt jeden Durchlauf mit der Anzahl der Turns, der verstrichenen Zeit und den Kosten ab. Klicke darauf, um die Details aufzuklappen.
• Die Agent-Statuskarte rechts neben dem Nachrichtenfeld zeigt die Agent-CLI, das Modell, den Zustand (zum Beispiel Idle) und die verstrichene Zeit.

Gib im Nachrichtenfeld eine Folgenachricht ein. Mit Enter sendest du ab, mit Shift + Enter beginnst du eine neue Zeile.

Schritt 3: Nur-Lese- oder Bearbeitungsmodus wählen

Der Schalter links neben dem Nachrichtenfeld hat zwei Stellungen. Das Auge steht für Nur-Lese-Modus: Der Agent kann untersuchen und erklären, ändert aber keine Dateien. Der Stift steht für den Bearbeitungsmodus: Neue Nachrichten führen eher dazu, dass Dateien geändert oder die aktuelle Implementierung angepasst werden.

Der Modus gilt für die Sitzung, in der du dich befindest, und du kannst ihn zwischen Nachrichten ändern. Ob neue normale Sitzungen im Bearbeitungsmodus starten, steuerst du über Settings → Sessions and conversation → Chat View → Default to Edit Mode for Normal Chats. Siehe Einstellungen.

Das sicherere Vorgehen ist einfach: Bestätige zuerst im Nur-Lese-Modus die Richtung und wechsle erst dann in den Bearbeitungsmodus, wenn du tatsächlich Änderungen möchtest.

Schritt 4: Kontext vor dem Senden ergänzen

Drei Schaltflächen neben dem Modusschalter ergänzen deine nächste Nachricht um Kontext:

• Insert an image attachment (Bildanhang einfügen) – hänge einen Screenshot, eine Fehleraufnahme oder eine Designvorlage an. Das Bild erscheint mit Dateiname und Größe über dem Nachrichtenfeld, und du kannst es vor dem Senden mit dem × entfernen.
• Standard Phrases (Standardphrasen) – fügt eine @-Referenz ein. Die Auswahl bietet Projects (einen kanonischen Projektstammpfad), Vaults (einen registrierten Vault-Pfad), Proposal Sessions (einen OpenSpec-Änderungsordner) und Recent Items.
• Import Recent History (Letzten Verlauf importieren) – verwendet eine der letzten Nachrichten dieser Sitzung erneut, damit du sie nicht noch einmal tippen musst.

Bilder sind nützlich, wenn du:

• den Agent bitten möchtest, einen Screenshot einer Oberfläche zu erklären
• einen Fehler-Screenshot oder ein Design-Mockup anhängen und weitere Anweisungen ergänzen möchtest
• visuellen Kontext liefern möchtest, bevor du in den Bearbeitungsmodus wechselst

Typischer Ablauf

1. Erstelle die Sitzung über die Symbolleiste und wähle einen Agent.
2. Starte im Nur-Lese-Modus mit einer Frage zum Projekt.
3. Lies die Antwort und stelle dann Folgefragen.
4. Aktiviere den Bearbeitungsmodus nur, wenn direkte Dateiänderungen nötig sind.
5. Ergänze Bilder, Standardphrasen oder Verlauf, um der nächsten Nachricht mehr Kontext zu geben.
6. Archiviere die Sitzung, wenn du fertig bist; sie wandert dann in die Spalte Archived.

Wenn die Aufgabe nun Planung, Prüfung und Archivierungsdisziplin erfordert, fahre mit der Anleitung zur Proposal-Sitzung fort.

Nächste Schritte

Proposal-Sitzung erstellenFahre hier fort, wenn das Projektverständnis vollständig ist und du eine Anfrage in einen strukturierten Plan überführen möchtest.

SitzungenDie vollständige Tour durch das Sitzungsboard, die Layouts und den Sitzungs-Drawer.