メインコンテンツへスキップ
モデル、プロンプト、プロバイダーのルールをダッシュボードのプリセットから取得し、コードではワークフローだけを扱う 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

実行する

一時停止したケースを完了するには、レビュー担当者の判断を付けて続行します。

動作を確認する

通常のチケットとリスクの高いチケットを 1 件ずつ実行し、次の点を確認します。
  • 設定 → 利用状況 → ログ で、リクエストのモデルにプリセットが使われたことが表示されます。
  • リスクの高いケースは waiting_for_human で終わり、判定は pause.payload に入ります。
  • 再試行されたモデル呼び出しはステップに modelAttempts として記録され、再試行のたびに model.retrying がログに出力されます。
  • ブロックされたリクエストは requestId と reason とともにログに記録され、ログ内の同じリクエストでその理由を確認できます。

Gateway の失敗を見える状態に保つ

エージェントのコールバック内でエラーを握りつぶさないでください。AgentGatewayError は境界で捕捉し、その ID をログに記録してから再スローします。実行が失敗すると、保存された状態の run.errorDetails と steps[n].errorDetails に同じ詳細が残るため、例外が消えた後でも、後続の復旧ジョブがそれを読み取れます。 これらの失敗はエージェントではなく Gateway のポリシーから発生するため、ログ内のリクエストを確認してください。
最終更新日 2026年11月5日