Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Untuk menjalankan pemeriksaan pagar pembatas, kirim `InvokeGuardrailChecks` permintaan ke titik akhir runtime Amazon Bedrock.

## Format permintaan
<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` – Wajib. Setidaknya satu pesan dengan satu blok konten teks.
+ `checks` – Wajib. Setidaknya satu bidang pemeriksaan harus ditetapkan.

## Format respons
<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 }
  }
}
```

Hanya cek yang Anda minta yang muncul di bawah `results` dan`usage`. Setiap `textUnits` nilai adalah jumlah unit teks yang diperiksa yang dievaluasi. Untuk definisi unit teks, lihat [harga Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).

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

Tabel berikut mencantumkan kesalahan yang dapat dikembalikan oleh `InvokeGuardrailChecks` API.


**InvokeGuardrailChecks Kesalahan API**  

| Kode HTTP | Kesalahan | Penyebab | 
| --- | --- | --- | 
| 400 | ValidationException | Permintaan salah bentuk, tidak memiliki bidang wajib, atau melanggar batasan. | 
| 403 | AccessDeniedException | Penelepon tidak diizinkan untuk menjalankan API. | 
| 429 | ThrottlingException | Tingkat permintaan melebihi kuota akun. Coba lagi dengan backoff eksponensial. | 
| 500 | InternalServerException | Layanan mengalami kesalahan yang tidak terduga. Coba lagi permintaannya. | 
| 503 | ServiceUnavailableException | Layanan untuk sementara tidak tersedia. Coba lagi dengan backoff eksponensial. |