本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用即時搜尋結果獲取回應依據
<a name="grounding"></a>

**注意**  
本文件適用於 Amazon Nova 第 1 版。如需有關搭配 Amazon Nova 2 使用 Web Grounding 的資訊，請造訪 [Web Grounding](https://docs.aws.amazon.com/nova/latest/nova2-userguide/web-grounding.html)。

Web Grounding 透過將 Nova 模型連接到超出其知識截止範圍的即時資訊來增強這些模型，進而產生更準確且可靠的回應。

## Web Grounding 的運作方式
<a name="web-grounding-how"></a>

為提示詞啟用 Web Grounding 後，會執行下列步驟：

1. **請求組態** — 您的應用程式會傳送使用者提示詞至 Amazon Bedrock API，並啓用 nova\$1grounding 作爲 systemTool。

1. **搜尋評估** — 模型會分析提示詞，並判斷是否需要搜尋以改善回應。

1. **搜尋執行** — 必要時，模型會自動執行一或多個搜尋以獲取相關資訊。

1. **結果分析** — 模型判斷是否需要額外的搜尋，以擴展其對特定子主題的理解或深入了解。

1. **回應產生** — Nova 會自動合成搜尋結果中的資訊，以產生以即時資訊為依據的最終 API 回應，並附上其來源的引文。

## 如何使用 Web Grounding
<a name="web-grounding-example"></a>

若要在結果中包含 Web Grounding，請在 `toolConfig` 區塊中指定下列 `systemTool` 參數：

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

在您的 `toolConfig` 中，新增具有 `systemTool` 參數的工具，如上述範例所示。此參數可讓您指定*系統定義的工具*。*系統定義的工具*是由模型提供者提供和調用的工具。如需使用 `systemTool` 參數的詳細資訊，請參閱《Amazon Bedrock API 參考》中的 [SystemTool](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_SystemTool.html)。

**注意**  
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` — 引文來源的完整 Web 地址 (URL)。
+ `domain` — 來源 `url` 的根網域。

## 依據安全
<a name="w2aac55c13"></a>

您的資料永遠不會離開 AWS 基礎設施。模型產生的查詢會保留在 AWS 服務中，絕不會傳送到更廣泛的網際網路。我們廣泛的內部 Web 搜尋索引和知識圖表會優先考慮值得信賴的高品質來源，並在傳入時篩選惡意內容。Web Grounding 透過來自多個來源的交叉參考，進一步精簡執行時期的資訊。最後，我們會透過執行時期篩選保護您的應用程式免於間接提示詞注入和錯誤資訊 (請注意，此風險緩解措施僅限於非英文語言)。

## 錯誤處理
<a name="w2aac55c15"></a>

請勿包含名稱為 `nova_grounding` 的 `toolSpec` 項目。包含具有此名稱的工具會導致錯誤。

以下是使用 Web Grounding 時可能發生的潛在錯誤清單：
+ `malformed_tool_use`
+ `max_tokens`
+ `malformed_model_output`

### 偵錯工具存取
<a name="w2aac55c15b9"></a>

為了確保您的角色可以存取 AWS Bedrock 上的 Web Grounding，您有兩個選項：

1. **在 IAM 角色上啟用 BedrockFullAccess**：如果您的角色具有 BedrockFullAccess，它會自動存取 Web Grounding。

1. **新增特定許可 （如果需要）**：如果您需要更精細的存取控制，請將此政策新增至角色的 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/](https://aws.amazon.com//bedrock/pricing/)