ガードレールを作成する

ガードレールを作成するには、設定をセットアップし、拒否するトピックを定義し、有害で機密性の高いコンテンツを処理するフィルターを提供し、プロンプトとユーザーレスポンスがブロックされたときにメッセージを書き込みます。

ガードレールには、プロンプトとユーザーレスポンスがブロックされたときのフィルターとメッセージングが少なくとも 1 つ含まれている必要があります。デフォルトのメッセージングを使用することを選択できます。後での手順に従ってガードレールに必要なすべてのコンポーネントを設定することでガードレールの編集、フィルターを追加し、ガードレールを反復処理できます。

選択した方法に対応するタブを選択し、ステップに従います。

Console

ガードレールを作成するには

にサインインし AWS Management Console、https://console.aws.amazon.com/bedrock/ で Amazon Bedrock コンソールを開きます。
左側のナビゲーションペインから、ガードレール を選択します。
ガードレール セクションで、ガードレールの作成 を選択します。
ガードレールの詳細を提供するページで、次の操作を行います。
1. ガードレールの詳細セクションで、ガードレールの名前とオプションの説明を指定します。
2. （オプション) デフォルトでは、ガードレールはで暗号化されます AWS マネージドキー。独自のカスタマーマネージド KMS キーを使用するには、KMS キー選択の横にある右矢印を選択し、暗号化設定のカスタマイズ (アドバンスト） チェックボックスを選択します。既存の AWS KMS キーを選択するか、キーの作成を選択して新しい AWS KMS キーを作成できます。
3. （オプション) ガードレールにタグを追加するには、タグの横にある右矢印を選択します。次に、新しいタグを追加を選択し、タグのキーと値のペアを定義します。詳細については、「リソースのタグ付け」を参照してください。
4. [Next] (次へ) を選択します。
注記
ガードレールを作成するには、少なくとも 1 つのフィルターを設定する必要があります。その後、「レビューと作成へスキップ」を選択して、他のフィルターの作成をスキップできます。
（オプション) コンテンツフィルターの設定 ページで、コンテンツフィルターで定義されているカテゴリに関連するコンテンツをどの程度絞り込むかを設定するには、次の手順を実行します。
1. モデルへのプロンプトのフィルターを設定するには、「モデルプロンプトの強度のフィルター」セクションの「プロンプトのフィルターを有効にする」を選択します。ユーザーがモデルに提供するプロンプトの各フィルターの厳密さを設定します。
2. モデルレスポンスのフィルターを設定するには、「レスポンスの強度をフィルタリングする」の「レスポンスのフィルターを有効にする」を選択します。モデルが返すレスポンスに対して各フィルターをどの程度厳密にするかを設定します。
3. [次へ] をクリックします。
（オプション) 「拒否されたトピックの追加」ページで、次の操作を行います。
1. ブロックするトピックを定義するには、「拒否されたトピックを追加」を選択します。次に、以下の操作を実行します。
  1. トピックの名前を入力します。
  2. トピックの定義ボックスで、トピックを定義します。拒否されたトピックを定義する方法のガイドラインについては、「」を参照してください拒否されたトピック。
  3. （オプション) このトピックに関連する代表的な入力プロンプトまたはモデルレスポンスを追加するには、「サンプルフレーズを追加」の横にある右矢印を選択します。ボックスにフレーズを入力します。別のフレーズを追加するには、フレーズを追加 を選択します。
  4. 拒否されたトピックの設定が完了したら、確認を選択します。
2. 拒否されたトピック を使用して、次のアクションを実行できます。
  - 別のトピックを追加するには、「拒否されたトピックを追加」を選択します。
  - トピックを編集するには、アクション列のトピックと同じ行にある 3 つのドットアイコンを選択します。次に、[編集] を選択します。編集が完了したら、確認を選択します。
  - トピックを削除するには、削除するトピックのチェックボックスをオンにします。削除を選択し、選択したを削除 を選択します。
  - すべてのトピックを削除するには、削除を選択し、すべての を削除を選択します。
  - テーブル内の各ページのサイズまたはテーブル内の列表示を設定するには、設定アイコン () を選択します。設定を行い、確認を選択します。
3. 拒否されたトピックの設定が完了したら、次へを選択します。

（オプション) 単語フィルターの追加ページで、次の操作を行います。

「冒涜的な表現のフィルタリング」セクションで、「冒涜的な表現のフィルタリング」を選択して、プロンプトとレスポンスの冒涜的な表現をブロックします。冒涜的な言葉のリストは従来の定義に基づいており、継続的に更新されます。

「カスタム語句の追加」セクションで、ブロックするガードレールの語句を追加する方法を選択します。ファイルをアップロードする場合、ファイル内の各行には 1 つの単語または最大 3 つの単語のフレーズを含める必要があります。ヘッダーを含めないでください。次のオプションがあります。

オプション	手順
単語とフレーズを手動で追加する	「単語とフレーズの表示と編集」セクションに単語とフレーズを直接追加します。
ローカルファイルからのアップロード	単語とフレーズを含む .txt ファイルまたは .csv ファイルをアップロードするには、このオプションを選択した後、ファイルを選択を選択します。
Amazon S3 オブジェクトからのアップロード	Amazon S3 からファイルをアップロードするには、このオプションを選択してから S3 オブジェクトを指定します。ファイル内の各行には、1 つの単語または最大 3 つの単語のフレーズを含める必要があります。

ガードレールの単語とフレーズを編集して、単語とフレーズの表示と編集セクションでブロックします。次のオプションがあります。
- ローカルファイルまたは Amazon S3 オブジェクトから単語リストをアップロードした場合、このセクションには単語リストが入力されます。エラーのある項目をフィルタリングするには、エラーを表示 を選択します。
- 単語リストに項目を追加するには、単語またはフレーズを追加 を選択します。ボックス内に単語または最大 3 つの単語のフレーズを入力し、Enter キーを押すか、チェックマークアイコンを選択して項目を確認します。
- 項目を編集するには、項目の横にある編集アイコン ( ) を選択します。
- 単語リストから項目を削除するには、ごみ箱アイコン ( ) を選択するか、項目を編集する場合は項目の横にある削除アイコン ( ) を選択します。
- エラーを含む項目を削除するには、すべて削除を選択し、エラーのあるすべての行を削除を選択します。
- すべての項目を削除するには、すべて削除を選択し、すべての行を削除を選択します。
- 項目を検索するには、検索バーに式を入力します。
- エラーのある項目のみを表示するには、すべて表示 というラベルのドロップダウンメニューを選択し、エラーのみ表示 を選択します。
- テーブル内の各ページのサイズまたはテーブル内の列表示を設定するには、設定アイコン () を選択します。設定を行い、確認を選択します。
- デフォルトでは、このセクションにはテーブルエディタが表示されます。各行に単語またはフレーズを入力できるテキストエディタに切り替えるには、テキストエディタ を選択します。テキストエディタには次の機能があります。
  - 別のテキストエディタから単語リストをコピーして、このエディタに貼り付けることができます。
  - エラーを含む項目の横に赤い X アイコンが表示され、エディタの下にあるエラーのリストが表示されます。

（オプション) 「機密情報フィルターの追加」ページで、機密情報をブロックまたはマスクするようにフィルターを設定します。詳細については、「機密情報フィルター」を参照してください。以下の操作を実行します。

「PII タイプ」セクションで、個人を特定できる情報 (PII) カテゴリをブロックまたはマスクするように設定します。次のオプションがあります。
- PII タイプを追加するには、「PII タイプを追加」を選択します。次に、以下の操作を実行します。
  1. タイプ 列で、PII タイプを選択します。
  2. ガードレールの動作列で、ガードレールが PII タイプを含むコンテンツをブロックするか、識別子でマスクするかを選択します。
- すべての PII タイプを追加するには、PII タイプを追加 の横にあるドロップダウン矢印を選択します。次に、ガードレールの動作を選択して適用します。
  
  警告
  動作を指定すると、PII タイプ用に設定した既存の動作は上書きされます。
- PII タイプを削除するには、ごみ箱アイコン () を選択します。
- エラーを含む行を削除するには、すべて削除を選択し、エラーのあるすべての行を削除を選択します。
- すべての PII タイプを削除するには、すべて削除を選択し、すべての行を削除を選択します。
- 行を検索するには、検索バーに式を入力します。
- エラーのある行のみを表示するには、「すべて表示」というラベルのドロップダウンメニューを選択し、「エラーのみを表示」を選択します。
- テーブル内の各ページのサイズまたはテーブル内の列表示を設定するには、設定アイコン () を選択します。設定を行い、確認を選択します。

正規表現パターンセクションで、正規表現を使用して、フィルタリングするガードレールのパターンを定義します。次のオプションがあります。

パターンを追加するには、正規表現パターンの追加 を選択します。次のフィールドを設定します。

フィールド	説明
[Name] (名前)	パターンの名前
正規表現パターン	パターンを定義する正規表現
ガードレールの動作	パターンを含むコンテンツをブロックするか、識別子でマスクするかを選択します。ログでのみパターンをマスクするには、なしを選択します。
説明を追加する	（オプション) パターンの説明を記述する

パターンを編集するには、アクション列のトピックと同じ行にある 3 つのドットアイコンを選択します。次に、[編集] を選択します。編集が完了したら、確認を選択します。
パターンを削除するには、削除するパターンのチェックボックスをオンにします。「削除」を選択し、「選択したを削除」を選択します。
すべてのパターンを削除するには、削除を選択し、すべての を削除を選択します。
パターンを検索するには、検索バーに式を入力します。
テーブル内の各ページのサイズまたはテーブル内の列表示を設定するには、設定アイコン () を選択します。設定を行い、確認を選択します。

機密情報フィルターの設定が完了したら、次へを選択します。

ブロックされたメッセージングの定義ページで、ガードレールがコンテンツを検出してブロックしたときにユーザーに返すメッセージを設定します。以下の操作を実行します。
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フィールドに指定します。
topicPolicy オブジェクトで拒否するガードレールのトピックを指定します。topics リスト内の各項目は 1 つのトピックに関連しています。トピック内のフィールドの詳細については、「トピックhttps://docs.aws.amazon.com/bedrock/latest/APIReference/API_Topic.html」を参照してください。
- ガードレールがトピックを適切に識別descriptionできるように、 nameとを渡します。
- action フィールドに DENYを指定します。
- （オプション) examplesリスト内のトピックに属するものとして分類する例を最大 5 つ指定します。
contentPolicy オブジェクトの Amazon Bedrock で定義されている有害なカテゴリのフィルター強度を指定します。filters リスト内の各項目は有害なカテゴリに関連しています。詳細については、「コンテンツフィルター」を参照してください。コンテンツフィルターのフィールドの詳細については、「」を参照してくださいContentFilter。
- type フィールドにカテゴリを指定します。
- フィールドの strengthフィールドのプロンプトとの textToTextFiltersForPromptフィールドのモデルレスポンスのフィルターstrengthの強度を指定しますtextToTextFiltersForResponse。
（オプション) ガードレールにタグをアタッチします。詳細については、「リソースのタグ付け」を参照してください。
（オプション) セキュリティのため、 kmsKeyIdフィールドに KMS キーの ARN を含めます。

レスポンスの形式は次のとおりです。


HTTP/1.1 202
Content-type: application/json

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

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

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

ドキュメントの表記規則

前提条件

ガードレールのテスト

ガードレールを作成する

ガードレールを作成するには

注記

警告