跳转到主要内容
构建一个 TypeScript 智能体:它用本地工具检查拉取请求,返回严格的 JSON 审查计划,并在计划表明需要审批时暂停等待人工处理。完成后,你会得到一个脚本,它打印经过验证的 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 访问器保存运行。状态与审批介绍了批准和拒绝。
最后修改于 2026年11月5日