Zum Inhalt springen
Documentation

Unteragenten, Hintergrundaufgaben und Schleifen

Der Agent kann eine umfangreiche Anfrage in Teile aufteilen, diese parallel ausführen und die Arbeit im Hintergrund fortsetzen, während Sie weiterarbeiten. Alles, was hier beschrieben wird, läuft innerhalb Ihrer Terminalsitzung und wird beendet, sobald die Sitzung endet.

Ein Subagent ist ein separater Agent mit eigenem, neuem Kontext, eigenen Anweisungen und einer eigenen Werkzeugliste. Eve startet Unteragenten, wenn eine Aufgabe von Parallelität profitiert, beispielsweise um mehrere Module einer großen Codebasis zu durchsuchen, Benchmarks auszuführen oder unabhängige Refactorings gleichzeitig durchzuführen. Nur die endgültige Antwort des Unteragenten wird an die Hauptkonversation zurückgegeben, wodurch das primäre Kontextfenster übersichtlich bleibt.

  • Subagenten laufen parallel, standardmäßig bis zu 32 gleichzeitig. Eve kann Stapel paralleler Aufgaben in einem einzigen Durchgang starten, um einen maximalen Durchsatz zu erzielen.
  • Ein Subagent kann eigene Subagenten starten, bis zu zwei Ebenen tief.
  • Unteragenten erhalten niemals mehr Berechtigungen als Ihre Sitzung. Ihre Berechtigungsabfragen werden nacheinander in Ihrem Terminal angezeigt und sind jeweils mit dem Namen des Unteragenten gekennzeichnet.
  • Mehrstündige Arbeitsabläufe und komplexe Unterbrechungen der Gesprächsrunden werden bis zu 2.000 Gesprächsrunden unterstützt.
  • Jeder Zug eines Unteragenten ist ein normaler Agentenzug und wird auf Ihre Limits angerechnet.

AgentToolsNutzen Sie
generalJedes lokale und jedes ToolCHAMPREP, über das die Sitzung verfügt,In sich geschlossene Teile einer größeren Aufgabe.
exploreSchreibgeschützte lokale ToolsSchnelle Suche im Code, die Schlussfolgerungen liefert.
planSchreibgeschütztEin schrittweiser Implementierungsplan.
reviewSchreibgeschützt, plus schreibgeschützt gitÜberprüfung eines Diffs, eines Zweigs oder einer Merge-Anfrage.
platformCHAMPREP Nur Tools; keine lokalen Dateien oder BefehleWork über Ihre DiensteCHAMPREP hinweg.

/agents
/agents run explore where is the invoice total calculated?
@explore where is the invoice total calculated?

@agent-name prompt startet den Agenten als Hintergrundaufgabe und meldet dessen Ergebnis, sobald er abgeschlossen ist. Erstellen Sie Ihre eigenen Agenten mit /agents create NAME; siehe Benutzerdefinierte Agenten.

Bei mehrstufigen Anfragen führt Eve eine Live-Aufgabenliste mit ausstehenden, laufenden und abgeschlossenen Elementen. Drücken Sie Ctrl+T um ihn ein- oder auszublenden oder auszuführen /todos.

Eve kann lang laufende Befehle, wie beispielsweise einen Entwicklungsserver, einen Datei- Watcher, einen Compiler oder umfangreiche Testsuiten, in einer Hintergrund-Shell starten und dabei weiterarbeiten. Er überwacht Ausgaben asynchron und kann auf Muster wie beispielsweise server listening oder FAIL bevor Sie fortfahren.

  • Es können bis zu 64 Hintergrund-Shells gleichzeitig ausgeführt werden.
  • Aktive Hintergrundaktivitäten werden in der Statuszeile angezeigt (z. B. 🐚 2 shells) und aktivieren Sie die Statusübersicht (⚡ 2 shell(s), 3 agent(s) active).
  • Verwenden Sie /shells oder /procs um den speziellen Shell-Inspector zu öffnen, der PIDs, Befehlszeilen, Exit-Codes und Ausgabeverläufe anzeigt.

Führen Sie eine Eingabeaufforderung in der aktuellen Sitzung wiederholt aus:

/loop 5m check whether the deploy finished and summarise any errors
/loop --max 10 30m run the test suite and fix new failures
/loop keep improving test coverage for src/billing
/loop stop
  • Mit einem Intervall zwischen 30s und 24hwird die Aufforderung nach diesem Zeitplan ausgeführt.
  • Ohne Angabe eines Intervalls läuft die Schleife im eigenen Tempo ab: Der Agent entscheidet selbst, wann er das nächste Mal ausgeführt wird, zwischen einer Minute und einer Stunde später.
  • Eine Schleife wird standardmäßig nach 50 Durchläufen beendet; ändern Sie dies mit --max N. Außerdem wird der Vorgang mit /loop stop [id] oder beim Beenden.

Jeder Durchlauf ist ein normaler Zug: Er nutzt Ihre Limits und fragt wie jeder andere Zug nach Ihrer Erlaubnis.

/tasks listet alles auf, was im Hintergrund läuft – Unteragenten, Hintergrund- Shells und Schleifen – einschließlich der verstrichenen Zeit. /shells (oder /procs) konzentriert sich speziell auf aktive und abgeschlossene Shell-Prozesse.

/tasks
/tasks tail ID
/tasks attach ID
/tasks stop ID
/tasks stop all
/shells
/procs

Die Statuszeile zeigt an, wie viele Aufgaben und Shells aktiv sind. /exit warnt Sie, bevor Sie das Programm verlassen, solange noch Hintergrundprozesse oder Aufgaben laufen.

Hintergrundaufgaben, Unteragenten und die Anzahl paralleler Unteragenten sind Funktionen des Tarifs. Siehe Tarife und Limits.

Ein Git-Arbeitsverzeichnis weist der Sitzung einen eigenen Checkout zu, sodass parallele Sitzungen oder Unteragenten niemals dieselben Dateien bearbeiten.

Terminal-Fenster
champrep ai --worktree
champrep ai --worktree fix-rounding
/worktree fix-rounding
/worktree exit

Der Arbeitsordner wird unter .champrep/worktrees/NAME auf einem neuen Zweig ai/NAME. Wenn Sie das Programm beenden, wird ein Arbeitsverzeichnis ohne Änderungen entfernt; eines mit Änderungen wird beibehalten und gemeldet, sodass Sie diese festschreiben oder verwerfen können. Ein benutzerdefinierter Agent kann außerdem festlegen, isolation: worktree um stets im eigenen Arbeitsverzeichnis zu arbeiten.

/review
/review main
/review !42
/security-review
  • Ohne Argument, /review gibt einen Überblick über Ihre nicht festgeschriebenen und in die Staging-Umgebung übernommenen Änderungen.
  • Bei einem Branch oder Ref vergleicht es diesen Branch mit dem aktuellen HEAD.
  • Mit !NUMBER oder eine URL für eine Zusammenführungsanfrage; es überprüft eine CHAMPREPCode-Zusammenführungsanfrage über Ihre CHAMPREPTools.

/security-review sucht nach ausnutzbaren Schwachstellen wie Injektionen, Autorisierungslücken, offengelegten Geheimnissen und Pfadtraversal. Beide Befehle führen den schreibgeschützten review Agent und meldet die Ergebnisse nach Schweregrad mit Angabe der Datei und der Zeile.