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

# 從具有單字篩選條件的對話中移除特定單字和片語清單
<a name="guardrails-word-filters"></a>

Amazon Bedrock 防護機制具有單字篩選條件，可用於在輸入提示和模型回應中封鎖單字和片語 (完全相符)。您可以使用下列單字篩選條件來封鎖褻瀆、令人反感或不適當的內容，或是具有競爭對手或產品名稱的內容。
+ **褻瀆篩選條件** – 開啟以封鎖褻瀆文字。褻瀆清單是以褻瀆的傳統定義為基礎，並且會持續更新。
+ **自訂單字篩選條件 **– 使用最多三個單字 AWS 管理主控台 的 將自訂單字和片語新增至清單。您最多可以將 10,000 個項目新增至自訂單字篩選條件。

  您可以透過下列選項使用 Amazon Bedrock AWS 管理主控台新增單字和片語：
  + 在文字編輯器中手動新增。
  + 上傳 .txt 或 .csv 檔案。
  + 從 Amazon S3 儲存貯體上傳物件。
**注意**  
您只能使用 上傳文件和物件 AWS 管理主控台。API 和 SDK 操作僅支援文字，不包含上傳文件和物件。

## 為您的防護機制設定單字政策
<a name="guardrails-word-policy-configure"></a>

您可以使用 AWS 管理主控台 或 Amazon Bedrock API，為您的護欄設定單字政策。

------
#### [ Console ]

1.  AWS 管理主控台 使用具有使用 Amazon Bedrock 主控台之許可的 IAM 身分登入 。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。

1. 從左側導覽窗格中，選擇**防護機制**，然後選擇**建立防護機制**。

1. 在**提供防護機制詳細資訊**頁面中，執行下列動作：

   1. 在**防護機制詳細資訊**區段中，提供防護機制的**名稱**和選用的**描述**。

   1. 在**封鎖提示的訊息**中，輸入套用防護機制時顯示的訊息。選取**為回應套用相同的封鎖訊息**核取方塊，以在將防護機制套用至回應時，使用相同的訊息。

   1. (選用) 若要為您的防護機制啟用[跨區域推論](guardrails-cross-region.md)，請展開**跨區域推論**，然後選取**為您的防護機制啟用跨區域推論**。選擇護欄設定檔，定義可路由護欄推論請求 AWS 區域 的目的地。

   1. （選用） 根據預設，您的護欄會使用 加密 AWS 受管金鑰。若要使用您自己的客戶受管 KMS 金鑰，請展開 **KMS 金鑰選取範圍**，然後選取**自訂加密設定 (進階)** 核取方塊。

      您可以選取現有的 AWS KMS 金鑰，或選取**建立金鑰以建立新的 AWS KMS 金鑰**。

   1. (選用) 若要將標籤新增至防護機制，請展開**標籤**，然後為您定義的每個標籤選取**新增標籤**。

      如需詳細資訊，請參閱[標記 Amazon Bedrock 資源](tagging.md)。

   1. 選擇**下一步**。

1. 在**新增單字篩選條件**頁面上，執行下列動作：

   1. 選取**篩選褻瀆性**以封鎖提示和回應中的褻瀆性。褻瀆清單是以傳統的定義為基礎，並持續更新。

   1. 對於**新增自訂單字和片語**，選取針對您的防護機制要封鎖的新增單字和片語。如果您上傳單字檔案，檔案中的每一行都應包含一個單字或最多三個單字的片語。請勿包含標頭。您有下列選項：  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/guardrails-word-filters.html)

   1. 在**檢視和編輯單字和片語**區段中，編輯要封鎖的防護機制單字和片語。您有下列選項：
      + 如果您從本機檔案或 Amazon S3 物件上傳單字清單，則此區段將填入您的單字清單。若要篩選具有錯誤的項目，請選取**顯示錯誤**。
      + 若要將項目新增至單字清單，請選取**新增單字或片語**。在方塊中輸入最多三個單字的單字或片語，然後按 **Enter** 或選取核取記號圖示以確認項目。
      + 若要編輯項目，請選取項目旁的編輯圖示 (![\[Edit icon represented by a pencil symbol.\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/edit.png))。
      + 若要從文字清單中刪除項目，請選取垃圾桶圖示 (![\[Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family.\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/trash.png))，或者，如果您要編輯項目，請選取項目旁的刪除圖示 (![\[Close or cancel icon represented by an "X" symbol.\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/close.png))。
      + 若要刪除有錯誤的項目，請選取**全部刪除**，然後選取**刪除發生錯誤的所有資料列**。
      + 若要刪除所有項目，請選取**全部刪除**，然後選取**刪除所有資料列**。
      + 若要搜尋項目，請在搜尋列中輸入運算式。
      + 若要僅顯示有錯誤的項目，請選取標記為**顯示全部**的下拉式功能表，然後選取**僅顯示錯誤**。
      + 若要設定資料表中每個頁面的大小或資料表中的資料欄顯示，請選取設定圖示 (![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/settings.png))。設定您的偏好設定，然後選取**確認**。
      + 根據預設，此區段會顯示**資料表**編輯器。若要切換到文字編輯器，您可以在其中在每個行中輸入單字或片語，請選取**文字編輯器**。**文字編輯器**提供下列功能：
        + 您可以從另一個文字編輯器複製單字清單，並將其貼到此編輯器中。
        + 包含錯誤的項目旁會出現紅色 X 圖示，且編輯器下方會出現錯誤清單。

   1. 選擇**下一步**以視需要設定其他政策，或**跳至檢閱並建立**以完成建立防護機制。

   1. 檢閱防護機制的設定。

      1. 在您要進行變更的任何區段中選取**編輯**。

      1. 設定政策完成後，請選取**建立**以建立防護機制。

------
#### [ API ]

若要使用單字政策建立防護機制，請傳送 [CreateGuardrail](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_CreateGuardrail.html) 請求。請求格式如下：

```
POST /guardrails HTTP/1.1
Content-type: application/json

{
    "blockedInputMessaging": "string",
    "blockedOutputsMessaging": "string",
    "wordPolicyConfig": {
        "managedWordListsConfig": [
            {
                "inputAction": "BLOCK | NONE",
                "inputEnabled": true,
                "outputAction": "BLOCK | NONE",
                "outputEnabled": true,
                "type": "PROFANITY"
            },
        ],
        "wordsConfig": [{
            "text": "string",
            "inputAction": "BLOCK | NONE",
            "inputEnabled": true,
            "outputAction": "BLOCK | NONE",
            "outputEnabled": true
        }]
    },
    "description": "string",
    "kmsKeyId": "string",
    "name": "string",
    "tags": [{
        "key": "string",
        "value": "string"
    }],
    "crossRegionConfig": {
        "guardrailProfileIdentifier": "string"
    }
}
```
+ 為防護機制指定 `name` 和 `description`。
+ 指定當防護機制成功封鎖 `blockedInputMessaging` 和 `blockedOutputsMessaging` 欄位中的提示或模型回應時的訊息。
+ 在 `wordPolicyConfig` 物件中設定單字政策：
  + 使用 `managedWordListsConfig` 來設定預先定義的褻瀆單字清單。
  + 使用 `wordsConfig` 陣列來指定要篩選的自訂單字和片語：
    + 在 `text` 欄位中指定要篩選的單字和片語。
    + (選用) 指定在提示中使用 `inputAction` 或在回應中使用 `outputAction` 偵測到單字時所要採取的動作。選擇 `BLOCK` 以封鎖內容並取代為封鎖的訊息，或選擇 `NONE` 以不採取任何動作，但傳回偵測資訊。
    + (選用) 使用 `inputEnabled` 和 `outputEnabled` 來控制是否針對輸入和輸出啟用防護機制評估。
+ (選用) 將任何標籤連接到防護機制。如需詳細資訊，請參閱[標記 Amazon Bedrock 資源](tagging.md)。
+ (選用) 為了安全起見，請在 `kmsKeyId` 欄位中包含 KMS 金鑰的 ARN。
+ (選用) 若要啟用[跨區域推論](guardrails-cross-region.md)，請在 `crossRegionConfig` 物件中指定防護機制設定檔。

回應格式如下：

```
HTTP/1.1 202
Content-type: application/json

{
    "createdAt": "string",
    "guardrailArn": "string",
    "guardrailId": "string",
    "version": "string"
}
```

------