プロバイダー間で能力契約と意味の同等性を確認する

モデルやAPIを切り替える際、toolの名前とJSONの形を揃えるだけでは、同じ仕事を同じ条件で実行できると証明できません。プロバイダーをまたぐ能力契約では、呼出しと結果の対応、実行主体、入出力の意味、権限、終了・失敗、再試行、外部効果を明示し、対応できない差を失わずに扱います。意味の同等性は、対象操作・版・入力範囲・観測条件を指定した検証結果として記録します。

OpenAI Responsesのfunction callingでは、アプリケーションが呼出しを実行し、該当するcall_idに対するfunction_call_outputを渡す流れが示されています。出力は文字列だけに限定されず、対応する画像・fileのcontent配列も扱います[S1]。

Gemini GenerateContent APIのFunctionCallはnameと引数を持ち、idは任意です。IDが渡された場合は、対応するFunctionResponseで一致させます。応答には関数名とJSONのresponseを用い、mediaを含むpartsや、非同期実行の条件に関わるfieldもあります[S2]。この仕様を、別のGemini API surfaceへ自動的に一般化しません。

Claudeのclient toolではtool_useのIDと、アプリケーションが返すtool_result.tool_use_idを対応させます。tool resultは直後のuser messageに置く等、会話内の順序にも条件があります[S3]。server toolはprovider側が実行し、server_tool_useと結果が対応します。pause_turnはclient toolの結果待ちと同じではなく、server toolが続くための継続処理が必要な場合です[S4]。

以上は各APIの文書で確認したprotocol上の事実です。同じ入力について、三社のモデルが同じtoolを選択し、同じ引数を生成し、同じ業務結果へ到達したという実行証拠ではありません。

この表はadapterの対応箇所を示すもので、全tool種別・全モデル・全endpointの相互変換を保証するものではありません。特にserver実行の検索等を、同名のclient関数へ置き換えた場合、実行場所、権限、課金、監査、返却情報の意味が変わり得ます。

共通契約には、少なくとも次の条件を記録します。これは本記事で提案する設計用の契約であり、業界共通規格が存在すると主張するものではありません。

共通表現を作る場合も、native IDと元の応答種別を保存します。内部のoperation IDは業務意図の単位、attempt IDは再試行の単位、native IDはAPI内の対応の単位として区別します。同じ関数名の並列呼出しや再試行があるため、関数名だけをkeyに結果を紐付ける設計は避けます。任意IDがないAPIでは、対応が証明できる範囲と順序の条件を固定し、一意性を確保できない並列変換を拒否します。

同等性の比較対象は、文章表現そのものと、制約を満たした業務結果に分けます。例として「請求書の金額を集計する」能力なら、対象期間、通貨、丸め、税の扱い、重複の除外、欠損値、集計対象の固定を契約にします。二つのモデルの説明文が異なっても、この範囲の集計が一致する可能性があります。一方、同じ数値を返しても対象期間が違えば同等とは扱いません。

構造化出力がparseできたことは、schema制約や業務意味が正しいこととは別です。provider間でサポートするschema機能が異なる場合は、共通の入力契約から各native定義への変換を明示し、変換後の定義と戻り値を検証します。失われた制約をアプリケーション側で検証できない場合、その能力の互換性を宣言しません。本記事では各社の全JSON Schema対応範囲を網羅した互換表は作成していません。

画像・file・音声を伴う結果は、MIME、content順、参照先、アクセス期限、サイズ、解像度等が意味を変える可能性があります。画像を説明文だけに置き換える、複数partsを順序のない文字列へ結合する等は、情報損失を契約へ記録します。「変換できた」と「必要な証拠が保たれた」を別に判定します。

timeout、接続切断、取消要求への応答だけでは、既に始まった外部効果が存在しないと証明できません。書込の成否が不明な状態でproviderを切り替えても、その不明性は消えません。まず書込先を照合し、再実行可能な条件と責任主体を決めます。呼出し対応のIDと、業務側で重複適用を防ぐkeyも同じものと決めつけません。

このcandidateではAPIを実行せず、文書に基づくmappingと検証設計を作成しました。以下は今後の検証計画であり、実行結果ではありません。

• provider/API/model/adapter版とtool定義を固定し、読取専用または外部効果を隔離したfixtureを用意します。
• 単一・並列・同名複数・再試行のcall/result対応を検査し、未知ID、二重result、順序違反、ID欠損の扱いを確認します。
• schema境界、拒否、権限不足、tool error、protocol error、timeout、部分的streaming、途中切断、media損失を別々に試します。構文に加え、対象・値・単位・効果を確認します。
• client実行とserver実行、Claudeの継続状態を分けて試験します。継続が成功しても業務完了の条件が別に残ることを確認します。
• 決定的な処理は期待値、生成結果は事前に定めた許容条件で評価します。入力集合、失敗数、判定者、未評価範囲を残し、全入力・将来版への保証へ拡張しません。
• 書込系は隔離環境でtimeout後の照合と重複防止を検証してから適用します。productionでの効果readbackや運用事故の独立証拠は別の確認事項です。

共通adapterによりnative形式の差を吸収し、同じアプリケーションから複数providerを呼べる場合があります。したがって、差があることだけを理由に全互換性を否定する必要はありません。ただし形式の統一だけから、tool選択、推論品質、権限、遅延、費用、外部効果の同等性を導くことはできません。

公式API資料はprotocolの期待を示しますが、adapter実装の正しさや対象modelの実動作を保証する試験結果ではありません。今回、三providerの同一fixture、streaming途中切断、混在server/client、再試行時の効果照合を実行していません。独立したproduction事故の検証も行っていません。これらの不足は公開文の断定範囲を制限するものであり、未実行の試験をPASSと表示しません。

• 対象アプリケーションでの三provider共通fixtureと、入力範囲を固定した意味の同等性の実測値。
• 具体的model/API/SDK版ごとのschema変換の損失、multimodal制約、streaming・並列・途中切断の実動作。
• server/client混在と非同期継続を含むadapterの正しさ、およびAPI surface変更時の移行条件。
• productionの権限、課金、実行遅延、冪等性、効果readback、独立した運用事故に基づく有効性。

「対象APIの文書でcall/resultの対応と実行主体の差を確認し、共通能力契約に保持する項目を整理しました。実行時の意味の同等性は、対象版・操作・入力範囲・効果の検証を経て判定する必要があります。今回、三providerでの実行互換性や本番の効果同等性は未検証です。」と表現します。

canonical topicの本文、根拠、対応表、失敗条件、制御、反証・限界、UNKNOWN、安全な表現を揃えたため、研究candidateを完了して独立監査へ渡します。実行証拠の不足は明示したまま、同じ一般資料の検索を反復しません。監査担当がexact candidateとsource claimを照合するまで、AUDIT_PASS、READY、公開済みとは扱いません。

• S1 OpenAI, Function calling: https://developers.openai.com/api/docs/guides/function-calling — Responsesの呼出し、call_id、function_call_output、content形式。2026-10-18に公式文書確認。
• S2 Google, GenerateContent API reference: https://ai.google.dev/api/generate-content — FunctionCall/FunctionResponse、任意IDと対応、name、response、parts。2026-10-18に公式文書確認。GenerateContentの範囲。
• S3 Anthropic, Handle tool calls: https://platform.claude.com/docs/en/agents-and-tools/tool-use/handle-tool-calls — client toolのID対応、result形式とmessage順序。2026-10-18に公式文書確認。
• S4 Anthropic, Server tools: https://platform.claude.com/docs/en/agents-and-tools/tool-use/server-tools — server側実行、client/serverの区別、pause_turn継続。2026-10-18に公式文書確認。

既存研究の起点はEA_REVISION_LEDGERのEA-519-R1-20261013です。今回のprovider文書の再確認、本文作成、保存内容のhash照合は、未実行のAPI・負荷・障害試験の代わりにはなりません。