読み込み中

ツール結果の送信

レッスン 2510 分
読み込み中

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

ツール関数の実行

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

python
response.content[1].input

これにより、Claudeが自分の関数に渡したい引数の辞書が得られます。自分の関数は辞書ではなくキーワード引数を期待しているため、Pythonのアンパック構文を使用します。

python
get_current_datetime(**response.content[1].input)

上記のアンパック呼び出しを実行しているノートブックのセルで、時刻文字列 "14:41:05" を返している。

ツール結果ブロック

ツール関数を実行した後、ツール結果ブロックを使ってその結果をClaudeに送り返す必要があります。このブロックはユーザーメッセージの中に入り、ツールを実行したときに何が起こったかをClaudeに伝えます。

type が "tool_result"、content が "12:47:13"、is_error が False、対応する tool_use_id を持つツール結果JSONの例。

ツール結果ブロックには、いくつかの重要なプロパティがあります。

  • tool_use_id - このToolResultが対応するToolUseブロックのidと一致している必要があります
  • content - ツールを実行した結果の出力で、文字列としてシリアライズされたもの
  • is_error - エラーが発生した場合はTrue

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

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

Claudeが10 + 10用のab3と30 + 30用のpo9という計算ツール使用ブロックを送信し、結果はpo9の出力60、続いてab3の出力20として返る。

各ツール呼び出しには一意のIDが割り当てられ、結果を送り返す際にはこれらのIDを一致させる必要があります。これにより、結果が異なる順序で届いたとしても、Claudeがどの結果がどのリクエストに対応しているかを把握できます。

Claudeが10 + 10用のab3と30 + 30用のpo9というツール使用を返し、私たちのサーバーがpo9の出力60、続いてab3の出力20を返信している。

フォローアップリクエストの構築

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

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

これで、完全なメッセージ履歴には次のものが含まれます。

  • 元のユーザーメッセージ
  • ツール使用ブロックを含むアシスタントメッセージ
  • ツール結果ブロックを含むユーザーメッセージ

最終リクエストを送る

フォローアップリクエストを送信する際には、Claudeに別のツール呼び出しを期待していなくても、ツールスキーマを引き続き含める必要があります。Claudeが会話履歴内のツール参照を理解するには、このスキーマが必要です。

python
client.messages.create(
    model=model,
    max_tokens=1000,
    messages=messages,
    tools=[get_current_datetime_schema]
)

私たちのサーバーがClaudeにツールスキーマ、質問「今の時刻は?」、ツール使用ブロックとツール結果ブロックを送信している。

その後Claudeは、ツールの結果を取り込んでユーザー向けの自然な応答にまとめた最終メッセージで応答します。これでツール使用のワークフローは完了です。自分のカスタム関数を通じて、Claudeがリアルタイム情報にアクセスできるようにすることに成功しました。