跳转到主要内容
构建一个 TypeScript 分类智能体,其模型、提示词和提供商规则来自控制台中的预设,因此代码只需处理工作流。完成后,它会返回严格的 JSON 分类决定,暂停需要人工处理的案例,以有限次数重试模型调用,并记录 Gateway 失败及查找它们所需的 ID。 一旦预设已创建,并且你像持久化循环中那样存储已暂停的运行,该脚本即可用于生产环境。打包好的版本位于 packages/sdk/agent-sdk-ts/examples/support-triage-agent.ts。

构建

1

创建预设

在 设置 → 预设 中创建 support-triage,包含路由模型、提供商偏好、支持系统提示词和稳定的解码参数。该模型必须支持 JSON Schema 输出。预设介绍了预设如何与每个请求合并。
2

安装

3

编写智能体

triage-agent.ts
4

运行

要完成一个已暂停的案例,请带上审查者的决定继续运行:

检查是否成功

运行一个常规工单和一个高风险工单,然后检查:
  • 在 设置 → 使用情况 → 日志 中,请求的模型显示使用了该预设。
  • 高风险案例停在 waiting_for_human,决定位于 pause.payload 中。
  • 重试过的模型调用会作为 modelAttempts 记录在该步骤上,每次重试都会记录 model.retrying。
  • 被拦截的请求会连同其 requestId 和 reason 一起记录,日志中的同一请求会显示原因。

让 Gateway 失败保持可见

不要在智能体回调中吞掉错误。在边界处捕获 AgentGatewayError,记录其 ID,然后重新抛出。运行失败后,其保存的状态会在 run.errorDetails 和 steps[n].errorDetails 中保留相同的详细信息,因此即使异常已经消失,之后的恢复任务也能读取它们。 这些失败来自 Gateway 策略,而不是智能体,因此应在日志中的请求里查找:
最后修改于 2026年11月5日