CodeReviewPlan,并停在 waiting_for_human,直到有人批准。
这些工具返回固定的示例数据,因此该脚本仅作演示;请将它们替换为对你的代码托管平台和 CI 的调用。打包好的版本位于 packages/sdk/agent-sdk-ts/examples/coding-review-agent.ts。
构建
1
安装
2
编写智能体
review-agent.ts
responseFormat 让 Gateway 按此 schema 发出请求,outputSchema 会在你的进程中再次检查解析后的结果。严格模式的响应修复只会解包本身已有效的 JSON。3
运行
检查是否成功
- 事件日志会显示两个工具的
tool.started和tool.completed,然后在工具步骤之后显示checkpoint.saved。 - 如果计划包含
needsApproval: true,第一次运行会停在waiting_for_human,计划位于result.run.pause.payload中;设置APPROVE=yes后,运行会继续直到completed。 - 在 设置 → 使用情况 → 日志 中,每个模型轮次都会显示工具调用,请求的插件记录会显示是否运行了修复。
- 不符合 schema 的计划会以
AgentSchemaValidationError使运行失败,而不是返回错误数据。
在真实仓库中安全使用
让审查工具保持只读。如果你添加会发表评论、推送或合并的工具,请在该工具上设置requireApproval: true,让运行在执行它之前暂停,然后用 continueRun({ run, client, approvals: [toolCallId] }) 批准。将 diff 内容视为不可信输入:代码注释中可能包含针对模型的指令。为了在审查等待期间也能承受重启,请像持久化循环中那样,用 state 访问器保存运行。状态与审批介绍了批准和拒绝。