View a markdown version of this page

API を使用する場合 - Amazon Bedrock
リクエストの形式レスポンスの形式エラー

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

API を使用する場合

ガードレールチェックを実行するには、Amazon Bedrock ランタイムエンドポイントにInvokeGuardrailChecksリクエストを送信します。

リクエストの形式

{
  "messages": [
    {
      "role": "user",
      "content": [{ "text": "string" }]
    }
  ],
  "checks": {
    "contentFilter": {
      "categories": [
        { "category": "VIOLENCE | HATE | SEXUAL | INSULTS | MISCONDUCT" }
      ]
    },
    "promptAttack": {
      "categories": [
        { "category": "JAILBREAK | PROMPT_INJECTION | PROMPT_LEAKAGE" }
      ]
    },
    "sensitiveInformation": {
      "entities": [
        { "type": "EMAIL | PHONE | US_SOCIAL_SECURITY_NUMBER | ..." }
      ]
    }
  }
}

  • messages – 必須。少なくとも 1 つのメッセージと 1 つのテキストコンテンツブロック。

  • checks – 必須。少なくとも 1 つのチェックフィールドを設定する必要があります。

レスポンスの形式

{
  "results": {
    "contentFilter":        { "results": [ ... ] },
    "promptAttack":         { "results": [ ... ] },
    "sensitiveInformation": { "results": [ ... ], "truncated": false }
  },
  "usage": {
    "contentFilter":        { "textUnits": 0 },
    "promptAttack":         { "textUnits": 0 },
    "sensitiveInformation": { "textUnits": 0 }
  }
}

リクエストしたチェックのみが resultsと の下に表示されますusage。各textUnits値は、チェックで評価されたテキスト単位の数です。テキスト単位の定義については、「Amazon Bedrock の料金」を参照してください。

エラー

次の表に、InvokeGuardrailChecksAPI が返すことができるエラーを示します。

InvokeGuardrailChecks API エラー
HTTP コード エラー 原因
400 ValidationException リクエストの形式が正しくないか、必須フィールドがないか、制約に違反しています。
403 AccessDeniedException 呼び出し元には API を呼び出す権限がありません。
429 ThrottlingException リクエストレートがアカウントのクォータを超えました。エクスポネンシャルバックオフで再試行します。
500 InternalServerException サービス中に予期しないエラーが発生しました。リクエストを再試行します。
503 ServiceUnavailableException サービスが一時的に使用できません エクスポネンシャルバックオフで再試行します。