ツール呼び出しの処理

このページでは、ツール呼び出しのライフサイクルについて説明します。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. roleがuserで、tool_resultタイプを含むcontentブロックを含む新しいメッセージを送信して、会話を続けます。以下の情報を含みます:
   • tool_use_id: これが結果である、ツール使用リクエストのid。
   • content: ツールの結果。文字列（例えば、"content": "15 degrees"）、ネストされたコンテンツブロックのリスト（例えば、"content": [{"type": "text", "text": "15 degrees"}]）、またはドキュメントブロックのリスト（例えば、）。これらのコンテンツブロックは、、またはタイプを使用できます。

{
  "role": "user",
  "content": [
    { "type": "text", "text": "Here are the results:" }, // ❌ tool_resultの前のテキスト
    { "type": "tool_result", "tool_use_id": "toolu_01" /* ... */ }
  ]
}

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

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

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

is_errorでエラーを処理する

Claudeでツールを使用する場合、いくつかの異なるタイプのエラーが発生する可能性があります:

次のステップ

• 1回のターンで複数のツールを実行する場合は、並列ツール使用を参照してください。
• このループを自動化するSDK抽象化については、Tool Runnerを参照してください。
• 完全なツール使用ワークフローについては、ツールの定義を参照してください。