AgentCore Web Search API 已 GA：价格、区域与 MCP 参数差异

什么场景适合直接调用 InvokeWebSearch

如果你的应用、自建智能体循环或数据管线要直接消费搜索结果，可以使用 AWS SDK 或 AWS CLI 调用 InvokeWebSearch。AWS 的11月10日公告已将该 API 列为正式可用；开发者指南说明无需创建或管理专用资源。

返回值是来自 Amazon 运营的网页索引的排序结果。每条包含页面文本摘录；标题、URL 和发布时间在可获得时返回。应用仍需决定怎样阅读来源和生成答案。

通过模型上下文协议（MCP）发现并调用工具的智能体，可继续使用 AgentCore Gateway 的 Web Search Tool 连接器。需要一次调用获得成文回答时，应另查 Web Answer 的能力、区域和费用。

从 MCP 迁移时，先改授权和字段

直接 API 通过 AgentCore 数据平面端点调用，并且只使用 AWS 身份与访问管理（IAM）授权。Gateway 还可以使用 JSON Web Token（JWT）授权；不要把 Gateway 的 JWT 当作该 API 的授权方式。

API 用 searchQuery 提交搜索文字，MCP 工具用 query。API 的时间范围字段是 publishedAfter 与 publishedBefore，MCP 用 from 与 to；仅替换端点并不能让整套 MCP 请求字段适用于 API。

API 的域名过滤由每次请求携带；连接器还可以设置目标级域名列表。未设置 maxResults 时，API 最多返回25条结果，MCP 工具最多10条。这是默认数量，不保证每次都有这么多条。

publishedBefore 的日期会落在 UTC 零点

两种接口的发布时间上下界都包含边界，但不带时刻的结束日期含义不同。MCP 的 to 日期包含那一整天；AWS SDK 和 CLI 会把 API 的 publishedBefore 日期发送为当天开始时的 UTC 零点。

假设把 publishedBefore 写成2026-11-10，发送的上界是2026-11-10T00:00:00Z。一个标为2026-11-10T12:00:00Z发布的页面就在该上界之后，不能因为日期相同就认为它符合范围。这个例子只说明时间比较，并非实际搜索结果。

需要明确时段时，先按业务时区换算成 UTC，再使用明确的日期时间并核对包含边界。不要把 API 的结束日期当作 MCP 的全天结束条件。

六个区域与每秒请求配额

当前 API 区域为美国东部（弗吉尼亚北部）us-east-1、美国东部（俄亥俄）us-east-2、美国西部（俄勒冈）us-west-2、亚太（悉尼）ap-southeast-2、亚太（东京）ap-northeast-1，以及欧洲（爱尔兰）eu-west-1。应在实际调用区域核对服务与账号权限。

该 API 不在 AWS GovCloud（美国西部）提供；开发者指南指出，该区域可使用 Web Search Tool 连接器。不要把连接器的区域清单直接套到 API。

默认配额是每个账号、每个区域每秒10次 InvokeWebSearch 请求。需要提高时可联系 AWS Support 申请；申请不等于已获批，应用应按实际获批配额安排调用。

每千次查询7美元，怎样算费用

AWS 列出的 Web Search 价格为每1,000次搜索查询7美元，按提交的查询计费，无最低费用或预付承诺。直接 API 不收取 Gateway 费用；通过 Gateway 调用时，则仍需核算实际使用的 Gateway 服务。

例如，假设提交10,000次查询，仅按该搜索费率计算为70美元。这是说明单项费用的假设算式，不是实际账单；模型推理及其他使用的服务仍可能产生各自费用。

公告也支持从虚拟私有云（VPC） 通过 AWS PrivateLink 调用，并把请求记录为 AWS CloudTrail 数据事件。这些是可用接入与日志能力，不代表整套网络、审计和智能体架构都免费；需要时分别核对相关服务定价。

接入前按什么顺序检查

先选择受支持区域与有相应 IAM 授权的调用身份，再按 API 文档设置 searchQuery、域名与发布时间过滤，以及需要的 maxResults。用不含凭据或私人记录的少量查询检查请求和响应，记录实际区域、参数及错误。

读取结果时要兼容缺失的标题、URL 或发布时间，不要自行补造来源信息。开发者指南要求保留并展示结果随附的来源引用和链接；重要信息仍需核对原始来源，不能仅凭搜索排名认定其正确或完整。