Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengkonfigurasi dan menyesuaikan kueri untuk basis pengetahuan terkelola
Anda dapat mengonfigurasi dan menyesuaikan pengambilan, lebih lanjut meningkatkan relevansi hasil. Misalnya, Anda dapat menerapkan filter ke metadata dokumen fields/attributes untuk menggunakan dokumen atau dokumen terbaru yang diperbarui dengan waktu modifikasi terbaru.
**catatan**
Semua konfigurasi berikut hanya berlaku untuk sumber data tidak terstruktur.
Untuk mempelajari lebih lanjut tentang konfigurasi ini di konsol atau API, pilih dari topik berikut:
## Jumlah potongan sumber
Saat Anda menanyakan basis pengetahuan, Amazon Bedrock mengembalikan hingga lima hasil dalam respons secara default. Setiap hasil sesuai dengan potongan sumber.
**catatan**
Jumlah aktual hasil dalam respons mungkin kurang dari `numberOfResults` nilai yang ditentukan, karena parameter ini menetapkan jumlah maksimum hasil yang akan dikembalikan. Jika Anda telah mengonfigurasi pemotongan hierarkis untuk strategi chunking Anda, `numberOfResults` parameter memetakan ke jumlah potongan anak yang akan diambil basis pengetahuan. Karena potongan turunan yang berbagi potongan induk yang sama diganti dengan potongan induk dalam respons akhir, jumlah hasil yang dikembalikan mungkin kurang dari jumlah yang diminta.
Untuk mengubah jumlah maksimum hasil yang akan dikembalikan, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
Ikuti langkah-langkah konsol di[Kueri basis pengetahuan dan ambil data](kb-test-retrieve.md). Di ** panel ** Konfigurasi, perluas ** bagian potongan ** Sumber dan masukkan jumlah maksimum potongan sumber untuk dikembalikan.
------
#### [ API ]
Saat Anda membuat [RetrieveAndGenerate](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) permintaan [Retrieve](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html) atau, sertakan `retrievalConfiguration` bidang, dipetakan ke [ KnowledgeBaseRetrievalConfiguration ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalConfiguration.html) objek. Untuk melihat lokasi bidang ini, lihat [Retrieve](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html) dan [RetrieveAndGenerate](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) permintaan badan di referensi API.
Objek JSON berikut menunjukkan bidang minimal yang diperlukan dalam [ KnowledgeBaseRetrievalConfiguration ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalConfiguration.html) objek untuk mengatur jumlah maksimum hasil yang akan dikembalikan:
```
"retrievalConfiguration": {
"managedSearchConfiguration": {
"numberOfResults": number
}
}
```
Tentukan jumlah maksimum hasil yang diambil (lihat `numberOfResults` bidang di [ KnowledgeBaseRetrievalConfiguration ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalConfiguration.html) untuk kisaran nilai yang diterima) untuk dikembalikan di `numberOfResults` bidang.
------
## Pemfilteran metadata manual
Anda dapat menerapkan filter ke dokumen fields/attributes untuk membantu Anda lebih meningkatkan relevansi tanggapan. Sumber data Anda dapat menyertakan metadata dokumen attributes/fields untuk difilter dan dapat menentukan bidang mana yang akan disertakan dalam penyematan.
**Pertimbangan basis pengetahuan terkelola**
Saat menggunakan pemfilteran metadata dengan basis pengetahuan terkelola:
Filter `startsWith` dan `stringContains` metadata tidak didukung. Gunakan`equals`,,`greaterThan`,`lessThan`,`in`, atau `notIn` operator sebagai gantinya.
Operator rentang (`greaterThan``greaterThanOrEquals`,`lessThan`,, dan`lessThanOrEquals`) menerima angka atau nilai tanggal-waktu. Untuk memfilter tanggal-waktu, berikan nilai sebagai string dalam format tanggal-waktu ISO-8601 offset. Gunakan formulir offset penuh, misalnya,`2026-03-02T19:02:18Z`. Operator rentang mendukung nilai string tanggal-waktu hanya untuk basis pengetahuan terkelola.
Untuk basis pengetahuan khusus, bidang metadata yang diawali dengan `x-amz-bedrock` dicadangkan oleh layanan. Untuk basis pengetahuan yang dikelola sepenuhnya, bidang metadata yang dicadangkan menggunakan awalan garis bawah (misalnya,`_source_uri`,`_data_source_id`). Anda tidak dapat mengganti bidang metadata yang dicadangkan di salah satu jenis basis pengetahuan.
Misalnya, “epoch\_modifiation\_time” mewakili waktu dalam jumlah detik sejak 1 Januari 1970 (UTC) ketika dokumen terakhir diperbarui. Anda dapat memfilter pada data terbaru, di mana “epoch\_modifiation\_time” lebih besar dari angka tertentu. * * Dokumen terbaru ini dapat digunakan untuk kueri.
Untuk menggunakan filter saat menanyakan basis pengetahuan, periksa apakah basis pengetahuan Anda memenuhi persyaratan berikut:
+ Saat mengonfigurasi konektor sumber data Anda, sebagian besar konektor merayapi bidang metadata utama dokumen Anda. Jika Anda menggunakan bucket Amazon S3 sebagai sumber data, bucket harus menyertakan setidaknya satu `fileName.extension.metadata.json` untuk file atau dokumen yang terkait dengannya. Lihat ** Bidang metadata dokumen [Konfigurasi koneksi](s3-data-source-connector.md#configuration-s3-connector) untuk informasi selengkapnya tentang mengonfigurasi file metadata. **
+ Jika indeks vektor basis pengetahuan Anda berada di penyimpanan vektor Amazon OpenSearch Serverless, periksa apakah indeks vektor dikonfigurasi dengan `faiss` mesin. Jika indeks vektor dikonfigurasi dengan `nmslib` mesin, Anda harus melakukan salah satu hal berikut:
+ [Buat basis pengetahuan baru ](knowledge-base-create.md) di konsol dan biarkan Amazon Bedrock secara otomatis membuat indeks vektor di Amazon OpenSearch Serverless untuk Anda.
+ [Buat indeks vektor lain ](knowledge-base-setup.md) di penyimpanan vektor dan pilih `faiss` sebagai ** Mesin**. Kemudian [ Buat basis pengetahuan baru ](knowledge-base-create.md) dan tentukan indeks vektor baru.
+ Jika basis pengetahuan Anda menggunakan indeks vektor dalam bucket vektor S3, Anda tidak dapat menggunakan `stringContains` filter `startsWith` dan.
+ Jika Anda menambahkan metadata ke indeks vektor yang ada di cluster database Amazon Aurora, sebaiknya berikan nama bidang kolom metadata kustom untuk menyimpan semua metadata Anda dalam satu kolom. Selama [ penyerapan data](kb-data-source-sync-ingest.md), kolom ini akan digunakan untuk mengisi semua informasi dalam file metadata Anda dari sumber data Anda. Jika Anda memilih untuk memberikan bidang ini, Anda harus membuat indeks pada kolom ini.
+ Saat Anda [ membuat basis pengetahuan baru ](knowledge-base-create.md) di konsol dan membiarkan Amazon Bedrock mengonfigurasi database Amazon Aurora Anda, itu akan secara otomatis membuat satu kolom untuk Anda dan mengisinya dengan informasi dari file metadata Anda.
+ Ketika Anda memilih untuk [ membuat indeks vektor lain ](knowledge-base-setup.md) di penyimpanan vektor, Anda harus memberikan nama bidang metadata khusus untuk menyimpan informasi dari file metadata Anda. Jika Anda tidak memberikan nama bidang ini, Anda harus membuat kolom untuk setiap atribut metadata dalam file Anda dan menentukan jenis data (teks, angka, atau boolean). Misalnya, jika atribut `genre` ada di sumber data Anda, Anda akan menambahkan kolom bernama `genre` dan tentukan `text` sebagai tipe data. Selama konsumsi, kolom terpisah ini akan diisi dengan nilai atribut yang sesuai.
Jika Anda memiliki dokumen PDF di sumber data Anda dan menggunakan Amazon OpenSearch Serverless atau Amazon Aurora untuk toko vektor Anda: Basis pengetahuan Amazon Bedrock akan menghasilkan nomor halaman dokumen dan menyimpannya dalam metadata yang field/attribute disebut * x-amz-bedrock-kb-document-page-number. * Perhatikan bahwa nomor halaman yang disimpan dalam bidang metadata tidak didukung jika Anda memilih tidak memotong untuk dokumen Anda.
Anda dapat menggunakan operator pemfilteran berikut untuk memfilter hasil saat Anda menanyakan:
**Operator penyaringan**
| Operator | Konsol | Nama filter API | Jenis data atribut yang didukung | Hasil yang difilter |
| --- | --- | --- | --- | --- |
| Sama dengan | = | [sama ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-equals) | string, angka, boolean | Atribut cocok dengan nilai yang Anda berikan |
| Tidak sama | \!= | [CatatanKualitas ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-notEquals) | string, angka, boolean | Atribut tidak cocok dengan nilai yang Anda berikan |
| Lebih besar dari | > | [Lebih besarDari ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-greaterThan) | number | Atribut lebih besar dari nilai yang Anda berikan |
| Lebih besar dari atau sama | >= | [lebih besar ThanOrEquals ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-greaterThanOrEquals) | number | Atribut lebih besar dari atau sama dengan nilai yang Anda berikan |
| Kurang dari | < | [Kurang dari ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-lessThan) | number | Atribut kurang dari nilai yang Anda berikan |
| Kurang dari atau sama | <= | [kurang ThanOrEquals ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-lessThanOrEquals) | number | Atribut kurang dari atau sama dengan nilai yang Anda berikan |
| Masuk | : | [di ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-in) | daftar string | Atribut ada dalam daftar yang Anda berikan (saat ini paling didukung dengan toko vektor Amazon OpenSearch Serverless dan Neptune Analytics GraphRag) |
| Tidak masuk | \!: | [Tidak ada ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-notIn) | daftar string | Atribut tidak ada dalam daftar yang Anda berikan (saat ini didukung paling baik dengan toko vektor Amazon OpenSearch Serverless dan Neptune Analytics GraphRag) |
| String berisi | Tidak tersedia | [StringBerisi ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-stringContains) | string | Atribut harus berupa string. Nama atribut cocok dengan kunci dan nilainya adalah string yang berisi nilai yang Anda berikan sebagai substring, atau daftar dengan anggota yang berisi nilai yang Anda berikan sebagai substring (saat ini paling baik didukung dengan Amazon OpenSearch Serverless vector store. Penyimpanan vektor GraphRag Neptune Analytics mendukung varian string tetapi bukan varian daftar filter ini). |
| Daftar berisi | Tidak tersedia | [DaftarBerisi ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-listContains) | string | Atribut harus berupa daftar string. Nama atribut cocok dengan kunci dan nilainya adalah daftar yang berisi nilai yang Anda berikan sebagai salah satu anggotanya (saat ini didukung paling baik dengan penyimpanan vektor Amazon OpenSearch Serverless). |
Untuk menggabungkan operator penyaringan, Anda dapat menggunakan operator logis berikut:
**Operator logis**
| Operator | Konsol | Nama bidang filter API | Hasil yang difilter |
| --- | --- | --- | --- |
| Dan | and | [Dan semua ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-andAll) | Hasil memenuhi semua ekspresi pemfilteran dalam grup |
| Atau | atau | [atauSemua ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-orAll) | Hasil memenuhi setidaknya satu ekspresi pemfilteran dalam grup |
Untuk mempelajari cara memfilter hasil menggunakan metadata, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
Ikuti langkah-langkah konsol di[Kueri basis pengetahuan dan ambil data](kb-test-retrieve.md). Saat Anda membuka ** panel ** Konfigurasi, Anda akan melihat bagian ** Filter**. Prosedur berikut menjelaskan kasus penggunaan yang berbeda:
+ Untuk menambahkan filter, buat ekspresi pemfilteran dengan memasukkan atribut metadata, operator pemfilteran, dan nilai dalam kotak. Pisahkan setiap bagian ekspresi dengan spasi putih. Tek ** an Enter ** untuk menambahkan filter.
Untuk daftar operator penyaringan yang diterima, lihat ** tabel Operator pen ** yaringan di atas. Anda juga dapat melihat daftar operator pemfilteran saat menambahkan spasi setelah atribut metadata.
**catatan**
Anda harus mengelilingi string dengan tanda kutip.
Misalnya, Anda dapat memfilter hasil dari dokumen sumber yang berisi atribut `genre` metadata yang nilainya `"entertainment"` dengan menambahkan filter berikut:**genre = "entertainment"**.
+ Untuk menambahkan filter lain, masukkan ekspresi penyaringan lain di kotak dan tekan ** Enter**. Anda dapat menambahkan hingga 5 filter dalam grup.
+ Secara default, kueri akan mengembalikan hasil yang memenuhi semua ekspresi pemfilteran yang Anda berikan. Untuk mengembalikan hasil yang memenuhi setidaknya satu ekspresi pemfilteran, pilih menu tarik- ** ** turun dan di antara dua operasi pemfilteran dan pilih ** atau**.
+ Untuk menggabungkan operator logis yang berbeda, pilih ** \+ Tam ** bah Grup untuk menambahkan grup filter. Masukkan ekspresi pemfilteran di grup baru. Anda dapat menambahkan hingga 5 grup filter.
+ Untuk mengubah operator logis yang digunakan di antara semua grup pemfilteran, pilih menu ** dropdown AND di antara dua grup filter dan pilih ** OR**. **
+ Untuk mengedit filter, pilih filter, ubah operasi pemfilteran, dan pilih Ter ** apkan**.
+ Untuk menghapus grup filter, pilih ikon tempat sampah () di sebelah grup. Untuk menghapus filter, pilih ikon hapus () di sebelah filter.
Gambar berikut menunjukkan contoh konfigurasi filter yang mengembalikan semua dokumen yang ditulis setelah gen **2018** renya**"entertainment"**, selain dokumen yang genrenya **"cooking"** atau **"sports"** dan yang penulisnya dimulai**"C"**.
------
#### [ API ]
Saat Anda membuat [RetrieveAndGenerate](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) permintaan [Retrieve](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html) atau, sertakan `retrievalConfiguration` bidang, dipetakan ke [ KnowledgeBaseRetrievalConfiguration ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalConfiguration.html) objek. Untuk melihat lokasi bidang ini, lihat [Retrieve](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html) dan [RetrieveAndGenerate](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) permintaan badan di referensi API.
Objek JSON berikut menunjukkan bidang minimal yang diperlukan dalam [ KnowledgeBaseRetrievalConfiguration ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalConfiguration.html) objek untuk mengatur filter untuk kasus penggunaan yang berbeda:
1. Gunakan satu operator penyaringan (lihat ** tabel operator ** penyaringan di atas).
```
"retrievalConfiguration": {
"managedSearchConfiguration": {
"filter": {
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
}
}
}
}
```
1. Gunakan operator logis (lihat ** tabel operator ** logis di atas) untuk menggabungkan hingga 5.
```
"retrievalConfiguration": {
"managedSearchConfiguration": {
"filter": {
"{{andAll | orAll}}": [
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
},
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
},
...
]
}
}
}
```
1. Gunakan operator logis untuk menggabungkan hingga 5 operator penyaringan ke dalam grup filter, dan operator logis kedua untuk menggabungkan grup filter itu dengan operator pemfilteran lain.
```
"retrievalConfiguration": {
"managedSearchConfiguration": {
"filter": {
"{{andAll | orAll}}": [
"{{andAll | orAll}}": [
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
},
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
},
...
],
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
}
]
}
}
}
```
1. Gabungkan hingga 5 grup filter dengan menyematkannya dalam operator logis lain. Anda dapat membuat satu tingkat penyematan.
```
"retrievalConfiguration": {
"managedSearchConfiguration": {
"filter": {
"{{andAll | orAll}}": [
"{{andAll | orAll}}": [
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
},
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
},
...
],
"{{andAll | orAll}}": [
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
},
"{{}}": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
},
...
]
]
}
}
}
```
Tabel berikut menjelaskan jenis filter yang dapat Anda gunakan:
| Bidang | Jenis data nilai yang didukung | Hasil yang difilter |
| --- | --- | --- |
| equals | string, angka, boolean | Atribut cocok dengan nilai yang Anda berikan |
| notEquals | string, angka, boolean | Atribut tidak cocok dengan nilai yang Anda berikan |
| greaterThan | number | Atribut lebih besar dari nilai yang Anda berikan |
| greaterThanOrEquals | number | Atribut lebih besar dari atau sama dengan nilai yang Anda berikan |
| lessThan | number | Atribut kurang dari nilai yang Anda berikan |
| lessThanOrEquals | number | Atribut kurang dari atau sama dengan nilai yang Anda berikan |
| in | daftar string | Atribut ada dalam daftar yang Anda berikan |
| notIn | daftar string | Atribut tidak ada dalam daftar yang Anda berikan |
| startsWith | string | Atribut dimulai dengan string yang Anda berikan (hanya didukung untuk penyimpanan vektor Amazon OpenSearch Serverless) |
Untuk menggabungkan jenis filter, Anda dapat menggunakan salah satu operator logis berikut:
| Bidang | Peta ke | Hasil yang difilter |
| --- | --- | --- |
| andAll | Daftar hingga 5 jenis filter | Hasil memenuhi semua ekspresi pemfilteran dalam grup |
| orAll | Daftar hingga 5 jenis filter | Hasil memenuhi setidaknya satu ekspresi pemfilteran dalam grup |
Sebagai contoh, lihat Men [ girim kueri dan sertakan filter (Ambil) ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_Example_2) dan Men [ girim kueri dan sertakan filter (RetrieveAndGenerate)](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_Example_2).
------
## Batasan pengaman
Anda dapat menerapkan perlindungan untuk basis pengetahuan Anda untuk kasus penggunaan dan kebijakan AI yang bertanggung jawab. Anda dapat membuat beberapa pagar pembatas yang disesuaikan dengan kasus penggunaan yang berbeda dan menerapkannya di beberapa kondisi permintaan dan respons, memberikan pengalaman pengguna yang konsisten dan menstandarisasi kontrol keselamatan di seluruh basis pengetahuan Anda. Anda dapat mengonfigurasi topik yang ditolak untuk melarang topik yang tidak diinginkan dan filter konten untuk memblokir konten berbahaya dalam input dan respons model. Untuk informasi selengkapnya, lihat [Mendeteksi dan memfilter konten berbahaya dengan menggunakan Amazon Bedrock Guardrails](guardrails.md).
**catatan**
Menggunakan pagar pembatas dengan landasan kontekstual untuk basis pengetahuan saat ini tidak didukung di Claude 3 Sonnet dan Haiku.
Untuk pedoman rekayasa cepat umum, lihat[Konsep rekayasa prompt](prompt-engineering-guidelines.md).
Pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
Ikuti langkah-langkah konsol di[Kueri basis pengetahuan dan ambil data](kb-test-retrieve.md). Di jendela pengujian, aktifkan H ** asilkan respons**. Kemudian, di ** panel ** Konfigurasi, perluas bagian ** Guardrails**.
1. Di ** bagian ** Guardrails, pilih ** Nama ** dan ** Versi pagar ** pembatas Anda. Jika Anda ingin melihat detail pagar pembatas dan versi pilihan Anda, pilih ** Lihat. **
Atau, Anda dapat membuat yang baru dengan memilih tautan ** Guardrail**.
1. Setelah selesai mengedit, pilih **Simpan perubahan**. Untuk keluar tanpa menyimpan pilih Bu ** ang perubahan**.
------
#### [ API ]
Saat Anda membuat [RetrieveAndGenerate](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) permintaan, sertakan `guardrailConfiguration` bidang di dalam `generationConfiguration` untuk menggunakan pagar pembatas Anda dengan permintaan. Untuk melihat lokasi bidang ini, lihat badan [RetrieveAndGenerate](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html) permintaan di referensi API.
Objek JSON berikut menunjukkan bidang minimal yang diperlukan [ GenerationConfiguration ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GenerationConfiguration.html) untuk mengatur`guardrailConfiguration`:
```
"generationConfiguration": {
"guardrailConfiguration": {
"guardrailId": "{{string}}",
"guardrailVersion": "{{string}}"
}
}
```
Tentukan `guardrailId` pagar `guardrailVersion` pembatas pilihan Anda.
------
## Peringkat ulang
Anda dapat menggunakan model reranker untuk melakukan rangking ulang hasil dari kueri basis pengetahuan. Ikuti langkah-langkah konsol di[Kueri basis pengetahuan dan ambil data](kb-test-retrieve.md). Saat Anda membuka ** panel ** Konfigurasi, perluas bagian ** Reranking**. Pilih model reranker, perbarui izin jika perlu, dan ubah opsi tambahan apa pun. Masukkan prompt dan pilih ** Run ** untuk menguji hasil setelah rangking ulang.