読み込み中

バッチツール

レッスン 3010 分
読み込み中

Claudeのツール呼び出し機能を使用していると、Claudeが単一のアシスタントメッセージに複数のツール使用ブロックを含められることに気づくかもしれません。これにより、Claudeはそれぞれに対して別々のリクエストを行うのではなく、複数のツールを並行して実行できます。しかし、実際にはClaudeにこれを一貫して行わせるのは難しい場合があります。

複数のツール呼び出しに関する問題

同じ日付で2つのリマインダーを設定するようClaudeに依頼したとします。理論上、Claudeはそれぞれのリマインダーに対応する2つのツール使用ブロックを含む単一のレスポンスを返せるはずです。しかし実際には、Claudeは代わりに別々のレスポンスを送ることがよくあります。

理想的なやり取り:1つのアシスタントメッセージに、1月1日の「税金の支払い」と「医者の予約」に対する2つのset_reminderツール使用が含まれている。

通常起こるのは、Claudeが最初のツール呼び出しを行い、その結果を待ってから、フォローアップメッセージで2番目のツール呼び出しを行うというパターンです。これにより、同時に行えたはずの操作のために不要なやり取りが発生してしまいます。

Claudeは、私たちのサーバーからの2つのリマインダーのリクエストに対し、1つのbatch_tool呼び出しで応答する:「Dr appt」と「Taxes due」のset_reminder。

バッチツールによる解決策

解決策は、「バッチツール」を実装することです。これは、同時に実行すべき他のツール呼び出しのリストを受け取る特別なツールです。これは本質的に、Claudeに一度に複数のツール呼び出しを行わせるための回避策です。

Claudeは、私たちのサーバーからの2つのリマインダーのリクエストに対し、1つのbatch_tool呼び出しで応答する:「Dr appt」と「Taxes due」のset_reminder。

動作の仕組みは次のとおりです:

  • 複数の他のツールを並行して実行できることをClaudeに伝えるバッチツールスキーマを定義します
  • ツールを直接呼び出す代わりに、Claudeはツール呼び出しのリストを使ってバッチツールを呼び出します
  • あなたのコードがこのリストを処理し、各ツール呼び出しを実行します
  • 結果をまとめてClaudeに返します

バッチツールスキーマの実装

バッチツールスキーマは、Claudeが複数のツールを実行したい場合にどのようにリクエストを構成すべきかを定義します:

python
batch_tool_schema = {
    "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": "object",
                            "description": "The arguments to pass to the tool"
                        }
                    }
                }
            }
        }
    }
}

バッチツール呼び出しの処理

Claudeがバッチツールを使用する場合、呼び出しのリストを処理してそれぞれを実行する必要があります。実装方法は以下のとおりです:

python
def run_batch(invocations=[]):
    batch_output = []
    
    for invocation in invocations:
        name = invocation["name"]
        args = invocation["arguments"]
        
        tool_output = run_tool(name, args)
        
        batch_output.append({
            "tool_name": name,
            "output": tool_output
        })
    
    return batch_output

バッチツール呼び出しを処理できるように、メインのツールルーティング関数も更新する必要があります:

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    elif tool_name == "add_duration_to_datetime":
        return add_duration_to_datetime(**tool_input)
    elif tool_name == "set_reminder":
        return set_reminder(**tool_input)
    elif tool_name == "batch_tool":
        return run_batch(**tool_input)

結果

バッチツールを実装することで、Claudeは関連する操作をまとめてグループ化する可能性がはるかに高くなります。各リマインダーに対して別々のリクエストを行う代わりに、Claudeはバッチツールを使用して両方のリマインダーを同時に設定するようになります。

会話の流れがはるかにすっきりします。ユーザーからの1つのリクエスト、バッチツール呼び出しを伴うClaudeからの1つのレスポンス、そしてすべての結果を含む1つのフォローアップです。これによりレイテンシが削減され、アプリケーションがより効率的になります。

回避策のように見えるかもしれません(実際そうです)が、バッチツールのパターンは、並列化できる操作についてClaudeに考えさせ、それらをより効率的に実行させるための効果的な方法です。