View a markdown version of this page

Menggunakan API - Amazon Bedrock

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

Menggunakan API

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

Format permintaan

{ "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

{ "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 danusage. Setiap textUnits nilai adalah jumlah unit teks yang diperiksa yang dievaluasi. Untuk definisi unit teks, lihat harga Amazon Bedrock.

Kesalahan

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.