CodeReviewPlan validado y se queda en waiting_for_human hasta que alguien lo apruebe.
Las herramientas devuelven datos de ejemplo fijos, así que el script es ilustrativo; sustitúyelas por llamadas a tu alojamiento de código y a tu CI. Hay una versión empaquetada en packages/sdk/agent-sdk-ts/examples/coding-review-agent.ts.
Créalo
1
Instala
2
Escribe el agente
review-agent.ts
responseFormat hace que el Gateway solicite este esquema, y outputSchema vuelve a comprobar el resultado analizado en tu proceso. El modo estricto de reparación de respuestas solo desenvuelve JSON que ya es válido.3
Ejecútalo
Comprueba que funciona
- El registro de eventos muestra
tool.startedytool.completedpara ambas herramientas y, después,checkpoint.savedtras el paso de herramientas. - Un plan con
needsApproval: truetermina la primera ejecución enwaiting_for_humancon el plan enresult.run.pause.payload; conAPPROVE=yescontinúa hastacompleted. - En Ajustes → Uso → Registros, cada turno del modelo muestra las llamadas a herramientas, y el registro de plugins de la solicitud indica si se aplicó la reparación.
- Un plan que no cumple el esquema hace fallar la ejecución con un
AgentSchemaValidationErroren lugar de devolver datos incorrectos.
Hazlo seguro para repositorios reales
Mantén las herramientas de revisión en solo lectura. Si añades una herramienta que comenta, hace push o fusiona, ponrequireApproval: true en ella para que la ejecución se detenga antes de usarla, y apruébala con continueRun({ run, client, approvals: [toolCallId] }). Trata el contenido del diff como entrada no fiable: los comentarios del código pueden contener instrucciones dirigidas al modelo. Para que una revisión en espera sobreviva a los reinicios, guarda la ejecución con un accesor state como en el bucle duradero. Estado y aprobación explica las aprobaciones y los rechazos.