読み込み中

ウェブ検索ツール

レッスン 317 分

重要な注意: 使用する前に、組織が設定コンソールでWeb Searchツールを有効にしている必要があります。この設定は次の場所にあります: https://platform.claude.com/settings/capabilities

読み込み中

Claudeには、ユーザーの質問に答えるために最新または専門的な情報をインターネットで検索できる組み込みのウェブ検索ツールが含まれています。実装を提供する必要がある他のツールとは異なり、Claudeは検索プロセス全体を自動的に処理します。つまり、有効にするための単純なスキーマを提供するだけで済みます。

私たちのサーバーが量子コンピューティングの最新の発展について尋ねると、Claudeがウェブを検索し、3つの結果から回答します。

ウェブ検索ツールの設定

ウェブ検索ツールを使用するには、次の必須フィールドを持つスキーマオブジェクトを作成します。

python
web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search", 
    "max_uses": 5
}

max_uses フィールドは、Claudeが実行できる検索回数を制限します。Claudeは初期結果に基づいてフォローアップ検索を行う場合があるため、これにより過剰なAPI呼び出しを防ぎます。1回の検索で複数の結果が返されますが、Claudeは追加の検索が必要だと判断することがあります。

レスポンスの仕組み

Claudeがウェブ検索ツールを使用すると、レスポンスにはいくつかの種類のブロックが含まれます。

  • テキストブロック - Claudeが何をしているかの説明
  • ServerToolUseBlock - Claudeが使用した正確な検索クエリを示す
  • WebSearchToolResultBlock - 検索結果を含む
  • WebSearchResultBlock - タイトルとURLを持つ個々の検索結果
  • 引用ブロック - Claudeの発言を裏付けるテキスト

Claudeのクエリ「best exercises building leg muscle strength scientific research」とnih.govの結果を含むレスポンスブロック。

レスポンス構造により、Claudeが実際に何を検索し、どのソースを見つけたかを正確に確認できます。引用には、Claudeが回答を裏付けるために使用した具体的なテキストと、ソースURLが含まれます。

検索ドメインの制限

allowed_domains フィールドを使用して、検索を特定のドメインに限定できます。これは、信頼できる権威あるソースが必要な場合に特に便利です。

python
web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search",
    "max_uses": 5,
    "allowed_domains": ["nih.gov"]
}

たとえば、医療や運動に関するアドバイスを尋ねる場合、PubMed (nih.gov) などのドメインに制限することで、ランダムなブログコンテンツではなく、エビデンスに基づいた情報を得ることができます。

検索ボックスと、生物医学文献の3,800万件を超える引用を収録しているという注記があるPubMedのホームページ。

検索結果のレンダリング

レスポンス内の異なるブロックタイプは、特定のUIレンダリング向けに設計されています。

  • テキストブロックは通常のコンテンツとしてレンダリングする
  • ウェブ検索結果は上部にソースのリストとして表示する
  • 引用は、ソースのドメイン、ページタイトル、URL、引用テキストを含めて、テキストにインラインで表示する

上部に6枚のnih.govソースカードがあり、その後にncbi.nlm.nih.govのインライン引用で終わるIntroductionの段落。

この構造は、ユーザーがClaudeがどのようにして答えにたどり着いたかを理解するのに役立ち、使用されているソースについての透明性を提供します。引用形式により、どの具体的な情報がどのソースから得られたかが明確になり、AIの回答への信頼を築きます。

実用的な使い方

ウェブ検索ツールは、次の用途に最適です。

  • 最新の出来事や最近の動向
  • Claudeの訓練データに含まれていない専門情報
  • ファクトチェックや権威あるソースの発見
  • 最新情報を必要とするリサーチ タスク

API呼び出しを行う際に、tools配列にこのスキーマを含めるだけで、Claudeはウェブ検索がユーザーの質問に答えるのに役立つかどうかを自動的に判断します。