AWS推出Bedrock AgentCore网页搜索API,单次调用即可检索
AWS称开发者可用现有IAM凭证直接调用InvokeWebSearch,无需先创建网关或管理API密钥;每次查询 7 美元/千次,已在六个区域上线。
AI解读:此前网页搜索能力通过AgentCore Gateway提供,需创建网关和搜索目标、再从MCP客户端调用;新API让开发者自己的代码用一次调用直接拿到搜索结果。
调用使用AWS SDK或AWS CLI,以与其他AWS服务相同的IAM凭证签名,官方说明无需预先创建资源、无需管理API密钥。返回结果是带排序的网页索引条目,每条含文本摘录,并在索引具备时附带标题、URL和发布时间。
单次请求可返回 1 至 25 条结果,查询文本上限 200 字符;可按域名包含或排除,每个列表最多 100 个域名,根域名同时匹配子域;发布时间可按RFC 3339的UTC时间过滤,上下界均包含。
AWS文章列出该API适合自建编排(如LangChain、LlamaIndex)、非智能体场景(仪表盘、事实核查、内容补全、监控)、自行管理重试与缓存,以及已有API层、不想接入完整网关的存量应用。大多数智能体工作负载仍被建议走网关。
计费按网页搜索单价每 1,000 次查询 7 美元,不产生网关费用。可用区域为美国东部(弗吉尼亚北部)、美国东部(俄亥俄)、美国西部(俄勒冈)、欧洲(爱尔兰)、亚太(东京)和亚太(悉尼)。默认每账户每区域每秒 10 次请求,可申请提高。
AWS在机器学习博客发布Amazon Bedrock AgentCore的Web Search API。此前该服务通过AgentCore Gateway提供网页搜索,开发者要建网关和搜索目标,再从MCP客户端调用工具;新API允许代码直接调用InvokeWebSearch,用标准AWS凭证签名,不需要先创建资源或管理API密钥。
单次调用返回什么
该API是bedrock-agentcore数据平面上的InvokeWebSearch操作,与AgentCore Browser等其他AgentCore工具使用同一端点。请求用AWS Signature Version 4从标准AWS凭证签名,并通过IAM检查调用方是否拥有对AWS托管网页搜索工具的bedrock-agentcore:InvokeWebSearch权限。
每次查询返回最多maxResults条排序结果。每条结果都含文本摘录;标题、URL和发布时间在索引有时才返回,因此读取时需按可选字段处理。查询文本上限 200 字符,结果数可设为 1 至 25,不设置时最多返回 25 条。
过滤条件包括域名包含或排除列表(各最多 100 个,根域名匹配子域)以及发布时间范围,后者用RFC 3339格式的UTC时间给出,上下界都包含。
- 调用方式:AWS SDK或AWS CLI,SigV4签名,无需API密钥
- 权限:每条调用身份需具备bedrock-agentcore:InvokeWebSearch
- 搜索来源:Amazon自行运营的网页索引;AWS称查询在AWS内部处理,不发送给第三方搜索引擎
- 适用集成:自建应用、自写智能体循环、数据管道
与网关的分工
AWS表示AgentCore Gateway仍是大多数智能体工作负载的推荐路径:它给智能体一个安全的MCP端点,把网页搜索与其他工具放在一起,并处理进出站认证、语义工具选择以及可选的MCP会话。新API面向网关不合适的情况,二者搜索同一索引。
两者在鉴权和控制方式上有差别:网关除IAM外还可使用JWT授权调用方;网关管理员可在目标上设置对每次请求生效的域名列表,而API的过滤条件由每个请求自行携带。字段名也不同,API使用searchQuery、publishedAfter、publishedBefore,网关的MCP工具使用query、from、to。
- 网关场景:构建使用MCP兼容工具的智能体;多个工具放在一个MCP端点后;一名管理员为多团队统一搜索策略
- API场景:自建编排;非智能体用途;直接控制重试和缓存;在已有API层的应用中补充网页搜索
企业控制与计费
因为沿用标准IAM,AWS列出从首次调用起可用的控制项:按用户、组或角色授予或拒绝InvokeWebSearch,并用服务控制策略跨账户限制。CloudTrail可将InvokeWebSearch作为数据事件记录,但默认不记录,需为AWS::BedrockAgentCore::WebSearch资源类型添加事件选择器;事件记录工具和maxResults,不记录搜索文本或过滤条件。
通过AWS PrivateLink的接口VPC端点,私有子网中的代码可以走AWS网络调用该API,无需互联网网关、NAT网关或代理。端点策略可与IAM策略叠加,也可用aws:SourceVpce条件要求调用只能经过指定端点;接口端点按标准PrivateLink价格计费。
价格方面,该API与网关连接器计在同一种用量类型下,按网页搜索单价每 1,000 次查询 7 美元计费;不经过网关,因此没有网关费用。官方还说明网页搜索工具条款同样适用于API结果,包括保留并展示结果附带的来源引用和链接。
- 默认配额:每账户每区域每秒 10 次请求
- 区域:美国东部(弗吉尼亚北部)、美国东部(俄亥俄)、美国西部(俄勒冈)、欧洲(爱尔兰)、亚太(东京)、亚太(悉尼)
- 控制台可按域名和日期设置过滤,测试查询并生成代码片段或创建网关目标
- LangChain集成需要langchain-aws 1.9.3或更高版本;AgentCore Python SDK需 1.26.0 或更高版本