ツール呼び出しの処理

このページでは、ツール呼び出しのライフサイクルについて説明します。具体的には、Claudeのレスポンスからtool_useブロックを読み取る方法、返信でtool_resultブロックをフォーマットする方法、エラーを通知する方法を扱います。これを自動的に処理するSDKの抽象化については、Tool Runnerを参照してください。

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



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

レスポンスにはtool_useのstop_reasonと、以下を含む1つ以上のtool_useコンテンツブロックが含まれます。

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

クライアントツールのツール使用レスポンスを受け取った場合、以下を行う必要があります。

1. tool_useブロックからname、id、inputを抽出します。
2. そのツール名に対応するコードベース内の実際のツールを実行し、ツールのinputを渡します。
3. userのroleと、tool_resultタイプおよび以下の情報を含むcontentブロックを持つ新しいメッセージを送信して、会話を続けます。
   • tool_use_id：この結果が対応するツール使用リクエストのid。
   • content（オプション）：ツールの結果。文字列（例："content": "15 degrees"）、ネストされたコンテンツブロックのリスト（例："content": [{"type": "text", "text": "15 degrees"}]）、またはドキュメントブロックのリスト（例："content": [{"type": "document", "source": {"type": "text", "media_type": "text/plain", "data": "15 degrees"}}]）として指定します。これらのコンテンツブロックには、text、image、document、またはsearch_resultタイプを使用できます。
   • is_error（オプション）：ツール実行がエラーになった場合はtrueに設定します。

{
  "role": "user",
  "content": [
    { "type": "text", "text": "Here are the results:" }, // ❌ Text before tool_result
    { "type": "tool_result", "tool_use_id": "toolu_01" /* ... */ }
  ]
}

{
  "role": "user",
  "content": [
    { "type": "tool_result", "tool_use_id": "toolu_01" /* ... */ },
    { "type": "text", "text": "What should I do next?" } // ✅ Text after tool_result
  ]
}

ツール結果を受け取った後、Claudeはその情報を使用して、元のユーザープロンプトへのレスポンスの生成を続けます。



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

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



is_errorによるエラー処理

Claudeでツールを使用する際に発生する可能性のあるエラーには、いくつかの種類があります。



次のステップ