読み込み中

バッチツール使用

レッスン 299 分
読み込み中

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

Claudeは、2つのToolUseパートを含む1つのアシスタントメッセージを返します。どちらもadd_duration: 2025年3月12日 + 50日と + 100日です。

Claudeがメッセージ内でツール使用パートを返す際、単一のレスポンスに複数のツールリクエストが含まれることがあります。例えば、「2025年3月12日の50日後は何日ですか?また、2025年3月12日の100日後は何日ですか?」と尋ねた場合、Claudeは理論上、それぞれの計算に対して別々のツール使用パートを2つ返すことができます。これらの操作は互いに依存していないため、完全に並列化可能です。

しかし、Claudeは期待するほどツール呼び出しを並列化しようとするとは限りません。両方の呼び出しを同時に行う代わりに、順次実行することが多く、これは効率が悪くなります。

バッチツールの仕組み

バッチツールは他のツールと同様に実装されます。ツール仕様と、呼び出された際にそれを処理する関数が必要です。重要な考え方は、複数の他のツールを同時に呼び出すことができるツールを作成することです。

以下は、バッチツール仕様の基本構造です。

json
{
  "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関数

python
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関数にもケースを追加する必要があります。

python
elif tool_name == "batch_tool":
    return run_batch(tool_input)

他のツールとは異なり、バッチツールは生の入力構造を処理する必要があるため、スプラット演算子(**)を使わずにtool_inputをそのまま渡す点に注意してください。

結果

バッチツールを実装して同じ日付計算のクエリを実行すると、メッセージログに2つの別々のツール呼び出しが表示される代わりに、バッチツールへの単一の呼び出しが1つ表示されるようになります。この単一の呼び出しには、両方の日付計算がサブ呼び出しとして含まれており、実質的に操作が並列化されています。

バッチツールは、同時に実行できる複数の独立した操作がある場合に特に便利です。Claudeに「このパターンを使わせるように仕向ける」ことで、ツール呼び出しワークフローの効率を大幅に向上させることができます。