亚马逊 Bedrock AgentCore 推出单次调用即可完成查询的网络搜索 API

关键要点

  • Amazon Bedrock AgentCore 推出了 Web Search API,可通过 InvokeWebSearch 操作一次调用完成网页搜索,无需设置网关。
  • Web Search API 的收费标准为每 1,000 次查询 7 美元,并支持域名筛选、日期范围筛选,每次请求最多返回 25 条结果。
  • Amazon Bedrock AgentCore Web Search API 可与 LangChain 1.9.3 及更高版本以及 AgentCore Python SDK 1.26.0 集成,并覆盖六个 AWS 区域。

Amazon Bedrock AgentCore 现已提供 Web Search API,开发者只需调用一次 API 即可搜索网页。此前,AgentCore 上的网页搜索通过 AgentCore Gateway 提供,需要创建网关和网页搜索目标;如果开发者自己的代码只需要搜索结果,这种设置就超出了实际需求。Web Search API 会从 Amazon 运营的网页索引中返回按相关性排序的结果,每条结果都包含文本摘录,并在有相关信息时包含页面标题、URL 和发布时间。开发者可通过 AWS SDK 或 AWS Command Line Interface (AWS CLI) 调用该 API,并使用标准 AWS Identity and Access Management (IAM) 凭证签名,无需预先创建资源。

Web Search API 通过 InvokeWebSearch 运行

Web Search API 是 bedrock-agentcore 数据平面上的 InvokeWebSearch 操作,与 AgentCore Browser 等其他 AgentCore 工具使用同一端点。请求使用标准 AWS 凭证通过 AWS Signature Version 4 (SigV4) 签名,因此无需管理 API 密钥或密钥。收到请求后,API 会通过 IAM 检查调用方是否拥有针对 AWS 托管网页搜索工具的 bedrock-agentcore:InvokeWebSearch 权限,应用请求中的域名包含或排除筛选条件以及发布时间范围筛选条件,然后搜索由 Amazon 运营的网页索引。博客称,查询在 AWS 内部处理,不会发送到第三方搜索引擎。API 最多返回 maxResults 条排序结果。来自虚拟私有云 (VPC) 的调用可通过接口 VPC 端点进行。

调用身份需要对 AWS 托管资源 arn:aws:bedrock-agentcore:us-west-2:aws:tool/web-search.v1 拥有一项 IAM 权限。这与网关服务角色用于网页搜索的操作和资源相同,因此一条策略即可覆盖两种调用方式。

独立 API 适用于自定义编排和非智能体工作负载

对于大多数智能体工作负载,AgentCore Gateway 仍是推荐方案,因为它提供一个安全的模型上下文协议 (MCP) 端点,可整合网页搜索和其他工具,并支持入站和出站身份验证、语义工具选择以及可选的 MCP 会话。不过,开发者希望有一个更底层的集成接口。自行构建智能体循环或使用 LangChain、LlamaIndex 等框架的开发者,可以在编排逻辑中将网页搜索作为工具直接调用。由搜索驱动的仪表板、事实核查流水线、内容增强工作流和监控系统,无需智能体基础设施即可使用实时网页结果。希望自行管理重试、缓存和错误处理,或已有 API 层的开发者,也可以直接调用该 API。

博客称,Web Search API 是网关的补充,运行在与 Alexa+、Kiro、Quick 和其他 Amazon 产品相同的搜索基础设施上,具有相同的质量和合规标准,并以直接 API 操作的形式提供。两种方式搜索的是同一索引,但网关可以使用 JSON Web Token (JWT) 对调用方进行授权,而 API 仅使用 IAM 授权。在网关中,管理员可以在目标上设置域名列表,并将其应用于每个请求,而调用智能体不会看到这些列表;使用 API 时,每个请求都需携带自己的筛选条件。网关的 MCP 工具使用 query、from 和 to 字段,而 API 使用 searchQuery、publishedAfter 和 publishedBefore。

Python 示例和框架集成助力快速开始搜索

博客的第一个示例使用适用于 Python 的 AWS SDK (Boto3),在美国西部(俄勒冈)区域 (us-west-2) 调用 invoke_web_search,指定 webSearchId 为 web-search.v1,搜索查询为多区域 EKS 集群部署最佳实践,将 maxResults 设为 10,包含 aws.amazon.com 和 kubernetes.io 的域名筛选条件,以及值为 2026-01-01T00:00:00Z 的 publishedAfter。每条结果都包含文本摘录;由于标题、URL 和发布日期仅在索引中有相关信息时才会返回,因此示例通过 get 读取这些字段。一个实时示例结果展示了标题、URL、文本摘录以及值为 2026-09-25T15:52:00Z 的 publishedAt。博客称,在 AWS Lambda、Amazon Elastic Container Service (Amazon ECS)、Amazon Elastic Compute Cloud (Amazon EC2) 或 Amazon Elastic Kubernetes Service (Amazon EKS) 上运行的代码会从其执行角色获取凭证,因此只要为该角色添加相应权限,同一代码即可原样运行。

LangChain 智能体可通过 langchain-aws 1.9.3 及更高版本中的 create_web_search_toolkit 使用 AgentCore 网页搜索工具。博客还展示了一个封装 boto3 调用的普通 LangChain 工具。不使用框架时,AgentCore Python SDK 中的 WebSearchClient 会封装相同调用,并返回经过解析的日期。博客说明,langchain-aws 1.9.3 和 AgentCore Python SDK 1.26.0 增加了对 Web Search API 的支持,应安装这些版本或更高版本。博客还介绍了一个使用 LangGraph 构建的每日依赖项监控示例:并行研究三个软件包生态系统,并在报告前用来源核查每项发现。

PrivateLink 和 CloudTrail 提供网络与审计控制

处理敏感数据的智能体和流水线可通过 AWS PrivateLink 接口 VPC 端点调用 Web Search API,使 VPC 与 API 之间的流量留在 AWS 网络中,无需互联网网关、NAT 网关或代理。要进行设置,需要在调用 API 的每个 VPC 和区域中创建 com.amazonaws..bedrock-agentcore 接口端点,并启用私有 DNS。端点的安全组必须允许来自调用资源的入站 HTTPS 流量通过端口 443。启用私有 DNS 后,标准区域名称 bedrock-agentcore.us-west-2.amazonaws.com 会解析为 VPC 内的私有 IP 地址,因此 Boto3 和 AWS CLI 示例无需指定端点 URL 即可运行。除 IAM 策略外,VPC 端点策略也适用于 InvokeWebSearch 请求;同一端点还承载其他 AgentCore 数据平面 API,因此,如果 VPC 中的工作负载会使用这些 API,也必须为相应调用添加策略语句。还可以在 IAM 策略中添加 aws:SourceVpce 条件,使该角色只能通过指定端点进行搜索。博客称,PrivateLink 在所有提供 Web Search API 的区域中都以相同方式运行,接口端点按 AWS PrivateLink 标准价格计费。

在审计方面,AWS CloudTrail 会将 InvokeWebSearch 请求记录为数据事件。数据事件默认不会记录,因此必须将 AWS::BedrockAgentCore::WebSearch 资源类型的事件选择器添加到跟踪或事件数据存储中。事件会记录网页搜索工具和 maxResults,但不会记录搜索文本或筛选条件。博客还指出,Web Search Tool 条款适用于 API 结果,其中包括保留并显示每条结果所附来源引用和链接的要求。

控制台测试支持在编写代码前进行配置

开发者可以在 Amazon Bedrock AgentCore 控制台中,通过导航窗格的 Connections 下选择 Web Search,测试 Web Search API。Configure 面板可将结果数量设为 1 到 25,控制台默认值为 10;还可设置 YYYY/MM/DD 格式的发布日期范围,以及最多 100 个包含域名和最多 100 个排除域名。Test Web Search API 面板接受最多 200 个字符的查询,并显示结果数量、调用时长,以及每条结果的标题、文本摘要、发布日期和来源 URL。确认结果符合预期后,控制台可以根据相同设置生成代码片段,也可以创建一个将 Web Search 添加为 AgentCore Gateway 工具的网关目标。控制台使用用户自己的 IAM 身份对每次调用进行签名,因此相应角色需要拥有 bedrock-agentcore:InvokeWebSearch 权限。

Web Search API 关键事实、限制、定价和区域可用性

  • Web Search API 操作:bedrock-agentcore 数据平面上的 InvokeWebSearch,使用 AWS Signature Version 4 (SigV4) 签名。
  • 所需 IAM 权限:对 arn:aws:bedrock-agentcore:us-west-2:aws:tool/web-search.v1 拥有 bedrock-agentcore:InvokeWebSearch 权限。
  • 结果数量:每次查询返回 1 到 25 条结果;如果未设置 maxResults,最多返回 25 条。
  • 搜索文本限制:searchQuery 最多可包含 200 个字符。
  • 域名筛选限制:每个包含或排除列表最多可添加 100 个域名;根域名也会匹配其子域名。
  • 日期筛选格式:publishedAfter 和 publishedBefore 使用 UTC 时区的 RFC 3339 日期时间格式,例如 2026-01-01T00:00:00Z,且包含两个边界值。
  • 默认请求配额:每个账户在每个区域每秒最多可发送 10 个请求,也可以申请提高配额。
  • 定价:Web Search 费率为每 1,000 次查询 7 美元;由于不涉及网关,因此没有网关费用。
  • Python 的最低 Boto3 版本:1.43.127 或更高版本。
  • 框架支持:langchain-aws 1.9.3 和 AgentCore Python SDK 1.26.0 或更高版本。
  • 可用区域:美国东部(弗吉尼亚北部)、美国东部(俄亥俄)、美国西部(俄勒冈)、欧洲(爱尔兰)、亚太地区(东京)和亚太地区(悉尼)。

常见问题

开发者何时应选择 Web Search API,而不是 AgentCore Gateway?

博客建议在自定义编排、仪表板和流水线等非智能体用例、需要直接控制重试和缓存,或要为现有应用添加网页搜索时使用 Web Search API。对于构建使用 MCP 兼容工具的智能体、通过一个 MCP 端点整合多个工具、为多个智能体和团队统一应用由管理员设置的来源策略,以及支持需要搜索功能的 MCP 客户端(例如使用 AWS Web Search connector 的 Claude),则推荐使用 AgentCore Gateway。

Web Search API 如何计费?

Web Search API 按与网关连接器相同的用量类型计量,费率为每 1,000 次查询 7 美元。由于不涉及网关,因此没有网关费用。博客建议读者参阅 Amazon Bedrock AgentCore 定价详情。

开发者如何让 Web Search API 流量留在私有网络中?

开发者可以在调用 API 的每个 VPC 和区域中,为 com.amazonaws..bedrock-agentcore 创建接口 VPC 端点,并启用私有 DNS。端点的安全组必须允许来自调用资源的入站 HTTPS 流量通过端口 443。随后,可以通过端点策略以及 IAM 策略中的 aws:SourceVpce 条件,限制哪些主体可以通过该端点进行搜索。

免责声明:本页面信息可能来自第三方,仅供参考,不代表 Gate 的观点或意见,亦不构成任何财务、投资或法律建议。数字资产交易风险较高,请勿仅依赖本页面信息作出决策。具体内容详见声明。
评论
0/400
暂无评论