Hal-hal penting yang perlu diketahui Cara membuat pagar pembatas AI Ubah pesan default yang diblokir Contoh perintah CLI

Buat pagar pembatas AI untuk agen AI

P agar pembatas AI adalah sumber daya yang dapat Anda gunakan untuk menerapkan perlindungan berdasarkan kasus penggunaan dan kebijakan AI yang bertanggung jawab.

Agen AI menggunakan pagar pembatas Amazon Bedrock. Anda dapat membuat dan mengedit pagar pembatas ini di situs web Connect Customer admin.

Daftar Isi

Hal-hal penting yang perlu diketahui
Cara membuat pagar pembatas AI
Ubah pesan default yang diblokir
Contoh perintah CLI untuk mengonfigurasi kebijakan pagar pembatas AI

Hal-hal penting yang perlu diketahui

Anda dapat membuat hingga tiga pagar pembatas khusus.
Agen AI orkestrasi tidak mendukung kebijakan landasan kontekstual. Jika Anda membuat atau memperbarui agen AI orkestrasi yang menggunakan pagar pembatas AI dengan kebijakan landasan kontekstual, Anda kemudian akan melihat kesalahan validasi.
Pagar pembatas untuk agen AI mendukung bahasa yang sama dengan pagar pembatas Amazon Bedrock klasik. Untuk daftar lengkap bahasa yang didukung, lihat Bahasa yang didukung oleh Amazon Bedrock Guar drails. Mengevaluasi konten teks dalam bahasa lain tidak akan efektif.
Saat mengonfigurasi atau mengedit pagar pembatas, kami sangat menyarankan Anda untuk bereksperimen dan membandingkan dengan konfigurasi yang berbeda. Ada kemungkinan bahwa beberapa kombinasi Anda mungkin memiliki konsekuensi yang tidak diinginkan. Uji pagar pembatas untuk memastikan bahwa hasilnya memenuhi persyaratan kasus penggunaan Anda.
Saat pagar pembatas diaktifkan dengan respons streaming, ada latensi tambahan karena potongan teks harus disangga dan dipindai sebelum dikirim. Ini terutama mempengaruhi time-to-first-token (TTFT), karena sistem perlu mengumpulkan teks yang cukup untuk melakukan evaluasi pagar pembatas yang berarti sebelum streaming potongan pertama ke pengguna akhir. Latensi tambahan kecil di atas TTFT diharapkan, tergantung pada konfigurasi pagar pembatas. Respons yang lebih pendek mungkin mengalami latensi yang lebih nyata secara proporsional karena pemindaian pagar pembatas masih harus memproses buffer teks minimum. Ini adalah pertukaran yang melekat antara akurasi keamanan konten dan kecepatan respons. Jika kasus penggunaan Anda sensitif terhadap latensi, pertimbangkan apakah pagar pembatas diperlukan untuk semua interaksi, atau apakah pagar tersebut dapat diterapkan secara selektif. Untuk informasi selengkapnya tentang mode streaming pagar pembatas sinkron, lihat Meng onfigurasi perilaku respons streaming untuk memfilter konten di Panduan Pengguna Amazon Bedrock.

Cara membuat pagar pembatas AI

Masuk ke situs web Connect Customer admin dengan akun yang memiliki desainer agen AI, pagar pem batas AI - Buat izin di profil keamanannya.
Di situs web Connect Customer admin, di menu navigasi kiri, pilih desainer agen AI, pagar pem batas AI.
Pada halaman Guardrails, pilih Buat Guardrail.
Pada kotak dialog Create AI Guardrail, masukkan nama dan deskripsi pagar pembatas, lalu pilih Buat.
Pada halaman pembuat pagar pembatas AI, lengkapi bidang berikut sesuai kebutuhan untuk membuat kebijakan pagar pembatas Anda:
- Filter konten: Sesuaikan kekuatan filter untuk membantu memblokir prompt masukan atau respons model yang berisi konten berbahaya. Penyaringan dilakukan berdasarkan deteksi kategori konten berbahaya tertentu yang telah ditentukan sebelumnya - Kebencian, Penghinaan, Seksual, Kekerasan, Pelanggaran dan Serangan Cepat.
- Topik yang ditolak: Tentukan serangkaian topik yang tidak diinginkan dalam konteks aplikasi Anda. Filter akan membantu memblokirnya jika terdeteksi dalam kueri pengguna atau respons model. Anda dapat menambahkan hingga 30 topik yang ditolak.
- Pemeriksaan landasan kontekstual: Membantu mendeteksi dan memfilter halusinasi dalam respons model berdasarkan landasan dalam sumber dan relevansi dengan kueri pengguna.
- Filter kata: Konfigurasikan filter untuk membantu memblokir kata, frasa, dan kata-kata kotor yang tidak diinginkan (pencocokan tepat). Kata-kata seperti itu dapat mencakup istilah ofensif, nama pesaing.
- Filter informasi sensitif: Konfigurasikan filter untuk membantu memblokir atau menutupi informasi sensitif, seperti informasi identitas pribadi (PII), atau regex khusus dalam input pengguna dan respons model.
  
  Pemblokiran atau masking dilakukan berdasarkan deteksi probabilistik informasi sensitif dalam format standar dalam entitas seperti nomor SSN, Tanggal Lahir, alamat. Ini juga memungkinkan konfigurasi deteksi pola berbasis ekspresi reguler untuk pengidentifikasi.
- Pesan yang diblokir: Sesuaikan pesan default yang ditampilkan kepada pengguna jika pagar pembatas Anda memblokir input atau respons model.
Connect Customer tidak mendukung filter konten Gambar untuk membantu mendeteksi dan memfilter konten gambar yang tidak pantas atau beracun.
Setelah pagar pembatas Anda selesai, pilih Simpan.

Saat memilih dari dropdown versi, Latest:Draft selalu mengembalikan status tersimpan pagar pembatas AI.
Pilih Terbitkan. Pembaruan untuk pagar pembatas AI disimpan, status Visibilitas pagar pembatas AI diatur ke Diter bitkan, dan versi AI Guardrail baru dibuat.

Saat memilih dari dropdown versi, Latest:Published selalu mengembalikan status tersimpan pagar pembatas AI.

Ubah pesan default yang diblokir

Bagian ini menjelaskan cara mengakses pembuat pagar pembatas AI dan editor di situs web Connect Customer admin, menggunakan contoh mengubah pesan yang diblokir yang ditampilkan kepada pengguna.

Gambar berikut menunjukkan contoh pesan default yang diblokir yang ditampilkan kepada pengguna. Pesan default adalah “Teks masukan yang diblokir oleh pagar pembatas.”

Contoh pesan pagar pembatas default yang ditampilkan kepada pelanggan.

Untuk mengubah pesan default yang diblokir

Masuk ke situs web Connect Customer admin di https://instance name.my.connect.aws/. Gunakan akun admin, atau akun dengan desainer agen AI - pagar pem batas AI - Buat izin di profil keamanannya.
Pada menu navigasi, pilih desainer agen AI, pagar pembatas AI.
Pada halaman AI Guardrails, pilih Buat AI Guardrail. Dialog ditampilkan untuk Anda menetapkan nama dan deskripsi.
Di kotak dialog Create AI Guardrail, masukkan nama dan deskripsi, lalu pilih Buat. Jika bisnis Anda sudah memiliki tiga pagar pembatas, Anda akan mendapatkan pesan kesalahan, seperti yang ditunjukkan pada gambar berikut.

Jika Anda menerima pesan ini, alih-alih membuat pagar pembatas lain, pertimbangkan untuk mengedit pagar pembatas yang ada untuk memenuhi kebutuhan Anda. Atau, hapus satu sehingga Anda dapat membuat yang lain.
Untuk mengubah pesan default yang ditampilkan saat pagar pembatas memblokir respons model, gulir ke bagian Pesan yang diblokir.
Masukkan teks pesan blokir yang ingin ditampilkan, pilih S impan, lalu Publi kasikan.

Contoh perintah CLI untuk mengonfigurasi kebijakan pagar pembatas AI

Berikut ini adalah contoh cara mengonfigurasi kebijakan pagar pembatas AI dengan menggunakan CLI. AWS

Blokir topik yang tidak diinginkan

Gunakan contoh perintah AWS CLI berikut untuk memblokir topik yang tidak diinginkan.


aws qconnect update-ai-guardrail
--cli-input-json {
    "assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
    "aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
    "blockedInputMessaging": "Blocked input text by guardrail",
    "blockedOutputsMessaging": "Blocked output text by guardrail",
    "visibilityStatus": "PUBLISHED",
    "topicPolicyConfig": {
        "topicsConfig": [
            {
                "name": "Financial Advice",
                "definition": "Investment advice refers to financial inquiries, guidance, or recommendations with the goal of generating returns or achieving specific financial objectives.",
                "examples": ["- Is investment in stocks better than index funds?", "Which stocks should I invest into?", "- Can you manage my personal finance?"],
                "type": "DENY"
            }
        ]
    }
}

Filter konten berbahaya dan tidak pantas

Gunakan contoh perintah AWS CLI berikut untuk menyaring konten berbahaya dan tidak pantas.


aws qconnect update-ai-guardrail
--cli-input-json {
    "assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
    "aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
    "blockedInputMessaging": "Blocked input text by guardrail",
    "blockedOutputsMessaging": "Blocked output text by guardrail",
    "visibilityStatus": "PUBLISHED",
    "contentPolicyConfig": {
        "filtersConfig": [
            {
                "inputStrength": "HIGH",
                "outputStrength": "HIGH",
                "type": "INSULTS"
            }
        ]
    }
}

Filter kata-kata yang berbahaya dan tidak pantas

Gunakan contoh perintah AWS CLI berikut untuk menyaring kata-kata berbahaya dan tidak pantas.


aws qconnect update-ai-guardrail
--cli-input-json {
    "assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
    "aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
    "blockedInputMessaging": "Blocked input text by guardrail",
    "blockedOutputsMessaging": "Blocked output text by guardrail",
    "visibilityStatus": "PUBLISHED",
    "wordPolicyConfig": {
        "wordsConfig": [
            {
                "text": "Nvidia",
            },
        ]
    }
}

Mendeteksi halusinasi dalam respons model

Gunakan contoh perintah AWS CLI berikut untuk mendeteksi halusinasi dalam respons model.


aws qconnect update-ai-guardrail
--cli-input-json {
    "assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
    "aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
    "blockedInputMessaging": "Blocked input text by guardrail",
    "blockedOutputsMessaging": "Blocked output text by guardrail",
    "visibilityStatus": "PUBLISHED",
    "contextualGroundPolicyConfig": {
        "filtersConfig": [
            {
                "type": "RELEVANCE",
                "threshold": 0.50
            },
        ]
    }
}

Menyunting informasi sensitif

Gunakan contoh perintah AWS CLI berikut untuk menyunting informasi sensitif seperti informasi identitas pribadi (PII).


aws qconnect update-ai-guardrail
--cli-input-json {
    "assistantId": "a0a81ecf-6df1-4f91-9513-3bdcb9497e32",
    "aiGuardrailId": "9147c4ad-7870-46ba-b6c1-7671f6ca3d95",
    "blockedInputMessaging": "Blocked input text by guardrail",
    "blockedOutputsMessaging": "Blocked output text by guardrail",
    "visibilityStatus": "PUBLISHED",
    "sensitiveInformationPolicyConfig": {
        "piiEntitiesConfig": [
            {
                "type": "CREDIT_DEBIT_CARD_NUMBER",
                "action":"BLOCK",
            },
        ]
    }
}

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

Buat petunjuk AI

Buat agen AI