Pular para o conteúdo principal
Crie um agente em TypeScript que inspeciona um pull request com ferramentas locais, retorna um plano de revisão em JSON estrito e pausa para uma pessoa quando o plano diz que precisa de aprovação. Ao final, você terá um único script que imprime um CodeReviewPlan validado e para em waiting_for_human até que alguém o aprove. As ferramentas retornam dados de exemplo fixos, então o script é ilustrativo; substitua-as por chamadas ao seu host de código e à sua CI. Uma versão empacotada está em packages/sdk/agent-sdk-ts/examples/coding-review-agent.ts.

Crie o agente

1

Instale

2

Escreva o agente

review-agent.ts
responseFormat faz o Gateway solicitar este esquema, e outputSchema verifica de novo o resultado analisado no seu processo. O modo estrito de recuperação de respostas só desembrulha JSON que já é válido.
3

Execute

Verifique se funcionou

  • O log de eventos mostra tool.started e tool.completed para as duas ferramentas e, em seguida, checkpoint.saved após a etapa de ferramentas.
  • Um plano com needsApproval: true encerra a primeira execução em waiting_for_human, com o plano em result.run.pause.payload; com APPROVE=yes, ela continua até completed.
  • Em Configurações → Uso → Registros, cada turno do modelo mostra as chamadas de ferramentas, e o registro de plugins da solicitação mostra se a recuperação foi executada.
  • Um plano que viola o esquema faz a execução falhar com um AgentSchemaValidationError em vez de retornar dados ruins.

Torne-o seguro para repositórios reais

Mantenha as ferramentas de revisão somente leitura. Se você adicionar uma ferramenta que comenta, faz push ou faz merge, defina requireApproval: true nela para que a execução pause antes de ela rodar, e aprove-a com continueRun({ run, client, approvals: [toolCallId] }). Trate o conteúdo do diff como entrada não confiável: comentários no código podem conter instruções direcionadas ao modelo. Para sobreviver a reinícios enquanto uma revisão aguarda, salve a execução com um acessor state, como no loop persistente. Estado e aprovação cobre aprovações e rejeições.
Última modificação em 5 de novembro de 2026