ADKマルチエージェント構成で遭遇する「Multiple tools」エラーと解決策

はじめに

Google ADK（Agent Development Kit）を使ってエージェントアプリケーションを構築していたところ、以下のエラーに遭遇しました。

400 INVALID_ARGUMENT: Multiple tools are supported only when they are all search tools.

本記事では、このエラーの原因の調査から解決に至るまでの経緯を整理します。

検証環境: ADK v1.28.0、Vertex AI 経由、Python 3.13

単一エージェントでのツール混在

最初に作ろうとしていたのは、カスタム関数（Function Calling）と Google Search を1つのエージェントにまとめた構成でした。

from google.adk.agents import Agent
from google.adk.tools import google_search

agent = Agent(
    model="gemini-2.5-flash",
    name="assistant",
    instruction="...",
    tools=[
        search_knowledge_base,  # カスタム Python 関数
        google_search,          # Gemini 組み込みツール
    ],
)

しかし、これを実行してみると以下のエラーが返ってきました。

400 INVALID_ARGUMENT. {'error': {'code': 400, 'message': 'Multiple tools are supported only when they are all search tools.', 'status': 'INVALID_ARGUMENT'}}

原因

調べてみたところ、Gemini 2.x 系のモデルでは、1回の API リクエストに含められるツールは1種類のみという制約があるようです。ADK が提供するツールには、大きく分けて以下の種別があります。

カスタム関数以外は Gemini の組み込みツールとして扱われます。カスタム関数と組み込みツールを1つの API リクエストに含めることができない、という制約です。ちなみに、これは ADK の制約ではなく、Gemini API（モデル）側の制約 になります。

sub_agents 構成での回避を試みる

ツール種別を分離すれば回避できるのではないかと考え、各サブエージェントが1種類のツールのみを持つ sub_agents 構成に変更してみました。

search_agent = Agent(
    model="gemini-2.5-flash",
    name="search_agent",
    description="組織固有のナレッジベースを検索するエージェント",
    instruction="...",
    tools=[search_knowledge_base],  # FunctionDeclaration のみ
)

web_agent = Agent(
    model="gemini-2.5-flash",
    name="web_agent",
    description="一般的な情報を Google 検索で取得するエージェント",
    instruction="...",
    tools=[google_search],          # 組み込みツールのみ
)

root_agent = Agent(
    model="gemini-2.5-flash",
    name="root_agent",
    instruction="ユーザーの質問に応じて適切なサブエージェントに委譲する",
    sub_agents=[search_agent, web_agent],
)

これなら大丈夫だろうと思っていたのですが、この構成でも同じ 400 INVALID_ARGUMENT エラーが発生しました。

関連するIssue

この問題は Issue として報告・議論されています。

• google/adk-python#899
• google/adk-python#969

Issue 内では AgentTool でラップする方法や、組み込みツールをカスタム関数に置き換える方法などの回避策が提案されています。ただ、ADK のバージョンや構成によって効果が異なるとの報告もあり、自分の環境では解決には至りませんでした。

Gemini 3 で解決

そんな中、Gemini 3 モデルでツールの組み合わせ（Tool Combination） 機能がサポートされたことがわかりました（プレビュー）。

https://ai.google.dev/gemini-api/docs/tool-combination?hl=ja

これにより、組み込みツールとカスタム関数を同一リクエスト内で併用できるようになりました。

検証結果

実際に動くのか気になったので、モデルを gemini-3-flash-preview に変更して4つの構成を検証してみました。

Gemini 3 にすることで、単一エージェントでもサブエージェント構成でもツール種別の制約を気にする必要がなくなったようです。

まとめ

Gemini 2.x 系では、組み込みツールとカスタム関数の混在による 400 INVALID_ARGUMENT エラーが発生します。sub_agents でツールを分離しても回避できず、なかなか悩ましい制約でした。

Gemini 3 では Tool Combination 機能（プレビュー）により、この制約が解消されています。単一エージェントでもサブエージェント構成でも正常に動作することを確認できたので、同じエラーで困っている方の参考になれば幸いです。