Skip to main content
TypeScript または JavaScript のサービスで次の機能を組み合わせる場合は、このレシピを使います。
  • プリセットによるルーティングの既定値
  • 管理された phaseo:web_search ツール
  • 厳密な応答解析
  • デバッグ用のリクエスト単位のメタデータ

目標

  • 呼び出し元で公式 SDK を使い続ける
  • 生の互換ペイロードを手作業で組み立てない
  • 検索結果、ルーティング、プラグインの動作を調べるのに十分なメタデータを保持する

1. 共有クライアントから始める

2. 安定した既定値をまずプリセットにまとめる

複数の呼び出し元で共有する値がある場合は、プリセットを作成します。
  • モデルポリシー
  • プロバイダーの優先設定
  • 推論の既定値
  • システムプロンプト
  • 決定的なキャッシュ動作
その後、SDK リクエストには今回の呼び出しで変わる値だけを指定します。

3. 管理された検索ツールで根拠のある出力を求める

これにより、次の内容を利用できます。
  • プリセットで管理されるルーティングとプロンプトの既定値
  • プロバイダーのネイティブ検索対応に依存しない、サーバー管理の検索
  • 後続処理で予測しやすい構造化出力
  • 運用上のデバッグに必要なメタデータ

4. 出力を解析し、デバッグ用フィールドを保持する

これらのフィールドがあれば、次の内容を確認しやすくなります。
  • 実際にリクエストを処理したプロバイダー
  • 管理された検索が実行されたか
  • 応答修復が実行されたか
  • ダッシュボードで調査するリクエスト

5. ログで根拠付けされたリクエストを確認する

Gateway -> 使用量 でリクエストを開き、次の情報を確認します。
  • 正規化された検索結果
  • 引用
  • 選択されたプロバイダー
  • プラグインの実行メタデータ
検索の動作や順位が正しくない場合は、根拠のない上書きを追加せず、ログをもとにプリセットまたはツールのパラメーターを調整してください。

6. 探索的なワークフローと決定的なワークフローを分ける

推奨するパターン:
  1. 決定的で構造化された調査結果用のプリセット
  2. 探索的なリクエストや温度を高くするリクエスト用の別のプリセット
これにより、次の点を維持できます。
  • 応答キャッシュを整理しやすい
  • ルーティングの動作を理解しやすい
  • 検索の多いワークフローを一般的な生成トラフィックから分離できる

関連ガイド

最終更新日 2026年10月2日