OpenRouter で顧客フィードバックをチケットに変換する:JSON の受入検証に合わせたルーティング

顧客フィードバックをチケットの項目に変換する際、OpenRouter でのモデル選択は途中の一工程にすぎません。まず受入検証に使う構造を定義し、必要なパラメータをサポートするプロバイダーに限定し、失敗したものは保留キューに残すことで、形式は正しくても内容が誤った結果が業務システムに直接入るのを防ぎます。

ソース: openrouter.ai
2026年11月18日
7 min

運用チームが顧客フィードバックを自動でチケットにまとめるとき、本当に必要なのは安定した項目と追跡可能な原文であり、流暢な要約ではありません。OpenRouter はモデルへのリクエストを処理するプロバイダーを選択できますが、どの結果を保存してよいかは、受け取り側のシステムが判断する必要があります。まずは管理されたフローを作るのが適切です。個人を特定できる情報を除去したフィードバックをキューに入れ、モデルが項目を抽出し、プログラムが受入検証を行い、人が例外を処理してから、最後にチケットを作成します。以下は公式ドキュメントに基づくフローの設計であり、実際に実行したテストの報告ではありません。

まずチケットシステム側で成果物を定義する

「エクスポートに失敗したので、できるだけ早く対応してください」というフィードバックを例にすると、元データの識別番号、問題のカテゴリ、要約、根拠となる原文の出力を求められます。担当者や期限が明記されていない場合は null のままにし、モデルに約束を補わせてはいけません。項目名、許可するカテゴリ、必須項目、null の扱いは、チケットを受け取るチームが先に確認し、それを JSON Schema に記述します。

受入検証には二つの層があります。構造の検証では、有効な JSON かどうか、項目の型や列挙値が取り決めどおりかを確認します。業務上の検証では、要約が原文に忠実か、元データの識別番号が一致するか、根拠なく緊急度を上げていないかを確認します。まず、個人を特定できる情報を除去した少数のサンプルを用意し、通常のフィードバック、情報不足、相互に矛盾する内容を含め、受け入れ可能な結果を人手で示しておくことを勧めます。サンプル数は業務上のリスクに応じて決めるべきで、特定の件数を満たしたことを信頼性の証明にしてはいけません。

構造の要件をルーティングに組み込む

OpenRouter の構造化出力のドキュメントによると、対応状況は個々のエンドポイントに依存し、同じモデルでも提供するプロバイダーによって機能が異なる場合があります。そのため、モデル名だけを記録するのではなく、モデルのページでプロバイダーの structured_outputs 対応情報を確認します。

Chat Completions API を使う場合は、リクエストに response_format を含め、type を json_schema に設定し、json_schema 内に名前、strict、具体的な schema を指定します。さらに、プロバイダーの設定で require_parameters を true にします。公式ガイドは、この組み合わせによってパラメータへの対応をルーティング条件に含めることを推奨しています。必要なパラメータをサポートしないエンドポイントを除外する助けにはなりますが、チケットの内容が事実かどうかを代わりに判断してくれるわけではありません。

まず、選定したモデルと承認済みのプロバイダーでサンプルを実行し、リクエスト設定と受入検証の結果を保存します。モデル、プロバイダー、schema を変更したら再確認します。これは運用開始前に勧める作業であり、本記事で得られたテスト成績ではありません。

フェイルオーバーの範囲を定める

プロバイダールーティングのドキュメントでは、allow_fallbacks の既定値は true で、order は試行する順番の指定に使います。優先順位のリスト自体を、調達上の承認済みリストとみなしてはいけません。指定されたプロバイダーだけがデータを処理できる場合は、only で許可する範囲を限定します。追加のプロバイダーへのフォールバックを無効にする必要があれば、allow_fallbacks: false も明示的に設定します。

これにより、利用可能なエンドポイントの範囲は狭くなります。公式のエラー説明には、ルーティング条件を満たすプロバイダーが存在しない場合の失敗が挙げられています。業務フローは「今は結果が得られない」ことを受け入れなければならず、キューを空にするためだけに制限を自動で緩めてはいけません。保留中のレコードには元データの識別番号、試行回数、エラーの理由を残し、時間を置いて再試行するのか、入力を修正するのか、人手でチケットを作るのかを担当者が判断できるようにします。対象のデータを OpenRouter と該当プロバイダーに送信してよいかについても、チーム独自のデータ承認要件に従う必要があります。

受入検証の後で書き込み、再試行の前に重複を確認する

API から応答が返ったら、まずエラーを確認し、それから内容を解析・検証します。OpenRouter のエラードキュメントは、モデルが生成を開始した後のエラーがレスポンス本文やストリーミングイベント内に現れる場合があると注意しています。HTTP ステータスだけで成功と判断してはいけません。フィードバックを一括で整理する初期版では、非ストリーミング呼び出しから始めることで、途中までの内容をもとに後続処理を誤って起動する機会を減らせます。

「抽出完了」と「チケット作成完了」は別の状態にすることを勧めます。構造と業務の両方の検証を通過してから、作成の工程に進みます。元データの識別番号に対応するチケットを記録し、書き込みの結果が不明な場合は、再試行するかを決める前に受け取り側のシステムを照会して、同じフィードバックからチケットが重複作成されるのを防ぎます。項目の欠落、根拠不足、相互に矛盾する内容がある結果は人の確認に回し、自動再試行で内容の問題を覆い隠さないようにします。

このフローの利点は、複数プロバイダーからの選択とチケットの受入検証を分けて管理できることです。その代わり、schema、サンプル、例外キューの保守は引き続き必要です。フィードバックの量が少なく、検証ロジックを保守する人もいないなら、人手で整理し続けるほうが費用対効果は高いかもしれません。固定の単一プロバイダーだけが必要なら、直接接続する場合の保守コストも比較すべきです。OpenRouter を採用する条件は、チームが実際にルーティングの選択肢を必要とし、受入検証の責任を自らの業務フローに残す意思があることです。

内容説明:本記事は公開情報をもとに整理した、ツール選定の参考情報です。機能、料金、関連ポリシーは随時変更される場合があります。最新の公式情報をご確認ください。

元の出典:openrouter.ai