기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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 | ..." }
      ]
    }
  }
}

응답 형식

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

요청한 검사만 results 및 아래에 표시됩니다usage. 각 textUnits 값은 검사가 평가한 텍스트 단위의 수입니다. 텍스트 단위의 정의는 Amazon Bedrock 요금을 참조하세요.

오류

다음 표에는 InvokeGuardrailChecks API가 반환할 수 있는 오류가 나열되어 있습니다.