読み込み中

ツール関数を実行する

レッスン 2510 分
読み込み中

Claudeがツール使用リクエストで応答すると、サーバー側でリクエストされたツールを実際に実行し、結果を送り返す必要があります。このステップでは、Claudeのレスポンスからツール使用部分を抽出し、適切な関数を実行し、結果を適切な形式にフォーマットする作業が含まれます。

複数のツールリクエストの処理

Claudeは1回のレスポンスで複数のツール使用部分を送信できます。コードはこの可能性に対して防御的に対処する必要があります。アシスタントメッセージには、テキスト部分の後に1つ、2つ、あるいはそれ以上のツール使用部分が続く場合があります。

アシスタントメッセージの各部分:現在時刻を調べることを申し出る「テキスト」部分と、get_current_datetimeの「toolUse」部分。

この流れは次のようになります。Claudeは JSON スキーマを含むリクエストを送信し、ツール使用部分を受け取り、その後サーバー側でツールを実行し、Claudeが最終的な応答を返せるようツール結果部分を送り返します。

サーバーからClaudeへユーザーメッセージ「What time is it?」、アシスタントのテキストとツール使用部分、そしてツール結果部分が送られます。

ツール使用部分の抽出

まず、チャットリクエストから返されたすべての部分を処理する関数を作成します。

python
def run_tools(parts):
    tool_requests = [part for part in parts if "toolUse" in part]
    tool_result_parts = []
    
    for tool_request in tool_requests:
        tool_use_id = tool_request["toolUse"]["toolUseId"]
        tool_name = tool_request["toolUse"]["name"]
        tool_input = tool_request["toolUse"]["input"]

この内包表記は、部分のリストをフィルタリングして「toolUse」キーを含む辞書のみを含めるようにし、テキスト部分を無視します。

実際のツールの実行

リクエストされたツールを実行するヘルパー関数を作成します。

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    else:
        raise Exception(f"Unknown tool name: {tool_name}")

ここで重要な点は、**tool_input を使用して引数の辞書をツール関数に展開(splat)することです。Claudeは常に引数を辞書オブジェクトとして返すため、それを適切にアンパックする必要があります。

ツール結果部分の作成

ツールを実行した後、応答をツール結果部分としてフォーマットする必要があります。

テキスト部分と、get_current_datetimeおよびother_toolの2つの「toolUse」部分を含むアシスタントメッセージのコンテンツリスト。

ツール結果部分には3つの重要なプロパティが必要です。

  • toolUseId - 元のツール使用部分のIDと一致している必要があります
  • content - ツールからの出力で、文字列としてシリアライズされたもの
  • status - "success" または "error" のいずれか

ツール使用IDの理解

ツール使用ID システムは、Claudeが複数のツールを並行してリクエストする場合に重要になります。例えば、Claudeが計算機ツールを2回実行したい場合です。

Claudeが10 + 10のためのツール使用ab3と、30 + 30のためのツール使用po9を送信し、サーバーはpo9の出力60とab3の出力20を返します。 Claudeが10 + 10のためのツール使用ab3と、30 + 30のためのツール使用po9を送信し、サーバーはpo9の出力60とab3の出力20を返します。

各ツール使用には一意のID(「ab3」や「po9」のような)が付与され、ツール結果には一致するIDを含める必要があり、これによりClaudeはどの結果がどのリクエストに対応するかを把握できます。

エラー処理

ツールの実行はtry-catchブロックで囲んでください。Claudeはツールエラーについて賢く対応し、適切なエラー情報を返せばアプローチを調整することがあります。

python
try:
    tool_output = run_tool(tool_name, tool_input)
    tool_result_part = {
        "toolResult": {
            "toolUseId": tool_use_id,
            "content": [{"text": json.dumps(tool_output)}],
            "status": "success"
        }
    }
except Exception as e:
    tool_result_part = {
        "toolResult": {
            "toolUseId": tool_use_id,
            "content": [{"text": f"Error: {e}"}],
            "status": "error"
        }
    }

完全な実装

ツールリクエストを処理し、フォーマットされた結果を返す完全な関数は以下の通りです。

python
def run_tools(parts):
    tool_requests = [part for part in parts if "toolUse" in part]
    tool_result_parts = []
    
    for tool_request in tool_requests:
        tool_use_id = tool_request["toolUse"]["toolUseId"]
        tool_name = tool_request["toolUse"]["name"]
        tool_input = tool_request["toolUse"]["input"]
        
        try:
            tool_output = run_tool(tool_name, tool_input)
            tool_result_part = {
                "toolResult": {
                    "toolUseId": tool_use_id,
                    "content": [{"text": json.dumps(tool_output)}],
                    "status": "success"
                }
            }
        except Exception as e:
            tool_result_part = {
                "toolResult": {
                    "toolUseId": tool_use_id,
                    "content": [{"text": f"Error: {e}"}],
                    "status": "error"
                }
            }
        
        tool_result_parts.append(tool_result_part)
    
    return tool_result_parts

ツール結果部分を取得したら、それらを次のチャットリクエストでClaudeに送り返すことで、ツール使用のサイクルが完了します。