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

# API 사용
<a name="guardrails-use-invoke-guardrail-checks-using"></a>

가드레일 검사를 실행하려면 Amazon Bedrock 런타임 엔드포인트에 `InvokeGuardrailChecks` 요청을 보냅니다.

## 요청 형식
<a name="guardrails-use-invoke-guardrail-checks-request"></a>

```
{
  "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` - 필수입니다. 텍스트 콘텐츠 블록이 하나 이상 있는 메시지.
+ `checks` - 필수입니다. 하나 이상의 검사 필드를 설정해야 합니다.

## 응답 형식
<a name="guardrails-use-invoke-guardrail-checks-response"></a>

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

요청한 검사만 `results` 및 아래에 표시됩니다`usage`. 각 `textUnits` 값은 검사가 평가한 텍스트 단위의 수입니다. 텍스트 단위의 정의는 [Amazon Bedrock 요금을](https://aws.amazon.com/bedrock/pricing/) 참조하세요.

## 오류
<a name="guardrails-use-invoke-guardrail-checks-errors"></a>

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


**InvokeGuardrailChecks API 오류**  

| HTTP 코드 | 오류 | 원인 | 
| --- | --- | --- | 
| 400 | ValidationException | 요청의 형식이 잘못되었거나 필수 필드가 누락되었거나 제약 조건을 위반했습니다. | 
| 403 | AccessDeniedException | 호출자는 API를 호출할 권한이 없습니다. | 
| 429 | ThrottlingException | 요청 속도가 계정의 할당량을 초과했습니다. 지수 백오프를 사용하여 재시도합니다. | 
| 500 | InternalServerException | 서비스에 예기치 못한 오류가 발생했습니다. 요청을 다시 시도하세요. | 
| 503 | ServiceUnavailableException | 서비스를 일시적으로 사용할 수 없습니다. 지수 백오프를 사용하여 재시도합니다. |