Dokumentation / Der Agent

Eine Aufgabe in Auftrag geben

Wie du von Anfang bis Ende mit dem Agenten arbeitest, ohne die Kontrolle zu verlieren.

Schreib, was du brauchst, so wie du es einer Kollegin oder einem Kollegen sagen würdest. Der Agent schlägt vor, die IDE kontrolliert und du genehmigst.

Bevor du beginnst

  • Öffne das Projekt und warte, bis die Indexierung abgeschlossen ist (die obere Leiste des Editors zeigt es an). Du kannst währenddessen schon schreiben.
  • Verbinde eine KI: dein Abo oder einen API-Key. Siehe Eine KI verbinden.
  • Blende den Chat mit Ctrl+Alt+I ein, falls er ausgeblendet ist. Im Editor setzt Ctrl+L den Fokus auf den Chat.

1. Beschreibe das Ergebnis

Sag, was du willst und woran du erkennst, dass es stimmt.

Statt … Schreib …
„Repariere den Login“ „Der Login schlägt bei Benutzern fehl, deren E-Mail-Adresse einen Akzent enthält. Behebe das und füge einen Test hinzu, der den Fall abdeckt.“
„Mach einen Endpoint“ „Füge GET /api/orders/{id} hinzu, das 404 zurückgibt, wenn der Eintrag nicht existiert. Halte dich an den Stil von ProductController.“

Du kannst Dateien über die Büroklammer anhängen und Code erwähnen. Eingefügter Code wird mit seiner Sprache erkannt.

Der Agent antwortet immer in der Sprache, in der du ihm schreibst.

2. Beantworte die Fragen

Fehlt etwas, fragt der Agent während der Analyse – alles auf einmal, in Karten Fragen von Yuli:

  • Jede Frage enthält ihre Empfohlen-Option.
  • Andere Antwort… lässt dich deine eigene schreiben.
  • Yuli entscheidet delegiert diese Frage; Sie entscheiden alles wählt bei allen die empfohlene Option.
  • Tastatur: 1–9 wählt, Enter geht weiter, ← geht zurück.

3. Verfolge den Plan

Aufgaben über mehrere Dateien werden zu einer Mission mit einem Plan aus überprüfbaren Schritten und Live-Fortschritt. Die Missionsleiste über dem Chat zeigt die aktuelle Phase: Phase n von 8. Siehe Missionen und Phasen.

Während der Agent arbeitet, zeigt das Workboard, was er gerade tut: Analyse, Recherche, Bearbeitung, Wird überprüft…

Du kannst weiterschreiben: Deine Nachrichten landen in der Warteschlange, und du kannst fragen: „Wie weit bist du?“

4. Genehmige, was Auswirkungen hat

Wenn der Agent einen Befehl ausführen oder etwas mit Folgen tun muss, erscheint die Karte Genehmigung erforderlich:

  • Genehmigen oder Ausführen bestätigt; Ablehnen verwirft.
  • Immer in diesem Chat verhindert, dass in dieser Unterhaltung erneut für dieselbe Aktion gefragt wird.
  • Ctrl+Alt+Enter genehmigt alles Ausstehende.

5. Prüfe die Änderungen

Keine Änderung landet ungeprüft auf der Festplatte. Jeder Vorschlag kommt als Karte mit seinem Diff. Öffne alle in KI-Änderungen mit Ctrl+Alt+R. Siehe Änderungen prüfen.

6. Nimm das Ergebnis entgegen

Zum Abschluss:

  1. Misst der Agent den angefassten Code gegen die Vorversion und fasst das Urteil in einer einzigen Zeile zusammen.
  2. Baut, testet und startet er die Anwendung.
  3. Fasst er zusammen, was erledigt und verifiziert wurde, welche Entscheidungen getroffen wurden und was noch offen ist.

Rückgängig machen

  • Alt+Shift+Z macht das zuletzt vom Agenten Angewendete rückgängig.
  • Ctrl+Alt+Shift+Z macht die letzte vollständige Aufgabe mit all ihren Dateien rückgängig.
  • ↺ Aufgabe rückgängig machen in der Zusammenfassung des Durchgangs tut dasselbe, mit Vorschau.

Was der Agent nie ohne deine Anfrage tut

  • Commit, Push, Merge oder Branches anlegen.
  • In eine Datenbank schreiben.
  • .env, Schlüssel oder Zugangsdaten lesen.

Siehe Sandbox und Berechtigungen.

Weitere Arbeitsweisen

Wenn du … willst Nutze
dass er allein bis zum Ende arbeitet Unbeaufsichtigter Modus
eine große Aufgabe auf mehrere Agenten verteilen Agenten-Team
etwas Langes delegieren, ohne deine Arbeitskopie anzufassen Hintergrundaufgaben (Alt+Shift+B)
einen Bildschirm gestalten Web Studio