Zum Inhalt springen

Planmodus nutzen

Diese Anleitung zeigt, wie du von einem Agenten einen strukturierten Plan bekommst, bevor er irgendeinen Code schreibt.

Im Plan-Modus recherchiert der Agent nur lesend, und sein einziges Lieferergebnis ist ein typisierter Plan: ein Abhängigkeitsgraph aus Schritten, den du freigibst und den Control Center danach in echte Arbeit kompiliert. Nimm ihn, wenn du den Umfang einer Änderung sehen, die Schritte zerlegt haben oder Risiken und Abhängigkeiten benannt haben willst, bevor irgendetwas angefasst wird.

Jedes davon schaltet den Modus des Bereichs um, und die Änderung wird gespeichert:

  • Wähle Plan im Modus-Dropdown ganz links in der Leiste des Composers
  • Drücke Umschalt+Tab
  • Sende /plan. Ein bloßes /plan schaltet den Modus nur ein; /plan <request> schaltet ihn ein und schickt den Rest als deine Nachricht

/plan reist nie als Text. Es setzt den gespeicherten Modus, und genau den lesen die Werkzeugfläche, die Modus-Voreinstellung der Schutzregeln und der Prompt. Der Modus gilt für diesen Zug und für jeden Zug danach, bis du ihn wieder umschaltest.

Der Modus liegt am Bereich. Derselbe Agent kann hier im Plan-Modus und anderswo im Agent-Modus sein.

  1. Er recherchiert nur lesend: Gedächtnis, der Code-Index, Dateien
  2. Er ruft submit_plan einmal auf, mit einem goal und nodes. Jeder Knoten trägt einen stabilen key, einen title, eine description und die Knotenschlüssel, von denen er dependsOn (genau das lässt unabhängige Arbeit parallel laufen)
  3. Er hält an

Das Werkzeug prüft den Graphen (doppelte Schlüssel, hängende Abhängigkeiten, Zyklen) und gibt Verstöße zurück, die der Agent beheben soll, statt einen kaputten Plan anzunehmen.

Der Plan erscheint in der Unterhaltung als kompakte Zeile mit dem Ziel, seinem Status und der Schrittzahl. Plan-Studio (der Abhängigkeitsgraph, der Inspektor je Knoten und die Kostenschätzung) öffnet sich als Tab neben der Unterhaltung: drücke Öffnen in der Zeile, oder warte einfach. Ein Plan, der innerhalb von 30 Sekunden eintrifft, während du die Unterhaltung ansiehst, öffnet seinen Tab von selbst.

Prosa ist hier kein Lieferergebnis. Ein Lauf, der endet, ohne submit_plan aufzurufen, schreibt eine sichtbare Zeile „Ended without submitting a plan (no submit_plan call).“ in die Unterhaltung und kennzeichnet den Lauf als einen, der sein Lieferergebnis verfehlt hat. Der Status des Laufs bleibt absichtlich completed, damit die Zustandsmaschinen von Pipeline und Ticket unberührt bleiben. Was gilt, steht in der Zeile.

Drücke in der Planzeile in der Unterhaltung Genehmigen und starten. In der Freigabeleiste von Plan-Studio drücke Plan genehmigen (oder daneben Ablehnen; die Freigabe ist gesperrt, solange der Graph einen Validierungsfehler hat).

Danach:

  1. Control Center kompiliert den Plan zu einer Orchestrierung und materialisiert sie, also die Tickets und den Lauf. An diesem Schritt ist kein Modell beteiligt. Er ist deterministisch
  2. Der Plan läuft als der Agent, der ihn geschrieben hat. Ob noch jemand dazukommt, entscheidet dieser Agent zur Laufzeit. Er kann einen Schritt mit delegate_task an einen besser geeigneten Agenten geben, innerhalb der Tiefenobergrenze der Delegation im Arbeitsbereich
  3. Das Ziel des Plans wird das Ziel der Unterhaltung, und die Arbeit läuft in derselben Unterhaltung: jeder Schritt schreibt, worum der Agent gebeten wurde, und streamt seinen Zug zurück. Du folgst ihm dort, wo du schon bist, und kannst einen Zug auch dort stoppen
  4. Die Zielzeile im Seitenpanel Allgemein der Unterhaltung (unter Aufgaben) trägt den Fortschritt des Laufs als settled/total und seine Stopp-Schaltfläche. Plan-Studio zeigt den Zustand je Knoten am Graphen und bricht dort ebenfalls ab

Willst du in dieser Unterhaltung bleiben, statt den Plan freizugeben, kann der Agent exit_plan_mode aufrufen. Das ist der einzige vorgesehene Ausgang: er öffnet eine dauerhafte Freigabeanfrage, die an der Unterhaltung hängt, und gibt pending zurück. Der Bereich bleibt im Plan-Modus, und der Agent darf nicht handeln. Ist die Anfrage freigegeben, schaltet der nächste Aufruf von exit_plan_mode den Bereich vom Plan-Modus in den Agent-Modus und gibt seine verändernden Werkzeuge frei. Eine Ablehnung lässt ihn eine neue Anfrage gegen einen überarbeiteten Plan öffnen.

Den Plan-Modus verlässt du über das Dropdown im Composer (oder Umschalt+Tab) oder indem du den eingereichten Plan freigibst. exit_plan_mode öffnet eine dauerhafte Freigabe, über die das MCP-Tool decide_approval entscheidet. Das Overlay der Schutzregeln für blockierte Werkzeugaufrufe ist eine andere Warteschlange im Speicher und trägt keine Plan-Ausstiegsanfragen.

Ein Pipeline-Knoten messaging.createSpace liest den Unterhaltungsmodus aus dem Extra mode der Knotenkonfiguration: extras['mode']: 'plan'. Der Schlüssel muss exakt passen. Jede andere Schreibweise, auch conversationMode oder dispatchMode, wird stillschweigend ignoriert, und der Raum fällt auf die Vorgabe des Bodys zurück. Das ist der Modus review, nicht Chat. Ein Schritt promptAgent tritt einem Raum bei, den er nicht angelegt hat, und setzt dessen Berechtigungen nicht neu. Die Auswahl Verteilungsmodus im Editor der Knotenkonfiguration (allParallel / manager) gilt für Knoten Team dispatch. Den Unterhaltungsmodus setzt du mit extras['mode'] an einer Vorlage, die den Bereich öffnet, oder über die API an der Konfiguration dieses Knotens.