Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

网页搜索工具

人工智能代理正在改变组织与信息交互的方式，但他们面临着一个基本的局限性：他们的知识在培训时被冻结。当用户询问今天的股票价格或一小时前发货的软件版本时，仅仅依赖其培训数据的代理商无法提供准确的答案。

构建自定义网络搜索集成来解决这个问题非常昂贵——购买第三方搜索API，管理密钥、配额和速率限制，解析提供商之间不一致的结果格式，构建片段提取逻辑以便模型获得相关的段落而不是原始的HTML，推断客户查询的去向以及如何保留数据，以及随着时间的推移保持新鲜度和覆盖范围。其中每一个本身都是一个项目。

Amazon Bedrock 上的网络搜索工具 AgentCore 消除了这种复杂性。它是一种完全托管的 MCP-compliant Web 搜索功能，可让您的代理从 Web 检索信息，而无需任何基础架构开销。它可以作为托管连接器连接到 AgentCore 网关。代理通过标准tools/list调用发现它，并像任何其他模型上下文协议工具一样调用它。无需配置搜索 API，无需管理出站凭证，也无需维护结果解析粘合剂。

以下各节将介绍主要功能、专门构建的 Web 索引的架构、隐私保障、用例以及如何设置 Web Search Tool。

关键功能

Purpose-built 网络索引

许多向代理添加网络搜索的解决方案都是第三方搜索引擎的封装。Amazon Bedrock AgentCore 上的网络搜索工具与众不同——它由亚马逊直接构建和运营的网络索引提供支持。

私密性设计

对于许多企业来说，阻碍网络搜索部署的问题不是 “它行得通吗”，而是 “我的用户的查询去了哪里，他们会怎样？” Web Search Tool 的构建使这些答案非常简单。

工作原理

Web 搜索工具是一个内置的连接器。网关负责架构管理、参数管理、端点解析和服务身份验证。

使用案例

设置网络搜索工具

有关如何使用 Web 搜索工具连接器配置创建网关目标的说明，包括使用 Python SDK 和 CLI 的设置示例，请参阅目标配置指南中的设置网络搜索工具。

搭配安全带使用

要提供AgentCore 安全带 Web 搜索功能，请将您在设置 Web Search Tool 中创建的网关作为agentcore_gateway工具附加到安全带。线束执行角色需要网关 ARN 上的bedrock-agentcore:InvokeGateway权限。有关端到端演练，请参阅线束文档中的工具。

配置域筛选

Web Search Tool 支持 2 层筛选，可根据每个请求进行筛选：

Request-level 过滤器与目标级别的排除列表组成并包含列表：

Request-level 过滤器不能覆盖目标级别的排除列表或将结果扩展到目标级别的包含列表之外。

有关配置示例和详细信息，请参阅目标配置指南中的配置域筛选。

配置网关服务角色

Gateway 需要一个允许 AgentCore 服务代表您执行操作的服务角色。有关所需的 IAM 权限和策略配置，请参阅目标配置指南中的配置网关服务角色。

输入架构

通过调用时，Web 搜索工具接受以下输入架构tools/call。仅当目标固定到连接器版本1.2.0或更高版本时，该filters字段才可用。在早期版本中，架构仅公开query和。maxResults

{
  "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"
      },
      "filters": {
        "description": "Optional request-level filters (connector version 1.2.0+). Applied on top of the target-level exclude list and include list.",
        "type": "object",
        "properties": {
          "domainFilter": {
            "description": "Per-call domain filter. Include and exclude lists each hold up to 100 domains. Root domain matches subdomains.",
            "type": "object",
            "properties": {
              "include": {
                "description": "Restrict results to these domains.",
                "type": "array",
                "items": {"type": "string"}
              },
              "exclude": {
                "description": "Drop results from these domains.",
                "type": "array",
                "items": {"type": "string"}
              }
            }
          },
          "publishedDateFilter": {
            "description": "Per-call published-date filter. Bounds inclusive, ISO-8601 UTC. Applies to web results only.",
            "type": "object",
            "properties": {
              "from": {
                "description": "Earliest publication date (ISO-8601 UTC).",
                "type": "string"
              },
              "to": {
                "description": "Latest publication date (ISO-8601 UTC).",
                "type": "string"
              }
            }
          }
        }
      }
    },
    "required": ["query"]
  }
}

响应格式

Web 搜索工具按以下 MCP-compliant 格式返回结果：

{
  "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\"}]}"
    }
  ]
}

可用性

Web 搜索工具连接器可在以下 Amazon 区域使用：

由于 Amazon 运营着完整的搜索堆栈，因此新鲜度、覆盖范围、相关性和摘要质量的改进会自动通过同一个托管连接器流向您的代理。您无需进行版本升级或迁移。

可接受的用途

如果您使用网络搜索工具，则您应对自己以及您的最终用户对从网络搜索工具（“搜索结果”）检索到的内容（“搜索结果”）的使用负责。在向使用搜索结果的最终用户显示的任何输出中，您都必须保留并显示每个搜索结果中提供的来源引文和链接。您不得使用网络搜索工具 (a) 批量提取、存储或复制搜索结果中的内容，或 (b) 建立或填充竞争索引或数据库。