主な機能専用ウェブインデックスプライベートバイデザイン仕組みユースケースウェブ検索ツールのセットアップハーネスでを使用するドメインフィルタリングを設定する Gateway サービスロールを設定する入力スキーマレスポンスの形式可用性許容される使用法

ウェブ検索ツール

AI エージェントは、組織が情報とやり取りする方法を変革していますが、トレーニング時に知識が凍結されるという根本的な制限に直面しています。ユーザーが 1 時間前に出荷された今日の株価またはソフトウェアリリースについて質問した場合、トレーニングデータのみに依存するエージェントは正確な回答を提供できません。

これを解決するためのカスタムウェブ検索統合の構築にはコストがかかります。つまり、サードパーティーの検索 APIs の調達、キーとクォータとレート制限の管理、プロバイダー間での一貫性のない結果形式の解析、モデルが raw HTML の代わりに関連するパッセージを取得するためのスニペット抽出ロジックの構築、顧客のクエリの移動場所とデータの保持方法に関する推論、時間の経過に伴う鮮度とカバレッジの維持です。これらはそれぞれそれ自体がプロジェクトです。

Amazon Bedrock AgentCore のウェブ検索ツールは、その複雑さを排除します。これは、フルマネージドの MCP 準拠のウェブ検索機能であり、エージェントがインフラストラクチャのオーバーヘッドなしでウェブから情報を取得できます。エージェントAgentCoreゲートウェイに接続するマネージドコネクタとして使用できます。エージェントはこれを標準tools/list呼び出しで検出し、他のモデルコンテキストプロトコルツールと同様に呼び出します。プロビジョニングAPIs、管理するアウトバウンド認証情報、維持する結果解析グルーはありません。

以下のセクションでは、主要な機能、専用ウェブインデックスのアーキテクチャ、プライバシー保証、ユースケース、ウェブ検索ツールの設定方法について説明します。

主な機能

Up-to-dateへのアクセス — タイトル、URLs、スニペット、公開日を含む現在のウェブ結果を最新の情報でup-to-date。
ゼロインフラストラクチャ管理 — プロビジョニングまたはスケーリングを設定するためのサードパーティー検索 APIs はありません。Gateway は、ウェブ検索を標準 MCP ツールとして自動的に公開します。
フレームワークに依存しない — 標準のモデルコンテキストプロトコルを通じて、Strands Agents、LangChain、LangGraph、CrewAI、または MCP 互換クライアントで動作します。
専用ウェブインデックス — 何十億ものドキュメントにまたがる Amazon が運営するウェブインデックスに支えられています。
高信頼性ファクトのナレッジグラフ — エンティティとその関係に基づいて、抽出されたページテキストからモデルを推測するのではなく、事実に基づく回答を提供します。
セマンティックスニペット抽出 — 未加工の HTML や全ページを返すのではなく、モデルのコンテキストウィンドウ用に最適化された、意味的に関連のある各ウェブページからパッセージをプルします。

専用ウェブインデックス

エージェントにウェブ検索を追加する多くのソリューションは、サードパーティーの検索エンジンのラッパーです。Amazon Bedrock AgentCore のウェブ検索ツールは異なります。Amazon が直接構築および運用するウェブインデックスによってバックアップされています。

幅広いカバレッジ: インデックスは数千億のドキュメントに及びます。このスケールはカバレッジにとって重要です。ニッチライブラリやあいまいな製品仕様に関する長期的な質問は、インデックスが最も一般的なページに限定されるのではなく、幅広い場合に、より効果的に回答できます。
継続的に更新される: Amazon はインデックスを継続的に更新し、新規および変更されたコンテンツを数分で反映します。価格変動、または単に公開された発表に関する質問に回答するエージェントの場合、そのレイテンシーウィンドウは、根拠のある回答と自信を持って間違った回答の違いです。エージェントが「今日何が起こったか」を検索すると、結果は今日実際に何が起こったかを反映します。
高信頼性ファクトのナレッジグラフ: ウェブ検索ツールには、エンティティとその関係を根拠とするナレッジグラフが組み込まれています。ロールの所有者や何かがいつ設立されたかなどの事実に関する質問の場合、ナレッジグラフは、モデルを離れて抽出されたページテキストから推測するのではなく、信頼性の高い回答を提供します。これにより、エージェントがスニペットからの回答だけを結合したときに発生する可能性がある微妙な事実ドリフトの種類が軽減されます。
モデルコンテキスト用に最適化されたセマンティックスニペット抽出: このツールは、モデルに未加工の HTML ダンプや全ページを提供するのではなく、意味的に関連するスニペット抽出を実行します。クエリに実際に記述されている各ウェブページからパッセージをプルし、モデルのコンテキストウィンドウに最適化された形式で返します。その結果、トークンごとにより密でより関連性の高いコンテキストが得られます。モデルは重要な部分を確認し、ボイラープレートとナビゲーションクロームに費やすトークンが少なくなるため、引用された回答の精度が向上します。

プライベートバイデザイン

多くの企業にとって、ウェブ検索のロールアウトを失速させる質問は「機能する」ではなく、「ユーザーのクエリはどこへ行き、どうなるか」です。ウェブ検索ツールは、これらの回答がわかりやすいように構築されています。

クエリが離れることはない AWS: エージェントが検索を発行すると、クエリは AWS インフラストラクチャ内で完全に処理されます。お客様のクエリは、サードパーティーの検索エンジンに送信されず、外部にルーティングされません AWS。Gateway は AWS所有コネクタに認証し、リクエストを内部的にルーティングするため、データパスは AWS エンドツーエンドの内部にとどまります。データ出力が懸念されるチームの場合、レビューのカテゴリ全体が削除されます。

仕組み

ウェブ検索ツールは組み込みコネクタです。Gateway は、スキーマ管理、パラメータガバナンス、エンドポイント解決、サービス認証を処理します。

ゲートウェイのセットアップ — を使用してゲートウェイを作成し、ウェブ検索ツールターゲットを追加しますconnectorId: "web-search"。Gateway はツールスキーマをスナップショットし、統合をプロビジョニングします。
ツール検出 — エージェントは Gateway エンドポイントtools/listでを呼び出し、入力スキーマを使用してWebSearchツールを検出します。
検索呼び出し — エージェントは自然言語クエリ (最大 200 文字) tools/callを使用してを呼び出します。Gateway はバックエンドに認証し、内部でリクエストをルーティングします AWS。
構造化された結果 — このツールは、意味的に関連するテキストスニペット、URLs、タイトル、および発行日を含む結果をテキスト形式と構造化された JSON 形式で返します。
Grounded Response — エージェントは結果を使用して、引用されたソースでレスポンスを作成します。

ユースケース

Up-to-date調査 — ウェブを検索し、結果をソース引用と合成することで、現在のイベント、株価、最近の発表に関する質問に回答します。
ファクトチェック — プライマリソースを検索し、ナレッジグラフベースの事実回答を使用して数値を確認または修正することで、ドキュメント内のクレームを検証します。
競合情報 — 競合相手の発表、製品の発売、またはパブリックウェブソースからの料金変更を監視します。
古い知識の排除 — エージェントに、新しいソフトウェアリリース、ポリシーの変更、重大な開発など、トレーニングの期限後に公開された情報へのアクセスを許可します。

ウェブ検索ツールのセットアップ

Python SDK と CLI を使用したセットアップ例など、ウェブ検索ツールコネクタ設定を使用してゲートウェイターゲットを作成する方法については、ターゲット設定ガイドの「ウェブ検索ツールのセットアップ」を参照してください。

ハーネスでを使用する

AgentCore ハーネスウェブ検索機能を使用するには、Set up Web Search Tool で作成したゲートウェイをagentcore_gatewayツールとしてハーネスにアタッチします。ハーネス実行ロールには、ゲートウェイ ARN に対するアクセスbedrock-agentcore:InvokeGateway許可が必要です。end-to-endのチュートリアルについては、ハーネスドキュメントの「ツール」を参照してください。

ドメインフィルタリングを設定する

ドメイン拒否リストを設定することで、ウェブ検索ツールがクエリできるドメインを制限できます。設定例と詳細については、ターゲット設定ガイドの「ドメインフィルタリングの設定」を参照してください。

Gateway サービスロールを設定する

Gateway には、AgentCore サービスがユーザーに代わってアクションを実行できるようにするサービスロールが必要です。必要な IAM アクセス許可とポリシー設定については、ターゲット設定ガイドの「ゲートウェイサービスロールの設定」を参照してください。

入力スキーマ

ウェブ検索ツールは、を介して呼び出されたときに次の入力スキーマを受け入れますtools/call。


{
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "description": "The search query string",
        "type": "string"
      },
      "maxResults": {
        "description": "Maximum number of results to return. Valid range: 1-25. Defaults to 10.",
        "type": "integer"
      }
    },
    "required": ["query"]
  }
}

フィールド	Type	必須	説明
`query`	文字列	はい	検索クエリ文字列｡ 200 文字以下である必要があります。
`maxResults`	整数	いいえ	返される結果の最大数。有効範囲: 1～25。デフォルトは 10 です。

レスポンスの形式

ウェブ検索ツールは、次の MCP 準拠の形式で結果を返します。


{
  "isError": false,
  "content": [
    {
      "type": "text",
      "text": "{\"id\":\"824f89d0\",\"results\":[{\"text\":\"Python 3.13 was released on October 7, 2024, featuring improvements to the interactive interpreter, experimental free-threaded mode, and a preliminary JIT compiler...\",\"publishedDate\":\"2024-10-07\",\"url\":\"https://example.com/python/releases/3.13\",\"title\":\"Python 3.13 Release Highlights\"}]}"
    }
  ]
}

フィールド	Type	必須	説明
`text`	文字列	はい	検索結果のテキストコンテンツまたはスニペット
`url`	string	いいえ	ソースウェブページの URL
`title`	string	いいえ	ソースウェブページのタイトル
`publishedDate`	string	いいえ	結果の発行日

可用性

ウェブ検索ツールコネクタは、米国東部 (バージニア北部) us-east-1リージョンで使用できます。

Amazon はフル検索スタックを運用しているため、同じマネージドコネクタを介してエージェントへの鮮度、カバレッジ、関連性、スニペット品質フローが自動的に改善されます。バージョンのアップグレードや移行は必要ありません。

許容される使用法

ウェブ検索ツールを使用する場合、ウェブ検索ツールから取得したコンテンツ (「検索結果」) の使用およびエンドユーザーによる使用は、お客様の責任となります。各検索結果に提供されているソース引用とリンクは、検索結果を使用するエンドユーザーに表示される出力に保持して表示する必要があります。ウェブ検索ツールを使用して、(a) 検索結果からコンテンツを一括で抽出、保存、または再現したり、(b) 競合するインデックスまたはデータベースを構築または入力したりすることはできません。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

マネージドナレッジベース

ゲートウェイツールの命名を理解する