ウェブグラウンディングの仕組みウェブグラウンディングの使用方法グラウンディングの安全性エラー処理

リアルタイム検索の結果によるレスポンスのグラウンディング

注記

このドキュメントは Amazon Nova バージョン 1 を対象としています。Amazon Nova 2 で Web Grounding を使用する方法については、「ウェブグラウンディング」を参照してください。

ウェブグラウンディングは、ナレッジカットオフを超えてリアルタイムの情報に接続することで Nova モデルを強化し、より正確で信頼性の高いレスポンスを実現します。

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

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

リクエスト設定 — アプリケーションは、systemTool として nova_grounding が有効になっている Amazon Bedrock API にユーザープロンプトを送信します。
検索評価 — モデルはプロンプトを分析し、レスポンスを改善するために検索が必要かどうかを判断します。
検索の実行 — 必要に応じて、モデルは関連情報の 1 つ以上の検索を自動的に実行します。
結果分析 — モデルは、理解を深めたり、特定のサブトピックをより深く掘り下げたりするために、追加の検索が必要かどうかを判断します。
レスポンスの生成 — Nova は、検索結果の情報を自動的に合成して、ソースへの引用を含むリアルタイムの情報に基づく最終的な API レスポンスを生成します。

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

結果にウェブグラウンディングを含めるには、toolConfig ブロックで次の systemTool パラメータを指定します。


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

toolConfig で、上記の例のように systemTool パラメータを持つツールを追加します。このパラメータを使用すると、システム定義のツールを指定できます。システム定義のツールは、モデルプロバイダーによって提供および呼び出されるツールです。systemTool パラメータの使用の詳細については、Amazon Bedrock API リファレンスの「SystemTool」を参照してください。

注記

ウェブグラウンディングは、米国リージョンでのみ使用できます。ウェブグラウンディングを使用するには、クロスリージョン推論プロファイル us.amazon.nova-premier-v1:0 を使用して Amazon Nova Premier を呼び出します。

次の例は、ウェブグラウンディングを使用した 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"
                    }
            }
         }
        ]
    }
},
...

このレスポンスには、モデルによって生成されたテキストとそのテキストの引用情報という 2 つのコンポーネントが含まれています。含まれる要素は次のとおりです。

text — モデルが生成したレスポンスのセグメント。
citationsContent — text セグメントに関連する引用データのプライマリコンテナ。
citations — 引用の場所を保持する citationsContent 内のコンテナ。
location — 引用元を保持する citations 内のコンテナ。
web — ウェブソースの詳細を保持する location 内のコンテナ。
url — 引用元の完全なウェブアドレス (URL)。
domain — ソース url のルートドメイン。

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

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

エラー処理

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

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

malformed_tool_use
max_tokens
malformed_model_output

ツールアクセスのデバッグ

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

IAM ロールで BedrockFullAccess を有効にする: ロールに BedrockFullAccess がある場合、ウェブグラウンディングに自動的にアクセスできます。

特定のアクセス許可を追加する (必要な場合): より詳細なアクセスコントロールが必要な場合は、このポリシーをロールの IAM ポリシーに追加し、赤いテキストを AWS アカウント ID に置き換えます。



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

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

重要

ウェブグラウンディングツールを有効にすると、グラウンディングされた情報を組み込んだ出力の使用とエンドユーザーによる使用は、お客様の責任となります。引用またはソースマテリアルへのリンクからのグラウンド情報が出力に含まれるタイミングを把握できます。これらの引用とリンクは、エンドユーザーに提供する出力に保持して表示する必要があります。

注記

ウェブグラウンディングには追加料金がかかります。詳細については「https://aws.amazon.com//bedrock/pricing/」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

エラーの報告

RAG システムの構築