Deinen ersten Agenten starten

Was du baust

Am Ende dieser Anleitung hast du:

• Einen Agenten, den du selbst angelegt und eingerichtet hast
• Einen Bereich, in dem du mit diesem Agenten sprichst
• Einen abgeschlossenen Lauf, mit committeter Arbeit in einem isolierten Worktree und einer Zeile im Laufprotokoll des Agenten

Voraussetzung: Dein erster Arbeitsbereich ist abgeschlossen, dieser Arbeitsbereich hat also ein registriertes Repo und mindestens einen verbundenen Modellanbieter.

Schritt 1: Einen Agenten anlegen

1. Geh zu Einstellungen → Arbeitsbereich → Agenten
2. Klicke auf Neuer Agent. Sofort entsteht ein Agent namens „Unbenannter Agent“, und er ist in der Liste ausgewählt — es gibt keinen Dialog zum Anlegen und nichts zu bestätigen. Du richtest ihn an Ort und Stelle ein.
3. Fülle auf dem Tab Einstellungen aus:
   • Name: etwas Kurzes, das hängen bleibt, zum Beispiel alice. Das tippst du nach @.
   • Titel: was er tut, zum Beispiel „Backend-Entwickler“
   • Adapter: Control Center (built-in). Wähle den bewusst — nur der eingebaute Harness lässt sich mitten im Lauf lenken und an einer Zuggrenze pausieren, und auf dem Server-Host muss keine CLI installiert sein.
   • Modell: wähle aus der Liste, die der verbundene Anbieter liefert
   • Fähigkeiten: hänge passende an, zum Beispiel testing oder architecture
4. Klicke auf Änderungen speichern

Ein Agent ohne Adapter läuft auf der eingebauten Schleife

Ist das Feld Adapter nicht gesetzt, fällt die Ausführung auf Control Center (built-in) zurück — die Agentenschleife im Server, auf dem Host ist also nichts zu installieren. Ein Modell braucht er trotzdem: Ist keins gesetzt, fragt er Anthropic nach dessen Standard. Das funktioniert, wenn du ein Anthropic-Konto verbunden hast, und scheitert sonst mit No credential for provider "anthropic". Setze beides trotzdem ausdrücklich, sonst läufst du auf einem Modell, das du nicht gewählt hast.

Kontrollpunkt. Die Zeile in der Liste zeigt den Namen deines Agenten und einen hohlen Statusring.

Schritt 2: Einen Bereich anlegen

1. Such in der Seitenleiste den Abschnitt Bereiche und klicke auf die Schaltfläche +
2. Gib dem Bereich einen Namen
3. Wähle unter Agenten hinzufügen den Agenten, den du gerade angelegt hast
4. Hat der Arbeitsbereich Repos, wähle aus, an welchen dieser Bereich arbeiten soll
5. Klicke auf Erstellen

Der Bereich öffnet sich. Im Hintergrund stellt Control Center für diese Unterhaltung einen Copy-on-Write-Worktree der ausgewählten Repos bereit, auf einem eigenen Branch. Dein Quell-Checkout wird nie verändert.

Schritt 3: Eine Aufgabe schicken

Tippe eine konkrete, kleine Aufgabe zum Repo, das du registriert hast. Am besten etwas mit einem prüfbaren Ergebnis — einen Test hinzufügen, einen Lint beheben, ein Symbol umbenennen.

Drücke Enter. Du musst niemanden mit @ erwähnen: Sitzt nur ein Agent im Bereich, weckt ihn eine gewöhnliche Nachricht. In einem Bereich mit mehreren Agenten wählt @name einen aus.

Control Center setzt den Prompt aus den Anweisungen, der Persona und den Skills des Agenten sowie dem Kontext des Bereichs zusammen und dispatcht dann den Lauf.

Kontrollpunkt. Die Senden-Schaltfläche des Composers wird zur Stopp-Schaltfläche — ein Agent arbeitet in dieser Unterhaltung — und Text beginnt einzutreffen.

Schritt 4: Bei der Arbeit zusehen

Die Unterhaltung zeigt den Lauf, während er geschieht:

• Reasoning, inline, während der Agent nachdenkt
• Werkzeugaufrufe: Dateien lesen und schreiben, Suchen, Shell-Befehle, jeder mit seinem Ergebnis
• Text: Zusammenfassungen, Erklärungen und Fragen an dich

Fragt der Agent etwas, antwortest du in der Unterhaltung, und er macht weiter.

Für die eigenen Kennzahlen eines Laufs und die Steuerung zum Pausieren, Fortsetzen und Stoppen suchst du den laufenden Agenten im Abschnitt Agenten des Panels Allgemein des Bereichs und wählst Aktivität öffnen.

Im Aktivitätsbereich steht das Status-Badge auf Läuft und danach auf Erfolgreich, wenn der Lauf endet. Ein Lauf, der stockt oder kreist, zeigt Blockiert; einer mit Fehler zeigt Fehlgeschlagen. In der Agentenliste ist der Ring hohl, bevor der Agent zum ersten Mal gelaufen ist, und ausgefüllt, sobald er wieder inaktiv ist.

Was den Lauf begrenzt: sein eigener Copy-on-Write-Worktree, die Zugangsdaten, die ihm beim Start vermittelt und beim Aufräumen widerrufen werden, eine bereinigte Umgebung, die Werkzeugfläche, die sein Modus erlaubt, und die Aktions-Schutzregeln. Wirkungen wie das Pushen eines Branchs oder das Öffnen eines Pull Requests liegen hinter einem eigenen Tor — siehe Schutzregeln.

Schritt 5: Das Ergebnis prüfen

1. Öffne Einstellungen → Arbeitsbereich → Agenten und wähle deinen Agenten
2. Öffne den Tab Protokolle

Kontrollpunkt. Eine Laufzeile mit Status, Dauer, Start- und Endzeit und dem Adapter, auf dem er gelaufen ist.

Die Änderungen des Agenten sind auf dem Branch der Unterhaltung committet, in seinem Worktree. Commits entstehen als der Agent, und du wirst im Trailer Co-Authored-By: genannt.

Einen Pull Request bekommen

Von allein öffnet nichts einen Pull Request. Willst du einen, bitte in derselben Unterhaltung darum:

Pushe diesen Branch und öffne einen Pull Request gegen den Standardbranch.

Pushen (gitPush) und das Anlegen eines PR (prCreate) fragen beide standardmäßig nach deiner Freigabe, rechne also vor jedem mit einer Bestätigung. Ist keine freigebende Person verbunden, wenn die Rückfrage kommt, wird die Aktion abgelehnt statt erlaubt — die Schutzregeln fallen geschlossen aus.

Der PR wird unter der GitHub-Identität geöffnet, deren Token der Lauf benutzt hat — deiner, wenn du ein persönliches Token hinterlegt hast — und nicht unter dem Namen des Agenten. Die Autorenschaft des Agenten steht auf den Commits.

Du kannst ihn auch selbst öffnen: Das Panel Quellcodeverwaltung des Bereichs hat die Schaltfläche Pull Request erstellen, die den Branch der Unterhaltung in den Bildschirm zum Verfassen mitnimmt, und Pull Requests → Neue PR öffnet denselben Bildschirm leer. Dort setzt die nächste Anleitung an.

Rückblick

Du hast einen Agenten angelegt, Adapter und Modell gesetzt, ihm einen Bereich und eine Aufgabe gegeben und zugesehen, wie ein echter Lauf in einem isolierten Worktree fertig wird, ohne deinen Checkout anzufassen.

Als Nächstes: Deinen ersten Pull Request prüfen, um den Review-Ablauf kennenzulernen.

Mehr zu Agenten: Das Agentenmodell. Zu den Einzelheiten der Ausführung: Lebenszyklus der Agenten-Ausführung.