AIToday
大規模言語モデルAIコーディングZenn AI/ML掲載日時: 2026年11月4日 6:00

APIごとにツール定義が異なる

LINEで送る
APIごとにツール定義が異なる

3つのポイント

  1. 何が起きたか

    OpenAI、Anthropic、Geminiのツール呼び出しAPIを比較したZennの記事で、同じ名前・説明・スキーマでも入れ子構造や命名規則が異なると判明。ドットを許容するのはGeminiのみ。

  2. なぜ重要か

    あるプロバイダーのツール定義を別のプロバイダーへ移すだけで、リクエスト送信前に名前由来の拒否に遭う可能性があると記事は指摘。複数ベンダー対応を計画するチームにとって移植性の障壁となる。

わからないところ、AIに聞けます

質問と回答はこのページに公開されます。

こういう要約が、毎朝あなたのメールに届きます。

背景と解説

記事はツール呼び出しの仕組みを説明する。モデルが特定の引数で関数を実行するよう要求を返し、実際に実行するのは自分のコードだ。ベンダー間で変わるのはその要求の包み方だけであり、名前・説明・引数スキーマをどこに置くか、名前にどの文字を使えるかが異なる。OpenAIの2つのエンドポイントはすでに互いに異なり、Chat Completionsはフィールドをfunctionの下に入れ子にし、Responsesは同じ階層に置く。Anthropicはスキーマのフィールド名をinput_schemaに変え、Geminiは宣言をfunctionDeclarationsの下にまとめる。

記事は送信前の落とし穴も指摘する。OpenAIのstrictモードはadditionalPropertiesをfalseに設定し、すべてのプロパティをrequiredに列挙する必要があり、strictのデフォルトはChat CompletionsとResponsesで異なる。Anthropicはinput_examplesのサンプルが1つでもツール自身のスキーマと一致しないと、リクエスト全体を400エラーで拒否する。またこれらのサンプルはプロンプトのトークンを増やし、単純なもので約20〜50、深く入れ子になった形では100〜200ほどになる。GeminiはparametersとparametersJsonSchemaの同時指定を禁じている。

ローカル側では、Ollamaが各モデルにtools、thinking、vision、embeddingなどのケイパビリティをラベル付けし、toolsラベルを持つモデルだけが関数を呼び出せる。ライブラリは頻繁に変わるため、記事はモデルのサイズから対応を推測せず、使う予定のタグページでラベルを確認するよう勧めている。

よくある質問
3つのAPIのツール定義の主な違いは何か?
OpenAIのChat Completionsはnameとparametersをfunctionオブジェクト内に入れ子にし、Responsesはそれらを平坦化する。Anthropicは引数スキーマにinput_schemaを使い、GeminiはfunctionDeclarationsの下に宣言を並べる。
移植性を最も損ないやすい命名規則はどれか?
関数名にコロンとドットを許すのはGeminiのみで、get.weatherのような名前はGeminiでは通るが、OpenAIとAnthropicでは拒否されうる。
ローカルモデルはツール呼び出しを扱えるか?
Ollamaのtoolsラベルを持つモデルなら扱える。そうしたモデルは単一・並列のツール呼び出しに加え、マルチターンのエージェントループにも対応すると記事は説明する。
LINEで送る

あなたの仕事に関係するAIニュースを、毎朝お届けします。

業界と使っているAIツールを選ぶと、仕事に関係するニュースが毎朝届きます。

登録無料・Googleアカウントなら30秒・いつでも解除できますAITodayについて →

AIに質問

この記事についてわからないことをAIに質問できます。AIはこの記事・AIToday の過去記事・Wikipedia を読み、出典を付けて答えます。Q&Aはこのページに公開され、他の読者も読めます。

質問と回答はこのページに公開されます。

このようなAIの動きを、御社の業界・競合に合わせて毎日届ける法人プランもあります → 詳しく見る

関連記事

次の記事へDraxなど英で1GW超AIデータセンター共同開発へ