View a markdown version of this page

Web 搜尋工具 - Amazon Bedrock AgentCore
關鍵功能專門建置的 Web 索引依設計私有運作方式使用案例設定 Web 搜尋工具搭配繫帶使用設定網域篩選設定閘道服務角色輸入結構描述回應格式可用性可接受的使用方式

Web 搜尋工具

AI 代理器正在改變組織與資訊互動的方式，但他們面臨基本限制：他們的知識在訓練時間被凍結。當使用者詢問今天的股票價格或一小時前運送的軟體版本時，僅依賴其訓練資料的代理程式無法提供準確的答案。

建置自訂 Web 搜尋整合來解決這個問題非常昂貴：購買第三方搜尋 APIs、管理金鑰和配額和速率限制、剖析跨供應商的不一致結果格式、建置程式碼片段擷取邏輯，讓模型取得相關段落，而不是原始 HTML、推理客戶查詢可能前往何處以及如何保留資料，以及隨著時間維持新鮮度和涵蓋範圍。這些都是一個專案本身。

Amazon Bedrock AgentCore 上的 Web 搜尋工具可消除這種複雜性。它是一種全受管、MCP 相容的 Web 搜尋功能，可讓您的代理程式從 Web 擷取資訊，而不需要任何基礎設施額外負荷。它可作為您連接到 AgentCore Gateway 的受管連接器使用。客服人員使用標準tools/list呼叫來探索它，並像任何其他模型內容通訊協定工具一樣叫用它。沒有要佈建APIs、沒有要管理的傳出憑證，也沒有要維護的結果剖析黏附。

下列各節會逐步解說主要功能、專用 Web 索引的架構、隱私權保證、使用案例，以及如何設定 Web 搜尋工具。

關鍵功能

  • Up-to-date資訊存取 — 在up-to-date中擷取具有標題、URLs、程式碼片段和發佈日期的目前 Web 結果至 Ground Agent 回應。

  • 零基礎設施管理 — 無需佈建或擴展設定的第三方搜尋 APIs。Gateway 會自動將 Web 搜尋公開為標準 MCP 工具。

  • 與架構無關 - 透過標準模型內容通訊協定，與 Strands Agents、LangChain、LangGraph、CrewAI 或任何 MCP 相容用戶端搭配使用。

  • 專門建置的 Web 索引 — 由橫跨數十億份文件的 Amazon 操作 Web 索引提供支援。

  • 高可信度事實的知識圖表 — 將實體及其關係接地以提供事實答案，而不是讓模型從擷取的頁面文字推斷它們。

  • 語意程式碼片段擷取 — 從每個網頁提取語意相關段落，針對模型的內容視窗進行最佳化，而不是傳回原始 HTML 或完整頁面。

專門建置的 Web 索引

許多將 Web 搜尋新增至代理程式的解決方案都是透過第三方搜尋引擎的包裝函式。Amazon Bedrock AgentCore 上的 Web 搜尋工具不同，它由 Amazon 直接建置和操作的 Web 索引提供支援。

廣泛的涵蓋範圍

索引橫跨數十億份文件。這種規模對於涵蓋範圍至關重要：當索引很廣泛，而不是限於最熱門的頁面時，可以更有效地回答有關利基程式庫或模糊產品規格的長期問題。

持續更新

Amazon 會持續重新整理索引，在幾分鐘內反映新的和變更的內容。對於回答有關價格變動或剛發佈公告問題的客服人員，該延遲時段是基礎答案與可信錯誤答案之間的差異。當您的客服人員搜尋「今天發生的事」時，結果會反映今天實際發生的情況。

高可信度事實的知識圖表

Web 搜尋工具包含內建的知識圖表，以實體及其關係為基礎。對於事實問題 - 例如誰擔任角色或何時建立某物 - 知識圖表提供高可信度的答案，而不是離開模型從擷取的頁面文字推斷它們。這可減少代理程式單獨將程式碼片段的答案拼接在一起時可能發生的細微事實偏離。

針對模型內容最佳化的語意程式碼片段擷取

工具不會將原始 HTML 傾印或完整頁面交給模型，而是執行語意相關的程式碼片段擷取。它會從查詢上實際承載的每個網頁提取段落，並以針對模型內容視窗最佳化的形式傳回它們。結果是每個字符更密集、更相關的內容 — 模型會看到重要的部分，並在樣板和導覽 chrome 上花費較少的字符，這有助於提高引用答案的精確度。

依設計私有

對於許多企業而言，停滯 Web 搜尋推展的問題不是「有效」，而是「我的使用者查詢要去哪裡，以及會發生什麼情況？」 Web 搜尋工具是建置的，因此這些答案非常簡單。

查詢永遠不會離開 AWS

當您的客服人員發出搜尋時，查詢會完全在 AWS 基礎設施內提供。客戶查詢不會傳送至第三方搜尋引擎或在外部路由 AWS。Gateway 會向 AWS擁有的連接器進行身分驗證，並在內部路由請求，因此資料路徑會保留在 AWS 端對端。對於有資料輸出問題的團隊，這會移除整個審查類別。

運作方式

Web 搜尋工具是內建連接器。Gateway 會處理結構描述管理、參數控管、端點解析和服務身分驗證。

  1. 閘道設定 — 建立閘道並使用 新增 Web 搜尋工具目標connectorId: "web-search"。Gateway 會快照工具結構描述並佈建整合。

  2. 工具探索 — 您的客服人員在閘道端點tools/list上呼叫 ，並探索具有其輸入結構描述WebSearch的工具。

  3. 搜尋調用 — 您的客服人員tools/call使用自然語言查詢呼叫 （最多 200 個字元）。Gateway 會向後端進行身分驗證，並在內部路由請求 AWS。

  4. 結構化結果 — 工具會以文字和結構化 JSON 格式傳回具有語意相關文字片段、URLs、標題和發佈日期的結果。

  5. 基礎回應 — 您的代理程式會使用結果來編寫具有引用來源的回應。

使用案例

  • Up-to-date研究 — 透過搜尋 Web 並使用來源引文合成結果，回答有關目前事件、股票價格或最近公告的問題。

  • 事實檢查 — 透過搜尋主要來源，以及使用知識圖表支援的事實答案確認或更正數字，來驗證文件中的宣告。

  • 競爭情報 — 監控來自公有 Web 來源的競爭對手公告、產品推出或定價變更。

  • 消除過時的知識 - 讓客服人員存取訓練截止後發佈的資訊，例如新軟體版本、政策變更或中斷開發。

設定 Web 搜尋工具

如需如何使用 Web 搜尋工具連接器組態建立閘道目標的指示，包括使用 Python SDK 和 CLI 的設定範例，請參閱目標組態指南中的設定 Web 搜尋工具。

搭配繫帶使用

若要提供 AgentCore 繫帶 Web 搜尋功能，請將您在設定 Web 搜尋工具中建立的閘道連接至繫帶做為agentcore_gateway工具。繫帶執行角色需要閘道 ARN 的 bedrock-agentcore:InvokeGateway許可。如需end-to-end演練，請參閱繫帶文件中的工具。

設定網域篩選

您可以透過設定網域拒絕清單來限制允許 Web 搜尋工具查詢的網域。如需組態範例和詳細資訊，請參閱 目標組態指南中的設定網域篩選。

設定閘道服務角色

Gateway 需要一個服務角色，允許 AgentCore 服務代表您執行動作。如需必要的 IAM 許可和政策組態，請參閱目標組態指南中的設定閘道服務角色。

輸入結構描述

透過 叫用時，Web 搜尋工具接受下列輸入結構描述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"]
  }
}
欄位 類型 必要 描述

query

string

是

搜尋的查詢字串。必須為 200 個字元或更少。

maxResults

integer

否

回傳結果的數量上限。有效範圍：1-25。預設為 10。

回應格式

Web 搜尋工具會以下列 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\"}]}"
    }
  ]
}
欄位 類型 必要 描述

text

string

是

搜尋結果的文字內容或程式碼片段

url

string

否

來源網頁的 URL

title

string

否

來源網頁的標題

publishedDate

string

否

結果的發佈日期

可用性

Web 搜尋工具連接器在美國東部 （維吉尼亞北部） us-east-1區域提供。

由於 Amazon 會操作完整的搜尋堆疊，因此透過相同的受管連接器自動改善至客服人員的新鮮度、涵蓋範圍、相關性和程式碼片段品質流程。您不需要進行版本升級或遷移。

可接受的使用方式

如果您使用 Web 搜尋工具，您必須負責使用 Web 搜尋工具擷取的內容 (「搜尋結果」)，以及最終使用者的任何使用。您必須保留並顯示每個搜尋結果隨附的來源引文和連結，在您向使用搜尋結果的最終使用者呈現的任何輸出中。您無法使用 Web 搜尋工具 (a) 從搜尋結果大量擷取、儲存或重現內容，或 (b) 建置或填入競爭索引或資料庫。