ガードレールの管理 - Amazon Bedrock
ガードレールに関する情報を表示するガードレールを編集するガードレールを削除する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ガードレールの管理

既存のガードレールを変更して、新しい設定ポリシーを追加したり、既存のポリシーを編集したりできます。満足したガードレールの設定に達したら、モデルまたはエージェントで使用するガードレールの静的バージョンを作成できます。詳細については、「ガードレールをデプロイする」を参照してください。

ガードレールに関する情報を表示する

Console
ガードレールに関する情報を表示するには

  1. Amazon Bedrock のアクセス許可を持つ IAM ロール AWS Management Console を使用して にサインインし、https://console.aws.amazon.com/bedrock/ で Amazon Bedrock コンソールを開きます。 Amazon Bedrock の開始方法

  2. 左側のナビゲーションペインからガードレールを選択します。次に、ガードレールセクションでガードレールを選択します。

  3. ガードレールの概要セクションには、すべてのバージョンに適用されるガードレールの設定が表示されます。

  4. 作業中のドラフトに関する詳細を表示するには、作業中のドラフトセクションで作業中のドラフトを選択します。

  5. ガードレールの特定のバージョンに関する詳細を表示するには、「バージョン」セクションからバージョンを選択します。

ドラフトとガードレールの実際のバージョンの詳細については、「」を参照してくださいガードレールをデプロイする。

API

ガードレールに関する情報を取得するには、GetGuardrailリクエストを送信し、ガードレールの ID とバージョンを含めます。バージョンを指定しない場合、レスポンスはDRAFTバージョンの詳細を返します。

リクエスト形式は次のとおりです。

GET /guardrails/guardrailIdentifier?guardrailVersion=guardrailVersion HTTP/1.1

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

HTTP/1.1 200
Content-type: application/json

{
  "topicPolicy": {
    "topics": [
      {
        "definition": "string",
        "examples": [
          "string"
        ],
        "name": "string",
        "type": "DENY"
      }
    ]
  },
  "contentPolicy": {
    "filters": [
      {
        "type": "string",
        "inputStrength": "string",
        "outputStrength": "string"
      }
    ]
  },
  "wordPolicy": {
    "words": [
      {
        "text": "string"
      }
    ],
    "managedWordLists": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicy": {
    "piiEntities": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexes": [
      {
        "name": "string",
        "description": "string",
        "regex": "string",
        "action": "string"
      }
    ]
  },
  "contextualGroundingPolicy": {
    "groundingFilter": {
      "threshold": float
    },
    "relevanceFilter": {
      "threshold": float
    }
  },
  "createdAt": "string",
  "blockedInputMessaging": "string",
  "blockedOutputsMessaging": "string",
  "description": "string",
  "failureRecommendations": [
    "string"
  ],
  "guardrailArn": "string",
  "guardrailId": "string",
  "kmsKeyArn": "string",
  "name": "string",
  "status": "string",
  "statusReasons": [
    "string"
  ],
  "updatedAt": "string",
  "version": "string"
}

すべてのガードレールに関する情報を一覧表示するには、 ListGuardrailsリクエストを送信します。

リクエスト形式は次のとおりです。

GET /guardrails?guardrailIdentifier=guardrailIdentifier&maxResults=maxResults&nextToken=nextToken HTTP/1.1

  • すべてのガードレールDRAFTのバージョンを一覧表示するには、 guardrailIdentifierフィールドを指定しないでください。

  • ガードレールのすべてのバージョンを一覧表示するには、 guardrailIdentifierフィールドにガードレールの ARN を指定します。

maxResults フィールドのレスポンスで返す結果の最大数を設定できます。設定した数よりも多くの結果がある場合、レスポンスは nextToken を返します。これを別の ListGuardrails リクエストで送信すると、結果の次のバッチを確認できます。

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

HTTP/1.1 200
Content-type: application/json

{
   "guardrails": [ 
      { 
         "arn": "string",
         "createdAt": "string",
         "description": "string",
         "id": "string",
         "name": "string",
         "status": "string",
         "updatedAt": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}

ガードレールを編集する

Console
ガードレールを編集するには

  1. Amazon Bedrock のアクセス許可を持つ IAM ロール AWS Management Console を使用して にサインインし、https://console.aws.amazon.com/bedrock/ で Amazon Bedrock コンソールを開きます。 Amazon Bedrock の開始方法

  2. 左側のナビゲーションペインからガードレールを選択します。次に、ガードレールセクションでガードレールを選択します。

  3. ガードレールの名前、説明、タグ、またはモデル暗号化設定を編集するには、ガードレールの概要セクションで編集を選択します。

  4. ガードレールの特定の設定を編集するには、「ドラフトの作成」セクションの「ドラフトの作成」を選択します。

  5. 変更する設定を含むセクションの編集を選択します。

  6. 必要な編集を行い、保存と終了を選択して編集を実装します。

API

ガードレールを編集するには、 UpdateGuardrail リクエストを送信します。更新するフィールドと、変更せずに状態を維持するフィールドの両方を含めます。

リクエスト形式は次のとおりです。

PUT /guardrails/guardrailIdentifier 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"
         }
      ]
   },
   "description": "string",
   "kmsKeyId": "string",
   "name": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "topicPolicyConfig": { 
      "topicsConfig": [ 
         { 
            "definition": "string",
            "examples": [ "string" ],
            "name": "string",
            "type": "DENY"
         }
      ]
   }
}

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

HTTP/1.1 202
Content-type: application/json

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

ガードレールを削除する

ガードレールを使用する必要がなくなったら、削除できます。潜在的なエラーを避けるため、ガードレールを削除する前に、ガードレールを使用するすべてのリソースまたはアプリケーションの関連付けを解除してください。

Console
ガードレールを削除するには

  1. Amazon Bedrock のアクセス許可を持つ IAM ロール AWS Management Console を使用して にサインインし、https://console.aws.amazon.com/bedrock/ で Amazon Bedrock コンソールを開きます。 Amazon Bedrock の開始方法

  2. 左側のナビゲーションペインからガードレールを選択します。次に、ガードレールセクションでガードレールを選択します。

  3. ガードレールセクションで、削除するガードレールを選択し、「削除」を選択します。

  4. delete ユーザー入力フィールドに を入力し、削除 を選択してガードレールを削除します。

API

ガードレールを削除するには、DeleteGuardrailリクエストを送信し、ガードレールの ARN のみを guardrailIdentifierフィールドに指定します。を指定しない guardrailVersion

リクエスト形式は次のとおりです。

DELETE /guardrails/guardrailIdentifier?guardrailVersion=guardrailVersion HTTP/1.1
警告

ガードレールを削除すると、そのすべてのバージョンが削除されます。

削除が成功すると、レスポンスは HTTP 200 ステータスコードを返します。