packages/sdk/agent-sdk-ts/examples/support-triage-agent.ts にあります。
作成する
1
プリセットを作成する
設定 → プリセット で、ルーティング先のモデル、プロバイダーの設定、サポート用のシステムプロンプト、安定したデコードパラメーターを指定して
support-triage を作成します。モデルは JSON Schema 出力に対応している必要があります。プリセットが各リクエストとどのようにマージされるかはプリセットで説明しています。2
インストールする
3
エージェントを書く
triage-agent.ts
4
実行する
動作を確認する
通常のチケットとリスクの高いチケットを 1 件ずつ実行し、次の点を確認します。- 設定 → 利用状況 → ログ で、リクエストのモデルにプリセットが使われたことが表示されます。
- リスクの高いケースは
waiting_for_humanで終わり、判定はpause.payloadに入ります。 - 再試行されたモデル呼び出しはステップに
modelAttemptsとして記録され、再試行のたびにmodel.retryingがログに出力されます。 - ブロックされたリクエストは
requestIdとreasonとともにログに記録され、ログ内の同じリクエストでその理由を確認できます。
Gateway の失敗を見える状態に保つ
エージェントのコールバック内でエラーを握りつぶさないでください。AgentGatewayError は境界で捕捉し、その ID をログに記録してから再スローします。実行が失敗すると、保存された状態の run.errorDetails と steps[n].errorDetails に同じ詳細が残るため、例外が消えた後でも、後続の復旧ジョブがそれを読み取れます。
これらの失敗はエージェントではなく Gateway のポリシーから発生するため、ログ内のリクエストを確認してください。