翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ウェブ検索ツール

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

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

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

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

主な機能

専用ウェブインデックス

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

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

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

仕組み

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

ユースケース

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

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

ハーネスで を使用する

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

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

ウェブ検索ツールは、すべてのリクエストで構成される 2 つのフィルタリングレイヤーをサポートしています。

リクエストレベルのフィルターは、ターゲットレベルの除外リストとインクルードリストで構成されます。

リクエストレベルのフィルターは、ターゲットレベルの除外リストを上書きしたり、ターゲットレベルの包含リストを超えて結果を展開したりすることはできません。

設定例と詳細については、ターゲット設定ガイドの「ドメインフィルタリングの設定」を参照してください。

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

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

入力スキーマ

ウェブ検索ツールは、 を介して呼び出されたときに次の入力スキーマを受け入れますtools/call。filters フィールドは、ターゲットがコネクタバージョン 1.2.0以降に固定されている場合にのみ使用できます。以前のバージョンでは、スキーマは queryと のみを公開しますmaxResults。

{
  "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"
      },
      "filters": {
        "description": "Optional request-level filters (connector version 1.2.0+). Applied on top of the target-level exclude list and include list.",
        "type": "object",
        "properties": {
          "domainFilter": {
            "description": "Per-call domain filter. Include and exclude lists each hold up to 100 domains. Root domain matches subdomains.",
            "type": "object",
            "properties": {
              "include": {
                "description": "Restrict results to these domains.",
                "type": "array",
                "items": {"type": "string"}
              },
              "exclude": {
                "description": "Drop results from these domains.",
                "type": "array",
                "items": {"type": "string"}
              }
            }
          },
          "publishedDateFilter": {
            "description": "Per-call published-date filter. Bounds inclusive, ISO-8601 UTC. Applies to web results only.",
            "type": "object",
            "properties": {
              "from": {
                "description": "Earliest publication date (ISO-8601 UTC).",
                "type": "string"
              },
              "to": {
                "description": "Latest publication date (ISO-8601 UTC).",
                "type": "string"
              }
            }
          }
        }
      }
    },
    "required": ["query"]
  }
}

レスポンスの形式

ウェブ検索ツールは、次の 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\"}]}"
    }
  ]
}

可用性

ウェブ検索ツールコネクタは、次の AWS リージョンで使用できます。

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

許容される使用法

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