ツール使用の仕組み

サーバー実行ツール

web_search、web_fetch、code_execution、tool_searchについては、Anthropicがコードを実行します。リクエストでツールを有効にすれば、サーバーが残りすべてを処理します。サーバーサイドループが操作を実行し、レスポンスがあなたに届く前にモデルに出力を返すため、これらのツールに対してtool_resultブロックを構築することはありません。

受け取るレスポンスには、何が実行され何が返ってきたかを示すserver_tool_useブロックが含まれますが、それらを見る時点では実行はすでに完了しています。あなたのアプリケーションの役割は、ツールを有効にして最終的な回答を読むことであり、実行ループに参加することではありません。

エージェントループ（クライアントツール）

クライアント実行ツール（ユーザー定義とAnthropicスキーマの両方）は、アプリケーションがループを駆動することを必要とします。モデルはあなたのコードを実行できないため、すべてのツール呼び出しはラウンドトリップです：モデルが要求し、あなたが実行し、あなたが報告し、モデルが続行します。

標準的な形はstop_reasonをキーとするwhileループです：

1. tools配列とユーザーメッセージを含むリクエストを送信する。
2. Claudeはstop_reason: "tool_use"と1つ以上のtool_useブロックで応答する。
3. 各ツールを実行する。出力をtool_resultブロックとしてフォーマットする。
4. 元のメッセージ、アシスタントのレスポンス、およびtool_resultブロックを含むユーザーメッセージを含む新しいリクエストを送信する。
5. stop_reasonが"tool_use"である間、ステップ2から繰り返す。

実際には次のように読めます：stop_reason == "tool_use"の間、ツールを実行して会話を続ける。ループは他の停止理由（"end_turn"、"max_tokens"、"stop_sequence"、または"refusal"）で終了します。これはClaudeが最終的な回答を生成したか、アプリケーションが処理すべき別の理由で停止したことを意味します。

リクエストの構築、並列ツール呼び出しの処理、結果のフォーマットの仕組みについては、ツール呼び出しの処理を参照してください。

サーバーサイドループ

サーバー実行ツールは、Anthropicのインフラストラクチャ内で独自のループを実行します。あなたのアプリケーションからの単一のリクエストが、レスポンスが返ってくる前に複数のウェブ検索やコード実行をトリガーする場合があります。モデルは検索し、結果を読み、再度検索することを決定し、必要なものが得られるまで反復します。これはすべてあなたのアプリケーションが参加することなく行われます。

この内部ループには反復制限があります。モデルが上限に達してもまだ反復している場合、レスポンスは"end_turn"の代わりにstop_reason: "pause_turn"で返ってきます。一時停止されたターンは作業が完了していないことを意味します。モデルが中断したところから続けられるよう、会話（一時停止されたレスポンスを含む）を再送信してください。継続パターンについてはサーバーツールを参照してください。

ツールを使用するタイミング（および使用しないタイミング）

ツール使用は、タスクがテキストだけではモデルができないことを必要とする場合に適しています：

• 副作用を伴うアクション。 メールの送信、ファイルの書き込み、レコードの更新。モデルはこれらのアクションを説明できますが、実行できるのはツールだけです。
• 新鮮または外部データ。 現在の価格、今日の天気、データベースの内容。トレーニングデータの外にあるものやシステム固有のものは、取得するためにツールが必要です。
• 構造化された保証された形状の出力。 情報を含む散文ではなく、特定のフィールドを持つJSONオブジェクトが必要な場合、ツールスキーマが形状を強制します。
• 既存システムへの呼び出し。 データベース、内部API、ファイルシステム。ツール使用は自然言語リクエストとそれを実現するシステムの橋渡しです。

ツールを使用すべきサインは：モデル出力から決定を抽出するために正規表現を書いているなら、その決定はツール呼び出しであるべきでした。構造化された意図を回復するために自由形式のテキストを解析することは、その構造がスキーマに属するサインです。

ツール使用が適さない場合：

• モデルがトレーニングだけで回答できる場合。要約、翻訳、一般知識の質問にはツールのラウンドトリップは不要です。
• 副作用のない一回限りのQ&Aの場合。実行するものが何もなければ、ツールがすることも何もありません。
• ツール呼び出しのレイテンシが些細なレスポンスを支配する場合。すべてのツール呼び出しは少なくとも1つの追加ラウンドトリップです。軽量なタスクではオーバーヘッドが作業を超える可能性があります。

アプローチの選択

次のステップ