ウェブグラウンディング

ウェブグラウンディングを使用すると、Amazon Nova はウェブで現在の情報を検索し、引用を含むレスポンスを提供できます。この機能は、モデルのトレーニングデータ以外の最新情報を必要とするクエリに役立ちます。

ウェブグラウンディングの仕組み

プロンプトに対してウェブグラウンディングを有効にすると、次の手順が実行されます。

ウェブグラウンディングの使用方法

ウェブグラウンディングを利用するコードの詳細な例については、「コードサンプル」セクションを参照してください。

結果にウェブグラウンディングを含めるには、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)

リージョン別の可用性

ウェブグラウンディングは現在、米国リージョンでのみ使用でき、米国 CRIS プロファイルでのみサポートされています。

レスポンスの構造

以下に、レスポンスの例を示します。簡潔にするために、レスポンスは短縮されました。

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

各引用には以下が含まれます。

グラウンディングの安全性

データが AWS インフラストラクチャを離れることはありません。モデル生成クエリは AWS サービス内にとどまり、より広範なインターネットに送信されることはありません。当社の広範な内部ウェブ検索インデックスとナレッジグラフは、信頼できる高品質のソースを優先し、進入時に悪意のあるコンテンツをフィルタします。最後に、ランタイムフィルタリングによる間接的なプロンプトインジェクションや誤った情報からアプリケーションを保護します (この緩和策は英語以外の言語では制限されています)。

エラー処理

nova_grounding という名前の toolSpec エントリを含めないでください。この名前のツールを含めると、エラーが発生します。

以下は、ウェブグラウンディングの使用時に発生する可能性のあるエラーのリストです。

組み込みツールに必要なアクセス許可

ロールが Amazon Bedrock のウェブグラウンディングにアクセスできるようにするには、次の 2 つのオプションがあります。

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

ウェブグラウンディングでは、aws:requestedRegion 条件キーが「unspecified」に設定されています。既存のポリシーまたはサービスコントロールポリシー (SCP) がこの条件を適用すると、アクセスの問題が発生する可能性があります。「未指定」の requestedRegion を許可するように条件を更新すると、この問題を解決できます。