Claudeは複数のツールを同時に実行するネイティブな機能を備えていますが、バージョンによってはこれを期待するほど活用しないことがあります。バッチツールを実装することで、Claudeが単一のメッセージ内で複数のツール呼び出しを行う可能性を大幅に高めることができます。

Claudeがメッセージ内でツール使用パートを返す際、単一のレスポンスに複数のツールリクエストが含まれることがあります。例えば、「2025年3月12日の50日後は何日ですか?また、2025年3月12日の100日後は何日ですか?」と尋ねた場合、Claudeは理論上、それぞれの計算に対して別々のツール使用パートを2つ返すことができます。これらの操作は互いに依存していないため、完全に並列化可能です。
しかし、Claudeは期待するほどツール呼び出しを並列化しようとするとは限りません。両方の呼び出しを同時に行う代わりに、順次実行することが多く、これは効率が悪くなります。
バッチツールの仕組み
バッチツールは他のツールと同様に実装されます。ツール仕様と、呼び出された際にそれを処理する関数が必要です。重要な考え方は、複数の他のツールを同時に呼び出すことができるツールを作成することです。
以下は、バッチツール仕様の基本構造です。
{
"name": "batch_tool",
"description": "Invoke multiple other tool calls simultaneously",
"input_schema": {
"type": "object",
"properties": {
"invocations": {
"type": "array",
"description": "The tool calls to invoke",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the tool to invoke"
},
"arguments": {
"type": "string",
"description": "The arguments to the tool, encoded as a JSON string"
}
},
"required": ["name", "arguments"]
}
}
},
"required": ["invocations"]
}
}このツールは呼び出しのリストを受け取り、各呼び出しには呼び出すツールの名前とその引数(JSON文字列としてエンコードされたもの)が含まれます。
実装
バッチツールの実装には、主に2つの関数が関わります。
run_batch関数
def run_batch(tool_input):
batch_output = []
for invocation in tool_input["invocations"]:
tool_name = invocation["name"]
args = json.loads(invocation["arguments"])
tool_output = run_tool(tool_name, args)
batch_output.append({"tool_name": tool_name, "output": tool_output})
return batch_outputこの関数は各呼び出しをループ処理し、ツール名と引数を抽出して、既存のrun_tool関数を使用して該当するツールを呼び出し、すべての結果を収集します。
run_toolへの追加
メインのrun_tool関数にもケースを追加する必要があります。
elif tool_name == "batch_tool":
return run_batch(tool_input)他のツールとは異なり、バッチツールは生の入力構造を処理する必要があるため、スプラット演算子(**)を使わずにtool_inputをそのまま渡す点に注意してください。
結果
バッチツールを実装して同じ日付計算のクエリを実行すると、メッセージログに2つの別々のツール呼び出しが表示される代わりに、バッチツールへの単一の呼び出しが1つ表示されるようになります。この単一の呼び出しには、両方の日付計算がサブ呼び出しとして含まれており、実質的に操作が並列化されています。
バッチツールは、同時に実行できる複数の独立した操作がある場合に特に便利です。Claudeに「このパターンを使わせるように仕向ける」ことで、ツール呼び出しワークフローの効率を大幅に向上させることができます。