Claude Platform Docs
メッセージツール

ツール呼び出しの処理

tool_use ブロックの解析、tool_result レスポンスのフォーマット、is_error によるエラー処理について説明します。

Claudeのレスポンスに tool_use ブロックが含まれている場合、コードで各ツールを実行し、エラーも含めて tool_result ブロックを返送します。ツール実行をカスタム制御する必要がある場合は、このコードを自分で記述してください。それ以外の場合は、SDKのツールランナーを使用してください。ツールランナーがツールを実行し、結果を送信します。

Claudeのレスポンスは、クライアントツールとサーバーツールのどちらを使用するかによって異なります。

クライアントツールからの結果の処理

応答には、stop_reasonがtool_useであることと、以下を含む1つ以上のtool_useコンテンツブロックが含まれます:

  • id:この特定のツール使用ブロックの一意の識別子です。後でツールの結果を照合するために使用されます。
  • name:使用されるツールの名前。
  • input:ツールに渡される入力を含むオブジェクト。ツールの input_schema に準拠します。

コンピューター使用またはブラウザ使用ツールセットのメンバーに対する tool_use ブロックには、toolset_name フィールド("computer" または "browser")も含まれます。その name は、screenshot や navigate など、Claudeが呼び出しているメンバーツールであるため、これらのブロックは両方のフィールドに基づいてディスパッチしてください。

クライアントツールに対するツール使用レスポンスを受け取ったら、次の手順に従います。

  1. 各 tool_use ブロックについて、そのブロックが指定するツールを実行し、その input を渡します。
  2. 新しいリクエストで、以前のメッセージを保持し、レスポンスの content を変更せずに assistant メッセージとして追加します。
  3. そのcontent内の各 tool_use ブロックに対して1つずつ tool_result ブロックを含む user メッセージを追加します。ツールが失敗した場合も同様です。
  4. 最初のリクエストと同じ tools を指定してリクエストを送信します。Claudeはツールの結果を使用してレスポンスを続けます。
  5. 次のレスポンスの stop_reason も tool_use の場合は、これらの手順を繰り返します。その他の値については、停止理由のクイックリファレンスを参照してください。

これらの手順を完全なプログラムとして確認するには、チュートリアル:ツールを使用するエージェントを構築するを参照してください。

各 tool_result ブロックでは、type が tool_result に設定され、さらに次のフィールドを持ちます。

  • tool_use_id:この結果が応答する tool_use ブロックの id。
  • content(オプション):ツールの結果。文字列またはコンテンツブロックのリストとして指定します。これらのコンテンツブロックでは、text、image、document、または search_result タイプを使用できます。
  • is_error(オプション):ツールが失敗した場合、または呼び出しが無効だった場合は true に設定します。

たとえば、成功したツール結果は次のようになります:

JSON
{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "15 degrees"
    }
  ]
}

コンピューター使用またはブラウザ使用のメンバーブロックに応答する tool_result は、tool_use ブロックと同じ toolset_name の値もそのまま返す必要があります。これを省略したメンバー結果は拒否されます。また、その content はより限定されています。メンバー結果には text ブロックと image ブロックのみを含めることができ、ブラウザ使用の結果には1つの browser_state ブロックを追加できます(タブ管理メンバーはそのブロックのみを返します)。

サーバーツールからの結果の処理

Claudeはツールを内部で実行し、追加のユーザー操作を必要とせずに、その結果を応答に直接組み込みます。

is_error によるエラー処理

クライアントツールが失敗した場合、または呼び出しが無効な場合は、is_error を true に設定した tool_result ブロックを送信します。その後、Claudeは新しい tool_use ブロックでツールを再度呼び出す可能性があるため、ループで許可する再試行回数を制限してください。

次のステップ

Claudeが1回のターンで複数のツールを呼び出すレスポンスを処理します。

tool_use ループ、結果のフォーマット、再試行をSDKに任せます。

Claudeを適切なツールへ導くスキーマと説明を記述します。

このページは役に立ちましたか?