建立護欄

您可以透過設定組態、定義要拒絕的主題、提供處理有害和敏感內容的篩選器，以及在封鎖提示和使用者回應時撰寫訊息來建立護欄。

當提示和使用者回應遭到封鎖時，護欄必須至少包含一個篩選器和訊息。您可以選擇使用默認消息傳遞。您可以按照〈〉中的步驟設定護欄所需的所有元件，以新增篩選器並在編輯護欄稍後重複執行護欄。

選擇與您選擇的方法相對應的選項卡，然後按照步驟操作。

Console

建立護欄的步驟

登錄到 AWS Management Console，然後打開 Amazon 基岩控制台 https://console.aws.amazon.com/bedrock/。
在左側導覽窗格中，選擇「護欄」。
在「護欄」區段中，選擇「建立護欄」。
在 [提供護欄詳細資料] 頁面上，執行下列動作：
1. 在「護欄詳細資訊」區段中，提供護欄的「名稱」和選擇性「描述」。
2. (選擇性) 依預設，您的護欄會使用. AWS 受管金鑰若要使用您自己的客戶管理 KMS 金鑰，請選取 KMS 金鑰選取旁邊的向右箭頭，然後選取 [自訂加密設定 (進階)] 核取方塊。您可以選擇現有的 AWS KMS 金鑰，也可以選取「建立 AWS KMS 金鑰」來建立新的金鑰。
3. (可選) 若要將標籤加入護欄，請選取「標籤」旁邊的向右箭頭。然後，選擇「新增標籤」並為標籤定義索引鍵值配對。如需詳細資訊，請參閱標籤資源。
4. 選擇下一步。
注意
您必須至少規劃一個篩選才能建立護欄。然後，您可以選擇 [略過檢閱] 並建立以略過建立其他篩選器。
(選擇性) 在 [設定內容篩選器] 頁面上，執行下列動作，設定您要過濾掉與中定義之類別相關內容過濾器之內容的強度：
1. 若要為模型的提示規劃篩選，請在「模型提示的篩選強度」區段中選取「為提示啟用篩選條件」。針對使用者提供給模型的提示，設定您希望每個篩選器的嚴格程度。
2. 若要設定模型回應的篩選器，請在回應的篩選強度中選取啟用回應的篩選器。針對模型傳回的回應，設定您希望每個篩選器的嚴格程度。
3. 選擇下一步。
(選擇性) 在 [新增拒絕的主題] 頁面上，執行下列動作：
1. 若要定義要封鎖的主題，請選擇 [新增拒絕的主題]。然後執行下列動作：
  1. 輸入新主題的名稱 (Name)。
  2. 在主題的定義方塊中，定義主題。如需如何定義拒絕主題的指導方針，請參閱拒絕的主題。
  3. (選擇性) 若要新增與此主題相關的代表性輸入提示或模型回應，請選取 [新增範例片語] 旁邊的向右箭頭。在方塊中輸入片語。若要新增其他片語，請選擇 [新增片語]。
  4. 當您完成設定拒絕的主題時，請選擇 [確認]。
2. 您可以對「拒絕」主題執行下列動作。
  - 若要新增其他主題，請選擇 [新增拒絕主題]。
  - 若要編輯主題，請選擇與「動作」 欄中主題相同列中的三個點圖示。然後選擇 Edit (編輯)。完成編輯後，選擇 [確認]。
  - 若要刪除一個或多個主題，請選取要刪除之主題的核取方塊。選擇刪除，然後選擇刪除所選項。
  - 若要刪除所有主題，請選擇 [刪除]，然後選取 [全部刪除]。
  - 若要設定表格中每個頁面的大小或表格中顯示的欄，請選擇設定圖示 ( )。設定偏好設定，然後選擇「確認」。
3. 當您完成設定拒絕的主題時，請選取 [下一步]。

(選擇性) 在 [新增單字篩選] 頁面上，執行下列動作：

在「過濾褻瀆」區段中，選取「過濾褻瀆用語」以封鎖提示和回應中的不雅用語。褻瀆的清單以傳統定義為基礎，並會不斷更新。

在「新增自訂字詞和片語」區段中，選取如何新增要封鎖護欄的單字和片語。如果您選擇上傳檔案，檔案中的每一行都應包含一個字詞或一個最多三個字詞的片語。不要包含標頭。您有下列選項：

選項	指示
手動新增單字和片語	直接在「檢視和編輯字詞和片語」區段中新增單字和片語。
從本機檔案上傳	若要上傳包含文字和片語的 .txt 或 .csv 檔案，請在選取此選項後選擇「選擇檔案」。
從 Amazon S3 物件上傳	若要從 Amazon S3 上傳檔案，請在選取此選項後指定 S3 物件。文件中的每一行應包含一個單詞或一個最多三個單詞的短語。

您可以在 [檢視和編輯字詞和片語] 區段中編輯要封鎖護欄的字和片語。您有下列選項：
- 如果您從本機檔案或 Amazon S3 物件上傳單字清單，本節會填入您的單字清單。若要篩選有錯誤的項目，請選擇「顯示錯誤」。
- 若要將項目新增至單字清單，請選擇「新增單字或片語」。在方塊中輸入最多三個字的單字或片語，然後按 Enter 或選取核取記號圖示以確認項目。
- 若要編輯項目，請選擇項目旁邊的編輯圖示 ( )。
- 若要從單字清單中刪除項目，請選擇垃圾桶圖示 ( )，或者，如果您正在編輯項目，請選擇項目旁邊的刪除圖示 ( )。
- 若要刪除包含錯誤的項目，請選擇 [全部刪除]，然後選取 [刪除所有有錯誤的列]
- 若要刪除所有項目，請選擇 [全部刪除]，然後選取 [刪除所有列
- 若要搜尋項目，請在搜尋列中輸入表示式。
- 若只要顯示有錯誤的項目，請選擇標示為全部顯示的下拉式選單，然後選取僅顯示錯誤。
- 若要設定表格中每個頁面的大小或表格中顯示的欄，請選擇設定圖示 ( )。設定偏好設定，然後選擇「確認」。
- 依預設，此區段會顯示「表格編輯器」。若要切換至可以在每一行中輸入單字或片語的文字編輯器，請選取「文字編輯器」。文字編輯器提供下列功能：
  - 您可以從其他文字編輯器複製單字清單，然後將其貼到此編輯器中。
  - 包含錯誤的項目旁邊會出現一個紅色的 X 圖示，編輯器下方會顯示錯誤清單。

(選擇性) 在 [新增敏感資訊篩選器] 頁面上，設定篩選器以封鎖或遮罩敏感資訊。如需詳細資訊，請參閱敏感資訊篩選器。請執行下列操作：

在 PII 類型區段中，設定要封鎖或遮罩的個人識別資訊 (PII) 類別。您有下列選項：
- 若要新增 PII 類型，請選擇 [新增 PII 類型]。然後，執行下列動作：
  1. 在「類型」欄中，選取 PII 類型。
  2. 在「護欄行為」欄中，選取護欄是否應封鎖包含 PII 類型的內容，還是使用識別碼遮罩它。
- 若要新增所有 PII 類型，請選擇 [新增 PII 類型] 旁邊的下拉式箭頭。然後選取要套用到護欄的護欄行為。
  
  警告
  如果您指定行為，您為 PII 類型設定的任何現有行為都會遭到覆寫。
- 若要刪除 PII 類型，請選擇垃圾桶圖示 ( )。
- 若要刪除包含錯誤的資料列，請選擇 [全部刪除]，然後選取 [刪除所有發生錯誤的
- 若要刪除所有 PII 類型，請選擇「全部刪除」，然後選取「刪除所有列」
- 若要搜尋列，請在搜尋列中輸入表示式。
- 若只要顯示有錯誤的列，請選擇標示為全部顯示的下拉式選單，然後選取僅顯示錯誤。
- 若要設定表格中每個頁面的大小或表格中顯示的欄，請選擇設定圖示 ( )。設定偏好設定，然後選擇「確認」。

在 [Re gex 模式] 區段中，使用規則運算式定義要篩選的護欄模式。您有下列選項：

要添加模式，請選擇添加正則表達式模式。設定下列欄位：

欄位	描述
名稱	模式的名稱
正則表達式	定義模式的正則表達式
護欄行為	選擇要封鎖包含圖樣的內容，還是使用識別碼遮罩它。如果只要遮罩記錄檔中的病毒碼，請選擇「無」。
添加描述	(選擇性) 撰寫樣式的描述

若要編輯模式，請選擇與「動作」 欄中主題相同列中的三個點圖示。然後選擇 Edit (編輯)。完成編輯後，選擇 [確認]。
要刪除一個或多個圖樣，請選擇要刪除的圖樣的核取方塊。選擇刪除，然後選擇刪除所選項。
若要刪除所有圖樣，請選擇「刪除」，然後選取「全部刪除」。
若要搜尋樣式，請在搜尋列中輸入表示式。
若要設定表格中每個頁面的大小或表格中顯示的欄，請選擇設定圖示 ( )。設定偏好設定，然後選擇「確認」。

完成設定機密資訊篩選器後，請選擇 [下一步]。

在 [定義封鎖的郵件] 頁面上，設定當護欄偵測到並封鎖內容時要傳回給使用者的訊息。請執行下列操作：
1. 在 [封鎖的訊息] 區段的 [針對封鎖提示顯示的訊息] 欄位中，輸入護欄封鎖傳送至模型的提示時要顯示的訊息。
2. 在 [封鎖的訊息] 區段的 [針對封鎖的回應顯示的訊息] 欄位中，輸入護欄封鎖模型所產生的回應時要顯示的訊息。
3. 選擇下一步。
檢閱並建立 — 檢閱護欄的設定。
1. 在任何您要變更的區段中選擇 「編輯」。
2. 如果您滿意護欄的設定，請選取「建立」以建立護欄。

API

若要建立護欄，請傳送請求。CreateGuardrail請求格式如下：


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

{
   "blockedInputMessaging": "string",
   "blockedOutputsMessaging": "string",
   "contentPolicyConfig": { 
      "filtersConfig": [ 
         { 
            "inputStrength": "NONE | LOW | MEDIUM | HIGH",
            "outputStrength": "NONE | LOW | MEDIUM | HIGH",
            "type": "SEXUAL | VIOLENCE | HATE | INSULTS | MISCONDUCT | PROMPT_ATTACK"
         }
      ]
   },
    "wordPolicyConfig": {
    "wordsConfig": [
      {
        "text": "string"
      }
    ],
    "managedWordListsConfig": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicyConfig": {
    "piiEntitiesConfig": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexesConfig": [
      {
        "name": "string",
        "description": "string",
        "regex": "string",
        "action": "string"
      }
    ]
  },
   "description": "string",
   "kmsKeyId": "string",
   "name": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "topicPolicyConfig": { 
      "topicsConfig": [ 
         { 
            "definition": "string",
            "examples": [ "string" ],
            "name": "string",
            "type": "DENY"
         }
      ]
   }
}

指定name護欄description的和。
指定護欄在blockedInputMessaging和blockedOutputsMessaging欄位中成功封鎖提示或模型回應時的訊息。
指定要在物件中拒絕的護欄的主題。topicPolicytopics清單中的每個項目都與一個主題有關。如需有關主題中欄位的詳細資訊，請參閱主題。
- 給一個name和，以description便護欄可以正確識別主題。
- 在action欄位DENY中指定。
- (選擇性) 提供最多五個範例，您可以將這些範例歸類為屬於examples清單中的主題。
為對象中 Amazon 基岩中定義的有害類別指定過濾器強度。contentPolicyfilters清單中的每個項目都屬於有害類別。如需詳細資訊，請參閱內容過濾器。如需內容篩選器中欄位的詳細資訊，請參閱ContentFilter。
- 在欄位中指定類type別。
- 指定欄位欄位中提示的篩選器強度，以及的strengthtextToTextFiltersForPrompt欄位中的模型回應的強度textToTextFiltersForResponse。strength
(可選) 將任何標籤貼附至護欄。如需詳細資訊，請參閱標籤資源。
(選擇性) 基於安全性考量，請在kmsKeyId欄位中包含 KMS 金鑰的 ARN。

響應格式如下：


HTTP/1.1 202
Content-type: application/json

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

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

必要條件

測試護欄

建立護欄

建立護欄的步驟

注意

警告