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

网页搜索工具

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

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

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

以下各节介绍关键功能、专用 Web 索引的架构、隐私保障、用例以及如何设置 Web 搜索工具。

关键功能

Purpose-built 网络索引

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

专为私人设计

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

工作原理

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

使用案例

设置 Web 搜索工具

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

搭配安全带使用

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

配置域过滤

Web 搜索工具支持 2 层过滤功能，可根据每个请求编写：

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

Request-level 过滤器无法覆盖目标级别排除列表，也无法将结果扩展到目标级别包含列表之外。

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

配置网关服务角色

网关需要一个服务角色来允许该 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 搜索工具连接器在以下 AWS 地区可用：

由于亚马逊运行的是完整的搜索堆栈，因此新鲜度、覆盖范围、相关性和代码片段质量的改进会自动通过相同的托管连接器传递给您的代理。您无需进行版本升级或迁移。

可接受的用途

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