AIFlowTime 最新文章列表
AI 重大新聞

· AWS · AgentCore · Web Search

AgentCore 獨立搜網 API

AWS 於 11 月 11 日推出 AgentCore 的獨立 Web Search API。既有 IAM 憑證即可查 Amazon 自己的索引,不必先建 Gateway。公告費率是每 1,000 次 7 美元。區域含東京與雪梨,不含香港。

AWS 人工智慧部落格的題圖,標題是 Introducing the Web Search API on Amazon Bedrock AgentCore。
圖片來源:AWS Machine Learning Blog

AWS Machine Learning Blog 這篇由 Shubham Divekar、Kalyan Garimella、Omar Abdelwahab、Sundar Raghavan 與 Uday PB 合寫,標成 Announcements、Intermediate (200)。頁面上的日期是 11 NOV 2026。metadata 的 published_time 是 2026-11-11T15:13:16-08:00,香港時間 11 月 12 日 07:13:16。另有 modified_time 2026-11-11T16:21:09-08:00。本文沒有比對那次修改改了哪些字,以下依 11 月 15 日讀到的正文。

這篇是獨立的 Web Search API,和 新一代 AgentCore Runtime 不是同一則。本文沒有呼叫這個 API,也沒有打開主控台試查。

一次呼叫回排名摘錄

公告圖一:應用程式呼叫 InvokeWebSearch,經 IAM 與過濾,查 Amazon 營運的網頁索引後把結果送回。圖說寫查詢在 AWS 內處理。
圖片來源:AWS Machine Learning Blog

上圖是公告的 Figure 1。呼叫用 AWS SDK 或 AWS CLI,以 Signature Version 4 和你既有的 AWS 憑證簽署。不必另管一把 API key,也不必先建立資源。權限是 bedrock-agentcore:InvokeWebSearch。公告的政策範例把資源寫成 arn:aws:bedrock-agentcore:us-west-2:aws:tool/web-search.v1。us-west-2 是這個範例裡的區域,要改成你這次呼叫的區域。它不是唯一區域,也不是香港。

回傳的是 Amazon 自己營運的網頁索引裡的排名結果。每一筆都有文字摘錄。標題、URL 和發表時間只在索引裡有這些資料時才出現,範例程式用 get 讀取。本文不把那三個欄位寫成必填。

從虛擬私有雲呼叫時,可以走界面 VPC 端點。這一點下一節的私有連線圖會再看到。公告裡的 Python、CloudShell 和 EKS 片段都是官方範例,不是本文跑過的結果。

Gateway 仍是多數建議

公告對照表:MCP、多工具和集中政策走 AgentCore Gateway;自建編排、非 Agent、自己管重試與快取,以及替既有應用加搜尋,走 Web Search API。
圖片來源:AWS Machine Learning Blog

兩條路搜的是同一個索引。公告仍把 AgentCore Gateway 寫成多數 agentic 工作負載的建議路徑:一個 MCP 端點可以同時放網頁搜尋和其他工具,並處理進出驗證、語意工具選擇,以及可選的 MCP 工作階段。

API 是較低的接入點。公告點名的情況是:自己寫 agent 迴圈,或用 LangChain、LlamaIndex 這類框架時想直接把搜尋當工具;儀表板、事實查核、內容加值和監控這類不是 agent 的程式;想自己管重試、快取和錯誤;以及既有應用已經有自己的 API 層,只想加上網頁結果。

差異不要混在一起。Gateway 還可以用 JSON Web Token 授權呼叫端,API 只有 IAM。Gateway 上,管理員可以把網域清單設在 target,每次請求都套用,呼叫端不必看見那份清單。API 則是每個請求自己帶 filters。欄位名稱也不同:API 用 searchQuery、publishedAfter、publishedBefore;Gateway 的 MCP 工具用 query、from、to。

項目 Web Search API AgentCore Gateway
索引 與 Gateway 同一個 與 API 同一個
公告的建議情境 自建編排、非 agent、自己管重試與快取、既有應用加搜尋 多數 agentic 與 MCP、多工具、集中管理搜尋政策
呼叫端授權 IAM IAM,也可以用 JWT
網域清單 每次請求自己帶 filters 管理員可設在 target,呼叫端不必看見
查詢與時間欄位 searchQuery、publishedAfter、publishedBefore query、from、to

主控台例子與欄位上限

公告圖三:AgentCore 主控台的 Web Search 設定。Max results 顯示 10,範圍 1 到 25;網域包含與排除各最多 100。
圖片來源:AWS Machine Learning Blog
公告圖四:主控台測試「How do I set up Amazon S3 lifecycle rules?」,包含網域是 aws.amazon.com 與 docs.aws.amazon.com。
圖片來源:AWS Machine Learning Blog

這兩張是公告裡的主控台畫面,不是本文登入後截的。Figure 4 的測試查詢是 “How do I set up Amazon S3 lifecycle rules?”,包含網域限在 aws.amazon.com 和 docs.aws.amazon.com。畫面上的結果筆數和耗時是那個官方例子的顯示,本文不把它當成速度基準。

正文寫的上限如下。searchQuery 最長 200 個字元。maxResults 可設 1 到 25;沒有設定時,最多回 25 筆。主控台的結果數從 10 開始,範圍仍是 1 到 25。網域的 include 和 exclude 各最多 100 個;根網域會連同它的子網域。日期用 publishedAfter 和 publishedBefore,格式是 UTC 的 RFC 3339,例如 2026-01-01T00:00:00Z,兩端都包含。

預設配額是每個帳號、每個 Region、每秒 10 次請求,可以申請提高。整合版本以公告為準:Python 用 Boto3 1.43.127 或更新;LangChain 那條路徑要 langchain-aws 1.9.3 或更新;AgentCore Python SDK 1.26.0 或更新才加上這個 API。公告另外指向一個 daily dependency watch 範例,用 LangGraph 同時查三種套件生態。那是官方範例。本文不把那個範例展開成依賴監察教學,也沒有跑它。

私有連線與索引位置

公告圖二:私有子網裡的應用透過界面端點呼叫 InvokeWebSearch,圖說寫不經過網際網路閘道或 NAT 閘道。
圖片來源:AWS Machine Learning Blog

上圖是公告的 PrivateLink 示意。應用在私有子網裡,透過 AgentCore 資料平面的界面端點呼叫 API,流量走 AWS 網路。公告寫,這樣不必為了碰到這個 API 而準備網際網路閘道、NAT 閘道或代理。界面端點依標準的 AWS PrivateLink 計費。本文沒有抄 PrivateLink 的單價。

索引那一句要整句讀。公告寫:查詢在 AWS 內、對 Amazon 自己營運的網頁索引處理,不會送到第三方搜尋引擎。Figure 1 的圖說也是 “Queries are served inside AWS”。這是「索引由 Amazon 營運、查詢不轉給第三方搜尋引擎」。它不是「資料永遠不離開你的 AWS 帳號」的全面保證。本文沒有抓包。

每千次 7 美元與六區

公告的定價與供應段落:Web Search 費率是每 1,000 次查詢 7 美元;直接呼叫沒有 gateway 費用。區域列出維吉尼亞北部、俄亥俄、奧勒岡、愛爾蘭、東京與雪梨。
圖片來源:AWS Machine Learning Blog

定價段的原文是:API 計到和 Gateway connector 相同的 usage type,所以依 Web Search 費率,每 1,000 次查詢 7 美元。因為不經過 Gateway,沒有 gateway 費用。公告要讀者看 Amazon Bedrock AgentCore 定價頁。本文打開那一頁時,Web Search on AgentCore 的 Queries 列寫著每 1,000 次查詢 7.00 美元。同頁還有其他 AgentCore 項目,本文不把那些費率算進直接呼叫。

7 美元這一個數字出自公告的定價段,並與定價頁的 Web Search 列一致。本文沒有另加稅,也沒有寫之後會不會調價,沒有核對香港帳號的帳單幣別。

公告列出的區域是:US East (N. Virginia)、US East (Ohio)、US West (Oregon)、Europe (Ireland)、Asia Pacific (Tokyo)、Asia Pacific (Sydney)。名單裡有東京和雪梨。沒有 Hong Kong,也沒有 ap-east-1。不能從「Asia Pacific」這幾個字推出香港已經開放,也不能推出亞洲每一個區域都在名單裡。公告要讀者以 Supported AWS Regions 那一頁的現行名單為準。本文的區域句只採用公告正文這六個名字,沒有用那一頁增刪。

日誌不記搜尋字串

公告的企業控制清單:CloudTrail 預設不記 data events;加上 AWS::BedrockAgentCore::WebSearch 之後,事件記錄工具與 maxResults,不記錄搜尋文字或 filters。預設每秒 10 次。
圖片來源:AWS Machine Learning Blog

CloudTrail 會把 InvokeWebSearch 當成 data events。Data events 預設不記。要在 trail 或 event data store 加上資源類型 AWS::BedrockAgentCore::WebSearch 的選擇器。公告寫,事件記錄的是網頁搜尋工具和 maxResults,不記錄搜尋文字,也不記錄 filters。本文沒有建立這條 trail。

同一段還寫,可以用 IAM 政策對使用者、群組或角色允許或拒絕 bedrock-agentcore:InvokeWebSearch,也可以用服務控制政策做跨帳號的界線。這些都是公告列出的控制項。本文沒有在帳號裡試過允許或拒絕。

想成為 AI 高手?即刻搵 Jacob
看更多最新文章