

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

# Gunakan InvokeGuardrailChecks API di aplikasi Anda
<a name="guardrails-use-invoke-guardrail-checks"></a>

Dengan [InvokeGuardrailChecks](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeGuardrailChecks.html)API, Anda dapat mengevaluasi permintaan pengguna dan respons model dengan perlindungan khusus seperti filter konten, deteksi serangan cepat, dan filter informasi sensitif kapan pun dalam aplikasi Anda tanpa membuat sumber daya pagar pembatas individual. Anda dapat menggunakan API ini di berbagai aplikasi termasuk alur kerja AI agen yang melibatkan percakapan multi-putaran di mana evaluasi konten diperlukan untuk setiap giliran. API hanya terdeteksi: ia mendeteksi konten yang tidak diinginkan dan mengembalikan skor numerik untuk setiap pemeriksaan keamanan sehingga Anda dapat menentukan ambang batas dan mengambil tindakan yang diperlukan dalam logika aplikasi Anda. Dengan skor ini, Anda dapat membangun logika respons adaptif seperti blok, bypass, coba lagi, atau rute untuk tinjauan manusia berdasarkan ambang batas khusus dan persyaratan aplikasi Anda.

Fitur `InvokeGuardrailChecks` API:
+ **Fleksibilitas** — Anda dapat menjalankan pemeriksaan keamanan apa pun dengan `InvokeGuardrailChecks` API dan mengintegrasikannya di mana saja di aplikasi Anda. Anda dapat memanggil API dengan pemeriksaan keamanan apa pun sebelum mengirim prompt ke LLM, setelah menerima respons dari LLM, sebelum menjalankan alat yang ingin dipanggil model, setelah alat mengembalikan hasil, atau pada titik lain mana pun Anda ingin mengevaluasi konten. Misalnya, Anda mungkin menyertakan deteksi serangan cepat untuk prompt input bersama dengan moderasi konten dengan filter konten, tetapi periksa kebocoran informasi sensitif seperti konten PII dengan respons model.
+ **Tidak ada persyaratan untuk membuat sumber daya di muka** - Anda tidak perlu membuat sumber daya pagar pembatas sebelum menjalankan pengamanan yang diperlukan dengan API. Anda tidak perlu menyertakan `CreateGuardrail` langkah, dan Anda tidak perlu melacak ID atau versi pagar pembatas individu. Ini sangat berharga untuk alur kerja AI agen di mana langkah-langkah yang berbeda dalam loop memerlukan postur keselamatan yang berbeda. Anda dapat menerapkan pengamanan individu pada langkah yang berbeda tanpa membuat sumber daya pagar pembatas di setiap langkah, yang menghindari overhead operasional.
+ **Detect-only**— `InvokeGuardrailChecks` API mengembalikan temuan untuk setiap pemeriksaan keamanan dengan skor numerik antara 0 dan 1. API tidak memblokir, meneruskan, atau menyunting konten. Anda memutuskan tindakan yang diperlukan berdasarkan persyaratan aplikasi Anda, seperti memblokir konten, menyunting kecocokan PII, atau menampilkan peringatan.
+ **Pengamanan yang didukung - `InvokeGuardrailChecks` API mendukung perlindungan** berikut yang ditawarkan oleh Amazon Bedrock Guardrails:
  + [Blokir kata-kata dan percakapan berbahaya dengan filter konten](guardrails-content-filters.md)
  + [Mendeteksi serangan cepat dengan Amazon Bedrock Guardrails](guardrails-prompt-attack.md)— Deteksi serangan cepat ditawarkan sebagai perlindungan terpisah di luar filter konten untuk API. `InvokeGuardrailChecks` Ini berbeda dari `ApplyGuardrail` API di mana pemeriksaan keamanan serangan prompt disertakan sebagai bagian dari filter konten.
  + [Hapus PII dari percakapan dengan menggunakan filter informasi sensitif](guardrails-sensitive-filters.md)

**Topics**
+ [Wilayah yang Didukung](#guardrails-use-invoke-guardrail-checks-regions)
+ [Konsep: Pesan, jenis blok konten, dan pemeriksaan](guardrails-use-invoke-guardrail-checks-concepts.md)
+ [Definisi skor](guardrails-use-invoke-guardrail-checks-scores.md)
+ [Contoh konfigurasi, hasil, dan skor](guardrails-use-invoke-guardrail-checks-examples.md)
+ [Menggunakan API](guardrails-use-invoke-guardrail-checks-using.md)
+ [Kode sampel](guardrails-use-invoke-guardrail-checks-sample-code.md)
+ [Menyiapkan izin](guardrails-use-invoke-guardrail-checks-permissions.md)
+ [Kuota](guardrails-use-invoke-guardrail-checks-quotas.md)

## Wilayah yang Didukung
<a name="guardrails-use-invoke-guardrail-checks-regions"></a>

`InvokeGuardrailChecks`API tersedia di AWS Wilayah berikut:
+ Timur AS (N. Virginia)
+ AS Timur (Ohio)
+ AS Barat (Oregon)
+ Eropa (London)
+ Eropa (Stockholm)
+ Asia Pasifik (Tokyo)
+ Asia Pasifik (Sydney)