読み込み中

ツール結果を送信する

レッスン 267 分
読み込み中

Claudeがツール呼び出しをリクエストした後、その関数を実行して結果を送り返す必要があります。これにより、Claudeがリクエストした情報を提供することで、ツール使用のワークフローが完了します。

ツール関数を実行する

Claudeがツール使用ブロックで応答すると、入力パラメータを抽出して自分の関数を呼び出します。ツールのパラメータにアクセスする方法は次のとおりです。

python
# ツール使用ブロックにアクセスする
tool_use_block = response.content[1]

# 入力パラメータを取得する
input_params = tool_use_block.input

# パラメータを使って関数を呼び出す
result = get_current_datetime(**input_params)

二重アスタリスク(**)は、辞書を展開して、関数が期待するキーワード引数にします。

ツール結果ブロック

ツールを実行した後、ツール結果ブロックを使って結果をClaudeに送り返します。このブロックにはいくつかの重要なプロパティがあります。

type「tool_result」、content「12:47:13」、is_error False、一致するtool_use_idを持つツール結果JSONの例。

  • tool_use_id - 元のツール使用ブロックのIDと一致している必要があります
  • content - ツール関数からの出力を文字列に変換したもの
  • is_error - 実行中にエラーが発生した場合はtrueに設定します

複数のツール呼び出しを処理する

Claudeは1回の応答で複数のツール呼び出しをリクエストできます。例えば、ユーザーが「10 + 10と30 + 30はいくつですか?」と尋ねた場合、Claudeは2つの別々のツール使用ブロックを送信するかもしれません。

Claudeは10 + 10用のab3と30 + 30用のpo9という電卓ツール使用ブロックを送信し、結果はpo9出力60、続いてab3出力20として返ってきます。

各ツール使用ブロックには一意のIDが付与されており、結果を送り返す際にはこれらのIDを一致させる必要があります。

Claudeは10 + 10用のツール使用ab3と30 + 30用のpo9を返し、サーバーはpo9出力60、続いてab3出力20で応答します。

このIDシステムにより、結果が異なる順序で到着した場合でも、Claudeは各結果を対応するリクエストに正しく一致させることができます。

フォローアップリクエストを送信する

Claudeへのフォローアップリクエストには、完全な会話履歴に新しいツール結果を加えたものを含める必要があります。

python
messages.append({
    "role": "user",
    "content": [{
        "type": "tool_result",
        "tool_use_id": response.content[1].id,
        "content": result,
        "is_error": False
    }]
})

会話の流れは次のようになります。

サーバーはClaudeにツールスキーマ、「現在の時刻は?」という質問、ツール使用ブロックとツール結果ブロックを送信します。

Claudeはおそらく再度ツールを呼び出す必要はありませんが、フォローアップリクエストにはツールスキーマを含めることを忘れないでください。Claudeは会話履歴内のツール参照を理解するためにそのスキーマを必要とします。

完全なワークフロー

完全なプロセスは次のとおりです。

  1. ユーザーがツール使用を必要とする質問をする
  2. Claudeがツール使用ブロックで応答する
  3. リクエストされたツール関数を実行する
  4. ツール結果を付けてフォローアップリクエストを送信する
  5. Claudeがツールの出力を使って最終的な回答を提供する

最終的なリクエストには、完全なメッセージ履歴、ツール結果ブロック、そしてツールスキーマが含まれます。その後Claudeは、あなたのツール実行による情報を組み込んだ通常のテキストメッセージで応答します。