Agent Studio
Einstieg

Agent Studio einrichten und die erste Aufgabe prüfen

Starte das Studio mit Docker Compose, verbinde einen Ausführungshost und ein Repository und prüfe anschließend eine kleine Änderung.

Einrichtungsdokumentation geprüft am 25. September 2026. Die folgenden Befehle entsprechen der Produkt-README zu diesem Datum. Für diese Website-Überarbeitung wurde keine Neuinstallation getestet.

1. Umgebung vorbereiten

Du brauchst Git, Docker mit Compose und mindestens 8 GB freien Speicherplatz. Der Compose-Weg verwendet festgelegte Release-Images; .NET oder Node.js müssen dafür nicht auf dem Host installiert sein.

  • Wähle ein Test-Repository oder einen sauberen Checkout mit wiederherstellbarem Git-Stand.
  • Installiere und authentifiziere die Coding-Agent-CLI auf dem Ausführungshost. Prüfe, ob sie außerhalb des Studios startet.
  • Modellzugang und Anbieterabrechnung werden unabhängig von Agent Studio eingerichtet.

2. Studio starten und Ausführung einrichten

Führe die folgenden Befehle aus und öffne danach http://localhost:4011. Damit starten die Studio-Dienste. Für Coding-Aufgaben brauchst du zusätzlich einen konfigurierten Ausführungshost mit Repository-Zugriff und authentifizierter CLI.

Für einen Docker-Runner folgst du Abschnitt 5 der Einrichtungsanleitung: zuerst scripts/compose-runner-bootstrap.sh, danach docker compose --profile runner up --wait. Die Anleitung erklärt Zugangsdaten und persistente Daten.

Füge dein Ziel-Repository als Projekt hinzu und prüfe den Zugriff des zugewiesenen Hosts. Ein sichtbares Board allein bestätigt noch keine betriebsbereite Ausführung.

git clone https://github.com/agent-orc/agent-studio.gitcd agent-studiodocker compose up --wait

Was wo läuft

Der Browser zeigt Aufgaben und Review-Entscheidungen. Der Task Server speichert Aufgabenstatus und Ausführungsprotokolle. Agent Runner führen Coding-Agent-CLIs auf konfigurierten Hosts in isolierten Git-Worktrees aus.

Systemübersicht

Zentraler Aufgabenstand, verteilte Ausführung.

Der Task Server koordiniert die Arbeit. Runner führen sie auf eingerichteten Hosts aus.
01Client

Agent Studio

Aufgaben im Browser ansehen und Entscheidungen treffen.

HTTP-Client
02 Zentrale Verwaltung

Task Server

Aufgaben, Läufe und Review-Entscheidungen speichern und koordinieren.

maßgeblicher Aufgabenstand
03 Ausführung

Agent Runner

Coding-Agent-CLIs auf einem eingerichteten Host ausführen und Ergebnisse melden.

agent-runner
Studio Anfrage
Task Server Status + Lease
Runner Status + Prüfergebnisse
Studio und Runner kommunizieren über den Task Server. Er verwaltet den Aufgabenstand.

3. Eine überprüfbare Änderung beschreiben

Erstelle eine Aufgabe mit einem Ergebnis, einem klaren Datei- oder Funktionsumfang und einer passenden Prüfung. Zum Beispiel: den Leerzustand der Projektliste verständlicher formulieren, das Verhalten erhalten und einen Screenshot in Mobilbreite liefern.

4. Ausführen, prüfen und entscheiden

Wähle den eingerichteten Agenten und Host. Verfolge den Ausführungsstatus und prüfe danach Diff und dokumentierte Prüfungen. Nimm das Ergebnis an oder fordere eine konkrete Korrektur an. Der erste Versuch ist abgeschlossen, wenn die Aufgabe geprüft und die Entscheidung festgehalten ist.

Agent Studio · Originalaufnahme
Eskalierte DEMO-9 mit offenen Befunden, dokumentiertem Ergebnis, Git-Änderungen und Entscheidungsoptionen.

Ausnahmebeispiel: DEMO-9 hat ihr Limit für weitere Bearbeitungsrunden ausgeschöpft. Offene Befunde und ausstehende Integration bleiben neben den Entscheidungsoptionen sichtbar. Originalaufnahme; die Produktoberfläche enthält englische Texte.

Wenn Einrichtung oder Ausführung scheitert

Halte den ersten konkreten Fehler, den Befehl und seine Ausgabe fest. Prüfe denselben CLI-Befehl außerhalb des Studios, den Projektpfad und die Repository-Rechte des Hosts, bevor du die Aufgabe änderst.