Zum Hauptinhalt springen
Baue einen TypeScript-Agenten, der einen Pull Request mit lokalen Tools untersucht, einen streng strukturierten JSON-Review-Plan zurückgibt und für eine Person anhält, wenn der Plan eine Freigabe verlangt. Am Ende hast du ein Skript, das einen validierten CodeReviewPlan ausgibt und bei waiting_for_human stoppt, bis jemand ihn freigibt. Die Tools liefern feste Beispieldaten, das Skript dient also der Veranschaulichung; ersetze sie durch Aufrufe an deinen Code-Host und deine CI. Eine fertig verpackte Version liegt in packages/sdk/agent-sdk-ts/examples/coding-review-agent.ts.

Agenten bauen

1

Installieren

2

Agenten schreiben

review-agent.ts
responseFormat lässt das Gateway dieses Schema anfordern, und outputSchema prüft das geparste Ergebnis in deinem Prozess noch einmal. Der strenge Modus der Antwortreparatur entpackt nur JSON, das bereits gültig ist.
3

Ausführen

Prüfen, ob es funktioniert hat

  • Das Ereignisprotokoll zeigt tool.started und tool.completed für beide Tools und danach checkpoint.saved nach dem Tool-Schritt.
  • Ein Plan mit needsApproval: true beendet den ersten Lauf bei waiting_for_human, mit dem Plan in result.run.pause.payload; mit APPROVE=yes läuft er weiter bis completed.
  • Unter Einstellungen → Nutzung → Protokolle zeigt jeder Modellzug die Tool-Aufrufe, und der Plugin-Eintrag der Anfrage zeigt, ob die Reparatur gelaufen ist.
  • Ein Plan, der das Schema verletzt, lässt den Lauf mit einem AgentSchemaValidationError fehlschlagen, statt fehlerhafte Daten zurückzugeben.

Für echte Repositorys absichern

Halte Review-Tools nur lesend. Wenn du ein Tool hinzufügst, das kommentiert, pusht oder mergt, setze darauf requireApproval: true, damit der Lauf vor dessen Ausführung anhält, und gib es mit continueRun({ run, client, approvals: [toolCallId] }) frei. Behandle Diff-Inhalte als nicht vertrauenswürdige Eingabe: Code-Kommentare können Anweisungen enthalten, die sich an das Modell richten. Damit ein wartendes Review Neustarts übersteht, speichere den Lauf mit einem state-Accessor wie in der robusten Agent-Schleife. Status und Freigabe behandelt Freigaben und Ablehnungen.
Zuletzt geändert am 5. November 2026