Web Grounding

Web Grounding 使 Amazon Nova 能够在网络上搜索当前信息，并提供带引文的回复。该功能适用于需要获取模型训练数据以外最新信息的查询。

Web Grounding 的工作原理

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

如何使用 Web Grounding

如需查看使用 Web Grounding 的完整代码示例，请参阅“代码示例”部分。

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

import boto3
from botocore.config import Config

# Create the Bedrock Runtime client with extended timeout
bedrock = boto3.client(
    "bedrock-runtime",
    region_name="us-east-1",
    config=Config(read_timeout=3600)
)

# Define the tool configuration
tool_config = {
    "tools": [{
        "systemTool": {
            "name": "nova_grounding"
        }
    }]
}

# Send the request
response = bedrock.converse(
    modelId="us.amazon.nova-2-lite-v1:0",
    messages=[{
        "role": "user",
        "content": [{"text": "What are the latest developments in quantum computing?"}]
    }],
    toolConfig=tool_config
)

# Extract text with interleaved citations
output_with_citations = ""
content_list = response["output"]["message"]["content"]
for content in content_list:
    if "text" in content:
        output_with_citations += content["text"]
    elif "citationsContent" in content:
        citations = content["citationsContent"]["citations"]
        for citation in citations:
            url = citation["location"]["web"]["url"]
            output_with_citations += f" [{url}]"

print(output_with_citations)

区域可用性

Web Grounding 目前仅面向美国区域开放，且仅支持美国 CRIS 配置文件。

响应结构

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

{
  "output": {
    "message": {
      "content": [
        {
          "text": "Recent quantum computing developments include...",
          "citationsContent": [
            {
              "location": {
                "web": {
                  "url": "https://example.com/quantum-news",
                  "domain": "example.com"
                }
              }
            }
          ]
        }
      ]
    }
  }
}

每个引文包含以下内容：

Grounding 安全

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

错误处理

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

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

内置工具所需的权限

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

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

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