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 策略,而不是智能体,因此应在日志中的请求里查找: