将实时搜索结果作为响应的基础 - Amazon Nova
Web Grounding 的工作原理如何使用 Web Grounding Grounding 安全性 错误处理

将实时搜索结果作为响应的基础

注意

本文档适用于 Amazon Nova 版本 1。有关在 Amazon Nova 2 中使用 Web Grounding 的信息，请访问 Web Grounding。

Web Grounding 通过将 Nova 模型连接到其知识范围之外的实时信息来增强模型，从而获得更准确、更可靠的响应。

Web Grounding 的工作原理

为提示启用 Web Grounding 后，将会执行以下步骤：

  1. 请求配置：您的应用程序向 Amazon Bedrock API 发送一条用户提示，并将 nova_grounding 作为 systemTool 启用。

  2. 搜索评估：模型会分析该提示并确定是否需要通过搜索来完善响应。

  3. 搜索执行：如果需要搜索，模型会自动进行一次或多次相关信息搜索。

  4. 结果分析：模型决定是否需要进行额外的搜索、扩大其理解范围或更深入地研究特定子主题。

  5. 响应生成：Nova 会自动合成搜索结果中的信息，以生成基于实时信息的最终 API 响应，并附上对相关资料来源的引用。

如何使用 Web Grounding

要在结果中包含 Web Grounding，请在 toolConfig 块中指定以下 systemTool 参数：

"toolConfig": {
    "tools": [
        {"systemTool": {"name": "nova_grounding"}}
    ]
}

在您的 toolConfig 中，添加一个带有 systemTool 参数的工具，如上例所示。使用此参数后，您将可以指定系统定义工具。系统定义工具是由模型提供者提供和调用的工具。有关使用 systemTool 参数的详细信息，请参阅《Amazon Bedrock API 参考》中的 SystemTool。

注意

Web Grounding 功能仅在美国区域可用。您可以通过使用跨区域推理配置文件 us.amazon.nova-premier-v1:0 调用 Amazon Nova Premier 的方式来使用 Web Grounding。

以下示例是使用 Web Grounding 的 AWS CLI 命令：

aws --profile 111122223333 --region us-east-1 bedrock-runtime converse --model-id us.amazon.nova-premier-v1:0 --tool-config '{"tools":[{"systemTool":{"name":"nova_grounding"}}]}' --messages '[{"role":"user","content":[{"text":"What is the latest news about renewable energy sources?"}]}]'

以下为响应示例。为简便起见，响应已经精简：

...
{
    "text": ".\n- **Solar energy** is leading growth with a 31% increase in generation in early 2025, outpacing wind's 7.7% growth "
},
{
    "citationsContent": {
        "citations": [
            {
                "location": {
                    "web": {
                        "url": "https://www.rfi.fr/en/environment/20251008-renewables-overtake-coal-but-growth-slows-amid-us-and-china-report-shows",
                        "domain": "rfi.fr"
                    }
            }
         }
        ]
    }
},
...

该响应包含两个组成部分，即模型生成的文本和该文本的引用信息。包括的元素有：

  • text：模型所生成响应中的一个分段。

  • citationsContent：与 text 分段相关的引用数据的主要容器。

  • citations：citationsContent 中含有引用位置的容器。

  • location：citations 中含有引用来源的容器。

  • web：location 中含有 Web 来源详细信息的容器。

  • url：引用来源的完整网址（URL）。

  • domain：来源 url 的根域。

Grounding 安全性

您的数据永远不会离开 AWS 基础设施。模型生成的查询保留在 AWS 服务中，永远不会发送到外部互联网。我们庞大的内部 Web 搜索索引和知识图会优先考虑可信和高质量的来源，并在入口处过滤恶意内容。Web Grounding 在运行时通过从多个来源交叉引用来进一步优化信息。最后，我们通过运行时过滤来保护您的应用程序，使其免受间接提示注入和错误信息的侵害（请注意，这种缓解措施对于非英语语言的效果较为有限）。

错误处理

请勿包含名称为 nova_grounding 的 toolSpec 条目。添加使用此名称的工具将会导致错误。

使用 Web Grounding 时可能出现的潜在错误列表如下：

  • malformed_tool_use

  • max_tokens

  • malformed_model_output

调试工具访问权限

为确保您的角色可以在 AWS Bedrock 上访问 Web Grounding，您可以通过两种方式来实现：

  1. 在您的 IAM 角色上启用 BedrockFullAccess：如果您的角色具有 BedrockFullAccess 权限，则将自动拥有 Web Grounding 访问权限。

  2. 添加特定权限（如果需要）：如果您需要更精细的访问控制，请将此策略添加到您角色的 IAM 策略中，并将红色文本替换为您的 AWS 账户 ID：

    
{ 
    Statement: [ 
      { 
        Effect: "Allow", 
        Action: [ "bedrock:InvokeTool" ], 
        Resource: [ "arn:aws:bedrock::{111122223333}:system-tool/amazon.nova_grounding" ] 
       } 
      ] 
}

Web Grounding 将 aws:requestedRegion 条件键设置为“未指定”。如果您的现有策略或服务控制策略（SCP）强制执行此条件，则可能会出现访问权限问题。将该条件更新为允许“未指定”的 requestedRegion，即可解决此问题。

重要

如果您启用了 Web Grounding 工具，则需要为您自己以及您的最终用户使用的包含所连接信息的输出负责。当您的输出包含来自引用或来源材料链接的连接信息时，系统将会提示您。您必须在提供给最终用户的输出中保留并显示这些引用和链接。

注意

使用 Web Grounding 会产生额外的成本。有关更多信息，请参阅https://aws.amazon.com//bedrock/pricing/