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.startedundtool.completedfür beide Tools und danachcheckpoint.savednach dem Tool-Schritt. - Ein Plan mit
needsApproval: truebeendet den ersten Lauf beiwaiting_for_human, mit dem Plan inresult.run.pause.payload; mitAPPROVE=yesläuft er weiter biscompleted. - 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
AgentSchemaValidationErrorfehlschlagen, 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 daraufrequireApproval: 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.