Buat pagar pembatas

Anda membuat pagar pembatas dengan menyiapkan konfigurasi, menentukan topik yang akan ditolak, menyediakan filter untuk menangani konten berbahaya dan sensitif, dan menulis pesan saat permintaan dan tanggapan pengguna diblokir.

Pagar pembatas harus berisi setidaknya satu filter dan pesan ketika permintaan dan tanggapan pengguna diblokir. Anda dapat memilih untuk menggunakan pesan default. Anda dapat menambahkan filter dan mengulangi pagar pembatas Anda nanti dengan mengikuti langkah-langkah di Edit pagar pembatas untuk mengkonfigurasi semua komponen yang Anda butuhkan untuk pagar pembatas Anda.

Pilih tab yang sesuai dengan metode pilihan Anda dan ikuti langkah-langkahnya.

Console

Untuk membuat pagar pembatas

Masuk ke AWS Management Console, dan buka konsol Amazon Bedrock di https://console.aws.amazon.com/bedrock/.
Dari panel navigasi kiri, pilih Guardrails.
Di bagian Guardrails, pilih Buat pagar pembatas.
Pada halaman Berikan detail pagar pembatas, lakukan hal berikut:
1. Di bagian detail Guardrail, berikan Nama dan Deskripsi opsional untuk pagar pembatas.
2. (Opsional) Secara default, pagar pembatas Anda dienkripsi dengan file. Kunci yang dikelola AWS Untuk menggunakan kunci KMS yang dikelola pelanggan Anda sendiri, pilih panah kanan di sebelah pilihan tombol KMS dan pilih kotak centang Sesuaikan pengaturan enkripsi (lanjutan). Anda dapat memilih AWS KMS kunci yang ada atau pilih Buat AWS KMS kunci untuk membuat yang baru.
3. (Opsional) Untuk menambahkan tag ke pagar pembatas Anda, pilih panah kanan di sebelah Tag. Kemudian, pilih Tambahkan tag baru dan tentukan pasangan nilai kunci untuk tag Anda. Untuk informasi selengkapnya, lihat Memberi tanda pada sumber daya.
4. Pilih Berikutnya.
catatan
Anda harus mengkonfigurasi setidaknya satu filter untuk membuat pagar pembatas. Anda kemudian dapat memilih Skip to Review dan membuat untuk melewati pembuatan filter lain.
(Opsional) Pada halaman Konfigurasi filter konten, atur seberapa kuat Anda ingin memfilter konten yang terkait dengan kategori yang ditentukan Filter konten dengan melakukan hal berikut:
1. Untuk mengonfigurasi filter untuk petunjuk ke model, pilih Aktifkan filter untuk petunjuk di bagian Kekuatan filter untuk petunjuk model. Konfigurasikan seberapa ketat yang Anda inginkan setiap filter untuk petunjuk yang diberikan pengguna ke model.
2. Untuk mengonfigurasi filter untuk respons model, pilih Aktifkan filter untuk respons di Kekuatan filter untuk respons. Konfigurasikan seberapa ketat yang Anda inginkan setiap filter untuk respons yang dikembalikan model.
3. Pilih Selanjutnya.
(Opsional) Pada halaman Tambahkan topik yang ditolak, lakukan hal berikut:
1. Untuk menentukan topik yang akan diblokir, pilih Tambahkan topik yang ditolak. Kemudian, lakukan hal berikut:
  1. Masukkan Nama untuk topik.
  2. Di kotak Definisi untuk topik, tentukan topik. Untuk panduan tentang cara mendefinisikan topik yang ditolak, lihatTopik yang ditolak.
  3. (Opsional) Untuk menambahkan prompt input representatif atau respons model yang terkait dengan topik ini, pilih panah kanan di sebelah Tambahkan frasa sampel. Masukkan frasa di dalam kotak. Untuk menambahkan frasa lain, pilih Tambahkan frasa.
  4. Setelah selesai mengonfigurasi topik yang ditolak, pilih Konfirmasi.
2. Anda dapat melakukan tindakan berikut dengan topik Ditolak.
  - Untuk menambahkan topik lain, pilih Tambahkan topik yang ditolak.
  - Untuk mengedit topik, pilih ikon tiga titik di baris yang sama dengan topik di kolom Tindakan. Lalu pilih Edit. Setelah Anda selesai mengedit, pilih Konfirmasi.
  - Untuk menghapus topik atau topik, pilih kotak centang untuk topik yang akan dihapus. Pilih Hapus dan kemudian pilih Hapus yang dipilih.
  - Untuk menghapus semua topik, pilih Hapus dan kemudian pilih Hapus semua.
  - Untuk mengkonfigurasi ukuran setiap halaman dalam tabel atau tampilan kolom dalam tabel, pilih ikon pengaturan ( ). Tetapkan preferensi Anda dan kemudian pilih Konfirmasi.
3. Setelah selesai mengonfigurasi topik yang ditolak, pilih Berikutnya.

(Opsional) Pada halaman Tambahkan filter kata, lakukan hal berikut:

Di bagian Filter kata-kata kotor, pilih Filter kata-kata kotor untuk memblokir kata-kata kotor dalam petunjuk dan tanggapan. Daftar kata-kata kotor didasarkan pada definisi konvensional dan terus diperbarui.

Di bagian Tambahkan kata dan frasa khusus, pilih cara menambahkan kata dan frasa untuk diblokir pagar pembatas. Jika Anda memilih untuk mengunggah file, setiap baris dalam file harus berisi satu kata atau frasa hingga tiga kata. Jangan sertakan header. Anda memiliki opsi berikut:

Opsi	Petunjuk
Tambahkan kata dan frasa secara manual	Tambahkan kata dan frasa secara langsung di bagian Lihat dan edit kata dan frasa.
Unggah dari file lokal	Untuk mengunggah file.txt atau .csv yang berisi kata dan frasa, pilih Pilih file setelah memilih opsi ini.
Unggah dari objek Amazon S3	Untuk mengunggah file dari Amazon S3, tentukan objek S3 setelah memilih opsi ini. Setiap baris dalam file harus berisi satu kata atau frasa hingga tiga kata.

Anda mengedit kata dan frasa untuk pagar pembatas untuk diblokir di bagian Lihat dan edit kata dan frasa. Anda memiliki opsi berikut:
- Jika Anda mengunggah daftar kata dari file lokal atau objek Amazon S3, bagian ini akan diisi dengan daftar kata Anda. Untuk memfilter item dengan kesalahan, pilih Tampilkan kesalahan.
- Untuk menambahkan item ke daftar kata, pilih Tambahkan kata atau frasa. Masukkan kata atau frasa hingga tiga kata di dalam kotak dan tekan Enter atau pilih ikon tanda centang untuk mengonfirmasi item.
- Untuk mengedit item, pilih ikon edit ( ) di sebelah item.
- Untuk menghapus item dari daftar kata, pilih ikon tempat sampah ( ) atau, jika Anda mengedit item, pilih ikon hapus ( ) di sebelah item.
- Untuk menghapus item yang berisi kesalahan, pilih Hapus semua dan kemudian pilih Hapus semua baris dengan kesalahan
- Untuk menghapus semua item, pilih Hapus semua dan kemudian pilih Hapus semua baris
- Untuk mencari item, masukkan ekspresi di bilah pencarian.
- Untuk hanya menampilkan item dengan kesalahan, pilih menu tarik-turun berlabel Tampilkan semua dan pilih Tampilkan kesalahan saja.
- Untuk mengkonfigurasi ukuran setiap halaman dalam tabel atau tampilan kolom dalam tabel, pilih ikon pengaturan ( ). Tetapkan preferensi Anda dan kemudian pilih Konfirmasi.
- Secara default, bagian ini menampilkan editor Tabel. Untuk beralih ke editor teks di mana Anda dapat memasukkan kata atau frasa di setiap baris, pilih Editor teks. Editor Teks menyediakan fitur-fitur berikut:
  - Anda dapat menyalin daftar kata dari editor teks lain dan menempelkannya ke editor ini.
  - Ikon X merah muncul di sebelah item yang berisi kesalahan dan daftar kesalahan muncul di bawah editor.

(Opsional) Pada halaman Tambahkan filter informasi sensitif, konfigurasikan filter untuk memblokir atau menutupi informasi sensitif. Untuk informasi selengkapnya, lihat Filter informasi sensitif. Lakukan hal-hal berikut:

Di bagian jenis PII, konfigurasikan kategori informasi identifikasi pribadi (PII) untuk diblokir atau ditutup. Anda memiliki opsi berikut:
- Untuk menambahkan tipe PII, pilih Tambahkan tipe PII. Kemudian, lakukan hal berikut:
  1. Di kolom Type, pilih tipe PII.
  2. Di kolom perilaku Guardrail, pilih apakah pagar pembatas harus Memblokir konten yang berisi tipe PII atau Masker dengan pengenal.
- Untuk menambahkan semua jenis PII, pilih panah tarik-turun di sebelah Tambahkan tipe PII. Kemudian pilih perilaku pagar pembatas untuk diterapkan pada mereka.
  
  Awas
  Jika Anda menentukan perilaku, perilaku apa pun yang ada yang Anda konfigurasikan untuk tipe PII akan ditimpa.
- Untuk menghapus jenis PII, pilih ikon tempat sampah () .
- Untuk menghapus baris yang berisi kesalahan, pilih Hapus semua dan kemudian pilih Hapus semua baris dengan kesalahan
- Untuk menghapus semua jenis PII, pilih Hapus semua dan kemudian pilih Hapus semua baris
- Untuk mencari baris, masukkan ekspresi di bilah pencarian.
- Untuk hanya menampilkan baris dengan kesalahan, pilih menu tarik-turun berlabel Tampilkan semua dan pilih Tampilkan kesalahan saja.
- Untuk mengkonfigurasi ukuran setiap halaman dalam tabel atau tampilan kolom dalam tabel, pilih ikon pengaturan ( ). Tetapkan preferensi Anda dan kemudian pilih Konfirmasi.

Di bagian pola Regex, gunakan ekspresi reguler untuk menentukan pola untuk pagar pembatas untuk difilter. Anda memiliki opsi berikut:

Untuk menambahkan pola, pilih Tambahkan pola regex. Konfigurasi bidang berikut:

Bidang	Deskripsi
Nama	Nama untuk pola
Pola Regex	Ekspresi reguler yang mendefinisikan pola
Perilaku pagar pembatas	Pilih apakah akan Memblokir konten yang berisi pola atau menutupinya dengan pengenal. Untuk menutupi pola hanya di log, pilih None.
Tambahkan deskripsi	(Opsional) Tulis deskripsi untuk pola

Untuk mengedit pola, pilih ikon tiga titik di baris yang sama dengan topik di kolom Tindakan. Lalu pilih Edit. Setelah Anda selesai mengedit, pilih Konfirmasi.
Untuk menghapus pola atau pola, pilih kotak centang untuk pola yang akan dihapus. Pilih Hapus dan kemudian pilih Hapus yang dipilih.
Untuk menghapus semua pola, pilih Hapus dan kemudian pilih Hapus semua.
Untuk mencari pola, masukkan ekspresi di bilah pencarian.
Untuk mengkonfigurasi ukuran setiap halaman dalam tabel atau tampilan kolom dalam tabel, pilih ikon pengaturan ( ). Tetapkan preferensi Anda dan kemudian pilih Konfirmasi.

Setelah selesai mengonfigurasi filter informasi sensitif, pilih Berikutnya.

Pada halaman Tentukan pesan yang diblokir, atur pesan yang ingin Anda kembalikan ke pengguna saat pagar pembatas mendeteksi dan memblokir konten. Lakukan hal-hal berikut:
1. Di bidang Pesan yang ditampilkan untuk petunjuk yang diblokir di bagian Pesan yang diblokir, masukkan pesan yang akan ditampilkan jika pagar pembatas memblokir prompt yang dikirim ke model.
2. Di bidang Pesan yang ditampilkan untuk respons yang diblokir di bagian Pesan yang diblokir, masukkan pesan yang akan ditampilkan jika pagar pembatas memblokir respons yang dihasilkan oleh model.
3. Pilih Selanjutnya.
Tinjau dan buat — Tinjau pengaturan untuk pagar pembatas Anda.
1. Pilih Edit di bagian mana pun yang ingin Anda ubah.
2. Ketika Anda puas dengan pengaturan untuk pagar pembatas Anda, pilih Buat untuk membuat pagar pembatas.

API

Untuk membuat pagar pembatas, kirim permintaan. CreateGuardrail Format permintaan adalah sebagai berikut:


POST /guardrails HTTP/1.1
Content-type: application/json

{
   "blockedInputMessaging": "string",
   "blockedOutputsMessaging": "string",
   "contentPolicyConfig": { 
      "filtersConfig": [ 
         { 
            "inputStrength": "NONE | LOW | MEDIUM | HIGH",
            "outputStrength": "NONE | LOW | MEDIUM | HIGH",
            "type": "SEXUAL | VIOLENCE | HATE | INSULTS | MISCONDUCT | PROMPT_ATTACK"
         }
      ]
   },
    "wordPolicyConfig": {
    "wordsConfig": [
      {
        "text": "string"
      }
    ],
    "managedWordListsConfig": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicyConfig": {
    "piiEntitiesConfig": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexesConfig": [
      {
        "name": "string",
        "description": "string",
        "regex": "string",
        "action": "string"
      }
    ]
  },
   "description": "string",
   "kmsKeyId": "string",
   "name": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ],
   "topicPolicyConfig": { 
      "topicsConfig": [ 
         { 
            "definition": "string",
            "examples": [ "string" ],
            "name": "string",
            "type": "DENY"
         }
      ]
   }
}

Tentukan name dan description untuk pagar pembatas.
Tentukan pesan kapan pagar pembatas berhasil memblokir prompt atau respons model di bidang blockedInputMessaging danblockedOutputsMessaging.
Tentukan topik untuk pagar pembatas untuk ditolak dalam objek. topicPolicy Setiap item dalam topics daftar berkaitan dengan satu topik. Untuk informasi selengkapnya tentang bidang dalam suatu topik, lihat Topik.
- Berikan name dan description agar pagar pembatas dapat mengidentifikasi topik dengan benar.
- Tentukan DENY di action lapangan.
- (Opsional) Berikan hingga lima contoh yang akan Anda kategorikan sebagai milik topik dalam daftar. examples
Tentukan kekuatan filter untuk kategori berbahaya yang ditentukan di Amazon Bedrock di contentPolicy objek. Setiap item dalam filters daftar berkaitan dengan kategori berbahaya. Untuk informasi selengkapnya, lihat Filter konten. Untuk informasi selengkapnya tentang bidang dalam filter konten, lihat ContentFilter.
- Tentukan kategori di type lapangan.
- Tentukan kekuatan filter untuk petunjuk di strength bidang textToTextFiltersForPrompt lapangan dan untuk respons model di strength textToTextFiltersForResponse bidang.
(Opsional) Pasang tag apa pun ke pagar pembatas. Untuk informasi selengkapnya, lihat Memberi tanda pada sumber daya.
(Opsional) Untuk keamanan, sertakan ARN kunci KMS di lapangan. kmsKeyId

Format responsnya adalah sebagai berikut:


HTTP/1.1 202
Content-type: application/json

{
   "createdAt": "string",
   "guardrailArn": "string",
   "guardrailId": "string",
   "version": "string"
}

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Prasyarat

Uji pagar pembatas

Buat pagar pembatas

Untuk membuat pagar pembatas

catatan

Awas