本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 网页搜索工具 人工智能代理正在改变组织与信息交互的方式，但他们面临着一个基本的局限性：他们的知识在培训时被冻结。当用户询问今天的股票价格或一小时前发货的软件版本时，仅仅依赖其培训数据的代理商无法提供准确的答案。 构建自定义网络搜索集成来解决这个问题非常昂贵——购买第三方搜索API，管理密钥、配额和速率限制，解析提供商之间不一致的结果格式，构建片段提取逻辑以便模型获得相关的段落而不是原始的HTML，推断客户查询的去向以及如何保留数据，以及随着时间的推移保持新鲜度和覆盖范围。其中每一个本身都是一个项目。 Amazon Bedrock 上的网络搜索工具 AgentCore 消除了这种复杂性。它是一种完全托管的 MCP-compliant Web 搜索功能，可让您的代理从 Web 检索信息，而无需任何基础架构开销。它可以作为托管连接器连接到 AgentCore 网关。代理通过标准`tools/list`调用发现它，并像任何其他模型上下文协议工具一样调用它。无需配置搜索 API，无需管理出站凭证，也无需维护结果解析粘合剂。 以下各节将介绍主要功能、专门构建的 Web 索引的架构、隐私保障、用例以及如何设置 Web Search Tool。 **Topics** + [关键功能](#gateway-target-connector-web-search-tool-key-capabilities) + [Purpose-built 网络索引](#gateway-target-connector-web-search-tool-web-index) + [私密性设计](#gateway-target-connector-web-search-tool-privacy) + [工作原理](#gateway-target-connector-web-search-tool-how-it-works) + [使用案例](#gateway-target-connector-web-search-tool-use-cases) + [设置网络搜索工具](#gateway-target-connector-web-search-tool-setup) + [搭配安全带使用](#gateway-target-connector-web-search-tool-harness) + [配置域筛选](#gateway-target-connector-web-search-tool-domain-filtering) + [配置网关服务角色](#gateway-target-connector-web-search-tool-service-role) + [输入架构](#gateway-target-connector-web-search-tool-input-schema) + [响应格式](#gateway-target-connector-web-search-tool-response-format) + [可用性](#gateway-target-connector-web-search-tool-availability) + [可接受的用途](#gateway-target-connector-web-search-tool-acceptable-use) ## 关键功能 + **Up-to-date 信息访问权限** — 检索当前的网络结果，包括标题、网址、片段和发布日期，以便在最新信息中获取地面工作人员的回复。 + **零基础架构管理** — 无需配置第三方搜索 API，也无需扩展即可配置。网关会自动将网络搜索作为标准的 MCP 工具公开。 + 与@@ **框架无关 — 通过标准模型上下文协议与 Strands Ag** ents LangChain LangGraph、、、CrewaI 或任何 MCP-compatible 客户端配合使用。 + **域名和日期筛选**-使用目标级域名排除列表限制搜索。在连接器版本`1.2.0`及更高版本中，目标还支持域包含列表，代理可以传递每个请求的域包含和排除列表以及发布日期边界。 + **Purpose-built Web 索引** — 由跨越数百亿个文档的 Amazon-operated Web 索引提供支持。 + **高可信度事实的知识图谱** — 将实体及其关系置于基础上，以提供事实答案，而不是离开模型从提取的页面文本中推断出答案。 + **语义片段提取** — 从每个网页中提取语义相关的段落，针对模型的上下文窗口进行了优化，而不是返回原始的 HTML 或整页。 ## Purpose-built 网络索引 许多向代理添加网络搜索的解决方案都是第三方搜索引擎的封装。Amazon Bedrock AgentCore 上的网络搜索工具与众不同——它由亚马逊直接构建和运营的网络索引提供支持。 **覆盖面广** 该索引涵盖数百亿份文档。这种规模对覆盖范围很重要——当索引范围广泛而不是仅限于最受欢迎的页面时，可以更有效地回答有关利基库或模糊产品规格的长尾问题。 **持续更新** Amazon 会持续刷新索引，在几分钟内反映出新的和变更的内容。对于回答有关价格走势的问题或刚刚发布的公告的代理商来说，最近窗口是有根据的答案和自信的错误答案之间的区别。当你的经纪人搜索 “今天发生了什么” 时，结果反映了今天的实际情况。 **高可信度事实的知识图表** Web Search Tool 包括一个内置的知识图表，可以为实体及其关系奠定基础。对于事实问题（例如谁担任角色或某件事何时成立），知识图谱提供了高度可信的答案，而不是让模型从提取的页面文本中推断出答案。这减少了特工仅从片段中拼凑出答案时可能发生的那种微妙的事实偏差。 **针对模型上下文优化的语义片段提取** 该工具不会将原始的 HTML 转储或整页交给模型，而是执行语义相关的片段提取。它从每个网页中提取实际与查询相关的段落，并以针对模型的上下文窗口进行了优化的形式返回这些段落。结果是每个代币更密集、更相关的上下文——模型可以看到重要的部分，在样板和导航chrome上花费更少的代币，这有助于提高被引答案的精度。 ## 私密性设计 对于许多企业来说，阻碍网络搜索部署的问题不是 “它行得通吗”，而是 “我的用户的查询去了哪里，他们会怎样？” Web Search Tool 的构建使这些答案非常简单。 **查询永远不会离开 Amazon ** 当您的代理发出搜索时，查询将完全在 Amazon 基础架构内提供。客户查询不会发送到第三方搜索引擎，也不会发送到外部 Amazon搜索引擎。网关对 Amazon拥有的连接器进行身份验证，并在内部路由请求，因此数据路径端对 Amazon 端地保持在内部。对于有数据流出问题的团队，这会删除整个类别的审核。 ## 工作原理 Web 搜索工具是一个内置的**连接器**。网关负责架构管理、参数管理、端点解析和服务身份验证。 1. **网关设置**-使用创建网关并添加 Web 搜索工具目标`connectorId: "web-search"`。网关会对工具架构进行快照并配置集成。 1. **工具发现**-您的代理调用 `tools/list` Gateway 端点并发现带有其输入架构的`WebSearch`工具。 1. **搜索调用**-您的代理`tools/call`使用自然语言查询（最多 200 个字符）进行呼叫，在连接器版本及更高版本中，还会使用针对域名`1.2.0`和发布日期的可选请求级过滤器进行呼叫。网关向后端进行身份验证，并在内部 Amazon路由请求。 1. **结构化结果** — 该工具以文本和结构化 JSON 格式返回包含语义相关的文本片段、URL、标题和发布日期的结果。 1. 有@@ **根据的回应**-您的代理使用结果撰写带有引用来源的回复。 ## 使用案例 + **Up-to-date 研究** — 通过搜索网络并将结果与来源引文进行综合，回答有关时事、股票价格或最近公告的问题。 + **Fact-checking**— 通过搜索主要来源并使用知识图支持的事实答案来确认或更正数字，从而验证文档中的主张。 + **竞争情报** — 监控来自公共网络来源的竞争对手公告、产品发布或定价变化。 + **淘汰陈旧知识** — 允许代理访问培训截止日期后发布的信息，例如新软件发布、政策变更或突破性进展。 ## 设置网络搜索工具 有关如何使用 Web 搜索工具连接器配置创建网关目标的说明，包括使用 Python SDK 和 CLI 的[设置示例，请参阅目标配置指南中的设置网络搜索工具](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-web-search-setup)。 ## 搭配安全带使用 要提供[AgentCore 安全带](harness.md) Web 搜索功能，请将您在设置 Web Search Tool 中创建的网关作为`agentcore_gateway`工具附加到安全带。线束执行角色需要网关 ARN 上的`bedrock-agentcore:InvokeGateway`权限。有关端到端演练，请参阅线束文档中的[工具](harness-tools.md)。 ## 配置域筛选 Web Search Tool 支持 2 层筛选，可根据每个请求进行筛选： + **Target-level 域排除列表和包含列表。**设置目标时，管理员会配置目标从每次搜索中排除或限制的域名列表。这两个列表都对调用代理隐藏，并应用于流经目标的每个请求。 + **Request-level 过滤器（连接器版本`1.2.0`及更高版本）。**调用代理可以在每个`tools/call`请求中传递一个可选`filters`对象： + `domainFilter`— `include` 和`exclude`列表，每个列表最多 100 个域名。Web Search Tool 仅返回`include`列表中域名的结果，并删除其域名出现在`exclude`列表中的任何结果。 + `publishedDateFilter`— `from` 以及`to`边界（包括 ISO-8601 世界标准时间）。Web Search Tool 仅返回发布日期介于`from`和`to`日期或之间的结果。 Request-level 过滤器与目标级别的排除列表组成并包含列表： + 如果某个域出现在目标级排除列表或请求级排除列表中，则该域名将从结果中删除。 + 只有当域出现在设置的每个包含列表中时，才会返回该域。如果仅设置了目标级别的包含列表或仅设置了请求级别的包含列表，则该列表将受到尊重。如果两者都设置了，则只返回两者中都存在的域。如果两者没有共享任何域，则不会返回任何结果。 Request-level 过滤器不能覆盖目标级别的排除列表或将结果扩展到目标级别的包含列表之外。 有关配置示例和详细信息，请参阅目标[配置指南中的配置域筛选](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-web-search-domain-filtering)。 ## 配置网关服务角色 Gateway 需要一个允许 AgentCore 服务代表您执行操作的服务角色。有关所需的 IAM 权限和策略配置，请参阅目标[配置指南中的配置网关服务角色](gateway-add-target-api-target-config.md#gateway-add-target-api-connector-web-search-service-role)。 ## 输入架构 通过调用时，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"] } } ``` | 字段 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | `query` | 字符串 | 是 | 搜索查询字符串。必须不超过 200 个字符。 | | `maxResults` | integer | 否 | 要返回的最大结果数量。有效范围：1-25。默认值为 10。 | | `filters` | object | 否 | 可选的请求级过滤器。在连接器版本`1.2.0`及更高版本中可用。 | | `filters.domainFilter.include` | 字符串数组 | 否 | 要包含的域名。最多 100 个参赛作品。 | | `filters.domainFilter.exclude` | 字符串数组 | 否 | 要排除的域。最多 100 个参赛作品。 | | `filters.publishedDateFilter.from` | 字符串 | 否 | 最早出版日期， ISO-8601 世界标准时间。 | | `filters.publishedDateFilter.to` | 字符串 | 否 | 最新出版日期， ISO-8601 世界标准时间。 | ## 响应格式 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\"}]}" } ] } ``` | 字段 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | `text` | 字符串 | 是 | 搜索结果的文字内容或片段 | | `url` | 字符串 | 否 | 源网页的网址 | | `title` | 字符串 | 否 | 来源网页的标题 | | `publishedDate` | 字符串 | 否 | 结果公布日期 | ## 可用性 Web 搜索工具连接器可在以下 Amazon 区域使用： + 美国东部（弗吉尼亚北部）`us-east-1` + 美国东部（俄亥俄州）`us-east-2` + 美国西部（俄勒冈）`us-west-2` + 欧洲（爱尔兰）`eu-west-1` + 亚太地区（悉尼）`ap-southeast-2` + 亚太地区（东京）`ap-northeast-1` + Amazon GovCloud (US-West) `us-gov-west-1` 由于 Amazon 运营着完整的搜索堆栈，因此新鲜度、覆盖范围、相关性和摘要质量的改进会自动通过同一个托管连接器流向您的代理。您无需进行版本升级或迁移。 ## 可接受的用途 如果您使用网络搜索工具，则您应对自己以及您的最终用户对从网络搜索工具（“搜索结果”）检索到的内容（“搜索结果”）的使用负责。在向使用搜索结果的最终用户显示的任何输出中，您都必须保留并显示每个搜索结果中提供的来源引文和链接。您不得使用网络搜索工具 (a) 批量提取、存储或复制搜索结果中的内容，或 (b) 建立或填充竞争索引或数据库。