CodeReviewPlan validé et s’arrête sur waiting_for_human jusqu’à ce que quelqu’un l’approuve.
Les outils renvoient des données d’exemple fixes : le script est donc illustratif ; remplacez-les par des appels à votre hébergeur de code et à votre CI. Une version packagée se trouve dans packages/sdk/agent-sdk-ts/examples/coding-review-agent.ts.
Le construire
1
Installer
2
Écrire l’agent
review-agent.ts
responseFormat fait demander ce schéma par le Gateway, et outputSchema vérifie à nouveau le résultat analysé dans votre processus. Le mode strict de réparation des réponses ne fait que désencapsuler du JSON déjà valide.3
L’exécuter
Vérifier que ça fonctionne
- Le journal des événements affiche
tool.startedettool.completedpour les deux outils, puischeckpoint.savedaprès l’étape d’outils. - Un plan avec
needsApproval: truetermine la première exécution surwaiting_for_human, avec le plan dansresult.run.pause.payload; avecAPPROVE=yes, elle continue jusqu’àcompleted. - Dans Paramètres → Utilisation → Journaux, chaque tour du modèle affiche les appels d’outils, et l’enregistrement des plugins de la requête indique si la réparation a eu lieu.
- Un plan qui ne respecte pas le schéma fait échouer l’exécution avec une
AgentSchemaValidationErrorau lieu de renvoyer des données incorrectes.
Le sécuriser pour de vrais dépôts
Gardez les outils de revue en lecture seule. Si vous ajoutez un outil qui commente, pousse ou fusionne, définissezrequireApproval: true sur cet outil pour que l’exécution se mette en pause avant son appel, et approuvez-le avec continueRun({ run, client, approvals: [toolCallId] }). Traitez le contenu du diff comme une entrée non fiable : des commentaires de code peuvent contenir des instructions destinées au modèle. Pour survivre aux redémarrages pendant qu’une revue attend, enregistrez l’exécution avec un accesseur state, comme dans la boucle durable. État et approbation couvre les approbations et les refus.