Saltar al contenido principal
Crea un agente de TypeScript que inspecciona una solicitud de incorporación con herramientas locales, devuelve un plan de revisión en JSON estricto y se detiene a esperar a una persona cuando el plan indica que necesita aprobación. Al terminar tendrás un script que imprime un 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.started y tool.completed para ambas herramientas y, después, checkpoint.saved tras el paso de herramientas.
  • Un plan con needsApproval: true termina la primera ejecución en waiting_for_human con el plan en result.run.pause.payload; con APPROVE=yes continúa hasta completed.
  • 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 AgentSchemaValidationError en 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, pon requireApproval: 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.
Última modificación el 5 de noviembre de 2026