一つのゲートウェイ、複数のプロトコル:何が使える?
パラメータが変換の途中で失われる前に、モデルと API の対応を確かめましょう。

API の名前より、やりたいことから
どちらも会話を受け付ける API でも、動作は同じとは限りません。テキストだけが必要なのか、画像、構造化出力、ツール呼び出しも必要なのかを整理します。必要な機能を両方で説明しているモデルとエンドポイントを選びましょう。互換形式という言葉だけでは、すべての項目が使える保証にはなりません。
似た名前のエンドポイントは一部の構造が近いことを示しますが、すべてのモデルが全パラメータを理解する保証はありません。出力上限、構造化形式、画像入力、ツール定義などは制限が異なる場合があります。提供元、ゲートウェイ、クライアントがそれぞれ検証や変換を行う可能性もあります。接続できることと必要な機能が使えることは別々に試します。
小さな対応表を作る
使うモデルとエンドポイントの組み合わせごとに、入力、ストリーミング、ツール、出力形式、制限を記録します。重要な機能はそれぞれ最小のリクエストで試します。テキストの応答が成功しても、画像やツールが使えるとは限りません。
テキストが成功しても、同じモデルでストリーミング、ツール呼び出し、画像入力が使えるとは限りません。終了マーカー、ツール名と引数、画像入力方法、未対応時のエラーをそれぞれ確かめます。一社のフィールドを共通規格とみなさず、実際のモデルとエンドポイントの最新文書を確認しましょう。
通常のテキスト、境界値、途中切断、ツール、必要なマルチモーダル入力を少数の代表例として保存します。モデル、クライアント、ゲートウェイを変更したら再実行し、状態コードだけでなく応答構造も比較します。認証情報や顧客データを除き、影響範囲と戻す手順を整理してから本番に展開します。
モデルのバージョン、エンドポイント、入力の種類、期待値、実際の結果、確認日を残します。「互換」という一語だけでは、テキストは使えても特定の画像入力は拒否される場合を表せません。未検証の項目は不明のままにし、依存する機能の公開前に確認します。
アダプターはプロトコルをつなぐが、すべての機能を変換できるとは限らない。リクエストと応答の両方を確認
個人情報を除いたサンプルをテストに残し、任意の項目が拒否・無視・変換されていないか、必要な情報が応答にあるかを確認します。実際の鍵、非公開プロンプト、顧客データは公開テストに入れません。モデルや提供元を変更したら再確認します。
重要なパラメータごとに、受け付けて有効、明確に拒否、無視、別の意味に変換のどれかを記録します。フィールドがない場合と、明示的なゼロや false の違いも含め、要求と応答を確認します。成功ステータスだけでは効果を証明できません。差が観察できる入力を使い、脱敏した結果を回帰テストに残します。
対応しない場合の動作を決める
未対応の機能は画面上で無効にし、必須ならモデルやエンドポイントを変更します。指示を黙って捨てず、理由が分かるエラーを表示しましょう。対応表の近くにドキュメントとテスト結果へのリンクを残しておくと、更新時に役立ちます。
未検証の項目は「対応」とせず「未確認」と記録します。テスト日、モデル ID、エンドポイント、結果、制限を残します。変換できない機能は画面で無効にする、理由を伝える、別モデルを案内するなどの対応が考えられます。意味が変わる差異は、指示を黙って捨てるより明示的なエラーが安全です。
同じ名前でも意味を確かめる
プロトコルの変換は、フィールド名の置き換えだけでは終わりません。メッセージを文字列で表す API も、テキストや画像のブロックとして表す API もあります。システム指示、ツール定義、終了理由も構造が異なる場合があります。要求が受理されても、必要な意味が保たれたとは限りません。
フィールドがない場合、空の場合、明示的なゼロや false を渡した場合を区別して試します。それぞれ既定値、空の内容、機能の無効化を意味する可能性があります。クライアントから応答までの経路を確認し、見た目が似た名前だけで同等と判断しないでください。
表現できない機能は、非対応を明示する、ユーザーの確認後に無効化する、別の組み合わせを案内するなど、事前に方針を決めます。画像やツールの指示を黙って捨てると、不完全な結果が成功と誤解されます。
ストリームとツールを別々に試す
ストリームでは最初の文字だけでなく、イベントの境界、増分、終了、エラーを確認します。ツール呼び出しが複数の増分に分かれる場合は、実際の形式に従って引数を組み立て、実行前に検証します。途中で切れた回答を完全な結果として扱ってはいけません。
ツール名、引数、結果の往復も試します。モデルの提案は実行許可ではありません。アプリは引数とユーザー権限を確認し、失敗を処理してから、使用するプロトコルに合う形式で結果を返します。まず一つの読み取り専用ツールで正常値、欠落、不正値を試すと差異を見つけやすくなります。
構造化出力では、モデルが制約を理解するか、API が項目を受け付けるか、不正な出力をアプリが安全に扱えるかを分けて確認します。一度 JSON が返っただけでは常に形式が守られる証拠にはなりません。
更新できる対応表を残す
モデル ID とバージョン、プロトコル、入力形式、ストリーム、ツール、出力形式、確認日を組み合わせごとに記録します。結果は「確認済み」「失敗」「未確認」と条件を残し、一つのチェックマークにすべての能力を押し込めないようにします。テストに実際のキーや顧客データは使いません。
たとえば注文照会を行う助手なら、普通の質問、正しいツール引数、機密を除いた結果、権限不足、タイムアウトを順に試します。最終回答が実際の結果を引用したかも確認します。モデルや経路を変えたら同じサンプルを再実行します。
クライアントやゲートウェイの設定も記録しておくと再現に役立ちます。重要な機能が使えない場合に、機能を一時停止するか、確認済みの別モデルに切り替えるかを決めておきましょう。
具体的な比較例
サポート用アシスタントにテキスト回答と顧客情報の検索が必要だとします。各候補に同じ質問を渡し、正しい検索と不正な引数を試します。モデルがツールを要求したか、サーバーが不正入力を拒否したか、最終回答が結果を使ったかを記録します。後で画像入力を加える場合は別途検証します。