ツール使用の実装方法

​

モデルの選択

​

クライアントツールの指定

​

ツール使用システムプロンプト

この環境では、ユーザーの質問に答えるために使用できるツールのセットにアクセスできます。
{{ フォーマット指示 }}
文字列とスカラーパラメータはそのまま指定し、リストとオブジェクトはJSON形式を使用する必要があります。文字列値のスペースは削除されないことに注意してください。出力は有効なXMLである必要はなく、正規表現で解析されます。
JSONSchema形式で利用可能な関数は次のとおりです：
{{ JSON SCHEMA でのツール定義 }}
{{ ユーザーシステムプロンプト }}
{{ ツール設定 }}

​

ツール定義のベストプラクティス

• 極めて詳細な説明を提供する。 これはツールのパフォーマンスにおいて最も重要な要因です。説明には以下を含むツールに関するすべての詳細を説明する必要があります：
  • ツールが何をするか
  • いつ使用すべきか（そしていつ使用すべきでないか）
  • 各パラメータが何を意味し、ツールの動作にどのように影響するか
  • ツール名が不明確な場合にツールが返さない情報など、重要な注意事項や制限。Claude にツールについてより多くのコンテキストを提供するほど、いつどのように使用するかをより適切に決定できるようになります。ツールの説明には少なくとも3〜4文を目指し、ツールが複雑な場合はそれ以上にしてください。
• 例よりも説明を優先する。 ツールの説明や付随するプロンプトにツールの使用例を含めることはできますが、これはツールの目的とパラメータの明確で包括的な説明を持つことよりも重要ではありません。説明を完全に肉付けした後にのみ例を追加してください。

​

Claude の出力の制御

​

ツール使用の強制

tool_choice = {"type": "tool", "name": "get_weather"}

• auto は、提供されたツールを呼び出すかどうかを Claude に決定させます。これは tools が提供された場合のデフォルト値です。
• any は、提供されたツールのいずれかを使用する必要があることを Claude に伝えますが、特定のツールを強制しません。
• tool は、常に特定のツールを使用するように Claude を強制できます。
• none は、Claude がツールを使用することを防ぎます。これは tools が提供されていない場合のデフォルト値です。

​

JSON出力

​

思考の連鎖

{
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "この質問に答えるために、私は次のことを行います：1. get_weather ツールを使用してサンフランシスコの現在の天気を取得します。2. get_time ツールを使用してサンフランシスコ、CAをカバーするAmerica/Los_Angelesタイムゾーンの現在時刻を取得します。"
    },
    {
      "type": "tool_use",
      "id": "toolu_01A09q90qw90lq917835lq9",
      "name": "get_weather",
      "input": {"location": "San Francisco, CA"}
    }
  ]
}

​

並列ツール使用

• tool_choice タイプが auto の場合に disable_parallel_tool_use=true を設定すると、Claude が最大1つのツールを使用することが保証されます
• tool_choice タイプが any または tool の場合に disable_parallel_tool_use=true を設定すると、Claude が正確に1つのツールを使用することが保証されます

​

並列ツール使用の最大化

​

ツール使用とツール結果コンテンツブロックの処理

​

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

• 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度"）、ネストされたコンテンツブロックのリスト（例："content": [{"type": "text", "text": "15度"}]）、またはドキュメントブロックのリスト（例："content": ["type": "document", "source": {"type": "text", "media_type": "text/plain", "data": "15度"}]）。これらのコンテンツブロックは text、image、または document タイプを使用できます。
   • is_error（オプション）：ツール実行がエラーになった場合は true に設定します。

{"role": "user", "content": [
  {"type": "text", "text": "結果は次のとおりです："},  // ❌ tool_result の前のテキスト
  {"type": "tool_result", "tool_use_id": "toolu_01", ...}
]}

{"role": "user", "content": [
  {"type": "tool_result", "tool_use_id": "toolu_01", ...},
  {"type": "text", "text": "次に何をすべきですか？"}  // ✅ tool_result の後のテキスト
]}

​

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

​

max_tokens 停止理由の処理

# ツール使用中に応答が切り捨てられたかどうかをチェック
if response.stop_reason == "max_tokens":
    # 最後のコンテンツブロックが不完全な tool_use かどうかをチェック
    last_block = response.content[-1]
    if last_block.type == "tool_use":
        # より高い max_tokens でリクエストを送信
        response = client.messages.create(
            model="claude-opus-4-1-20250805",
            max_tokens=4096,  # 制限を増加
            messages=messages,
            tools=tools
        )

​

pause_turn 停止理由の処理

import anthropic

client = anthropic.Anthropic()

# ウェブ検索での初期リクエスト
response = client.messages.create(
    model="claude-3-7-sonnet-latest",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "2025年の量子コンピューティングの画期的進歩について包括的な情報を検索してください"
        }
    ],
    tools=[{
        "type": "web_search_20250305",
        "name": "web_search",
        "max_uses": 10
    }]
)

# 応答に pause_turn 停止理由があるかどうかをチェック
if response.stop_reason == "pause_turn":
    # 一時停止されたコンテンツで会話を続行
    messages = [
        {"role": "user", "content": "2025年の量子コンピューティングの画期的進歩について包括的な情報を検索してください"},
        {"role": "assistant", "content": response.content}
    ]
    
    # 継続リクエストを送信
    continuation = client.messages.create(
        model="claude-3-7-sonnet-latest",
        max_tokens=1024,
        messages=messages,
        tools=[{
            "type": "web_search_20250305",
            "name": "web_search",
            "max_uses": 10
        }]
    )
    
    print(continuation)
else:
    print(response)

• 会話を続行する：一時停止された応答をそのまま後続のリクエストに渡して、Claude にターンを続行させます
• 必要に応じて変更する：会話を中断またはリダイレクトしたい場合は、続行前にオプションでコンテンツを変更できます
• ツール状態を保持する：機能を維持するために、継続リクエストに同じツールを含めます

​

エラーのトラブルシューティング