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.startedetool.completedpara as duas ferramentas e, em seguida,checkpoint.savedapós a etapa de ferramentas. - Um plano com
needsApproval: trueencerra a primeira execução emwaiting_for_human, com o plano emresult.run.pause.payload; comAPPROVE=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
AgentSchemaValidationErrorem 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, definarequireApproval: 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.