Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Konfigurasikan dan sesuaikan kueri dan pembuatan respons
Anda dapat mengonfigurasi dan menyesuaikan pengambilan dan generasi respons, yang lebih meningkatkan relevansi respons. 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, kecuali untuk **Orkestrasi dan pembuatan, hanya berlaku untuk sumber** data yang 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 hasil aktual dalam respons mungkin kurang dari `numberOfResults` nilai yang ditentukan, karena parameter ini menetapkan jumlah hasil maksimum yang akan dikembalikan. Jika Anda telah mengonfigurasi chunking hierarkis untuk strategi chunking Anda, `numberOfResults` parameter akan memetakan ke jumlah potongan anak yang akan diambil oleh basis pengetahuan. Karena potongan anak 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 hasil maksimum 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) atau[Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md). Di panel **Konfigurasi**, perluas bagian **potongan Sumber dan masukkan jumlah maksimum potongan** sumber yang akan dikembalikan.
------
#### [ API ]
Saat Anda membuat [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html)atau [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html)meminta, 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 badan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html)permintaan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html)dan permintaan dalam 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 untuk kembali:
```
"retrievalConfiguration": {
"vectorSearchConfiguration": {
"numberOfResults": number
}
}
```
Tentukan jumlah maksimum hasil yang diambil (lihat `numberOfResults` bidang [KnowledgeBaseRetrievalConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalConfiguration.html)untuk rentang nilai yang diterima) untuk kembali di `numberOfResults` bidang.
------
## Jenis pencarian
Jenis pencarian menentukan bagaimana sumber data dalam basis pengetahuan ditanyakan. Jenis pencarian berikut dimungkinkan:
**catatan**
Pencarian hibrida hanya didukung untuk penyimpanan vektor Amazon RDS, Amazon OpenSearch Tanpa Server, dan MongoDB yang berisi bidang teks yang dapat difilter. Jika Anda menggunakan penyimpanan vektor yang berbeda atau penyimpanan vektor Anda tidak berisi bidang teks yang dapat difilter, kueri menggunakan pencarian semantik.
+ **Default** — Amazon Bedrock memutuskan strategi pencarian untuk Anda.
+ **Hybrid** — Menggabungkan embeddings vektor pencarian (pencarian semantik) dengan mencari melalui teks mentah.
+ **Semantik** — Hanya mencari embeddings vektor.
Untuk mempelajari cara menentukan jenis pencarian, 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) atau[Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md). Saat Anda membuka panel **Konfigurasi**, perluas bagian **Jenis pencarian**, aktifkan Ganti **pencarian default**, dan pilih opsi.
------
#### [ API ]
Saat Anda membuat [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html)atau [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html)meminta, 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 badan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html)permintaan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html)dan permintaan dalam 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 konfigurasi jenis pencarian:
```
"retrievalConfiguration": {
"vectorSearchConfiguration": {
"overrideSearchType": "HYBRID | SEMANTIC"
}
}
```
Tentukan jenis pencarian di `overrideSearchType` bidang. Anda memiliki opsi berikut:
+ Jika Anda tidak menentukan nilai, Amazon Bedrock memutuskan strategi pencarian mana yang paling cocok untuk konfigurasi penyimpanan vektor Anda.
+ **HYBRID** — Amazon Bedrock menanyakan basis pengetahuan menggunakan penyematan vektor dan teks mentah.
+ **SEMANTIK** — Amazon Bedrock menanyakan basis pengetahuan menggunakan penyematan vektornya.
------
## Streaming
------
#### [ Console ]
Ikuti langkah-langkah konsol di[Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md). Saat Anda membuka panel **Konfigurasi**, perluas bagian **preferensi Streaming** dan aktifkan respons **Streaming**.
------
#### [ API ]
Untuk melakukan streaming respons, gunakan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateStream.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateStream.html)API. Untuk detail selengkapnya tentang mengisi kolom, lihat tab **API** di[Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md).
------
## 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.
Misalnya, “epoch\$1modification\$1time” mewakili waktu dalam jumlah detik sejak 1 Januari 1970 (UTC) ketika dokumen terakhir diperbarui. *Anda dapat memfilter data terbaru, di mana “epoch\$1modification\$1time” lebih besar dari angka tertentu.* Dokumen-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 ada di penyimpanan vektor Amazon OpenSearch Tanpa Server, periksa apakah indeks vektor dikonfigurasi dengan mesin. `faiss` 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 Tanpa Server untuk Anda.
+ [Buat indeks vektor lain](knowledge-base-setup.md) di toko 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 kluster database Amazon Aurora, sebaiknya berikan nama bidang kolom metadata khusus untuk menyimpan semua metadata Anda dalam satu kolom. Selama [konsumsi 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 menyediakan 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 basis data 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 kustom 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 tipe data (teks, angka, atau boolean). Misalnya, jika atribut `genre` ada di sumber data Anda, Anda akan menambahkan kolom bernama `genre` dan menentukan `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 Tanpa Server untuk toko vektor Anda: Basis pengetahuan Amazon Bedrock akan menghasilkan nomor halaman dokumen dan menyimpannya dalam field/attribute metadata yang disebut -. x-amz-bedrock-kb document-page-number* Perhatikan bahwa nomor halaman yang disimpan dalam bidang metadata tidak didukung jika Anda memilih tidak ada chunking untuk dokumen Anda.
Anda dapat menggunakan operator pemfilteran berikut untuk memfilter hasil saat Anda melakukan kueri:
**Operator penyaringan**
| Operator | Konsol | Nama filter API | Tipe 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, nomor, boolean | Atribut cocok dengan nilai yang Anda berikan |
| Tidak sama | \$1= | [CatatanQuals](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-notEquals) | string, nomor, boolean | Atribut tidak cocok dengan nilai yang Anda berikan |
| Lebih besar dari | > | [GreaterThan](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 | >= | [greaterThanOrSama](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 | <= | [lessThanOrSama](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 baik didukung dengan penyimpanan vektor Amazon OpenSearch Tanpa Server dan Neptunus Analytics GraphRag) |
| Tidak di | \$1: | [TidakIn](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 paling baik didukung dengan penyimpanan vektor Amazon OpenSearch Tanpa Server dan Neptunus 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 penyimpanan vektor Amazon Tanpa OpenSearch Server. Penyimpanan vektor Neptunus Analytics GraphRag mendukung varian string tetapi bukan varian daftar filter ini). |
| Daftar berisi | Tidak tersedia | [ListBerisi](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 paling baik didukung dengan penyimpanan vektor Amazon OpenSearch Tanpa Server). |
Untuk menggabungkan operator penyaringan, Anda dapat menggunakan operator logis berikut:
**Operator logis**
| Operator | Konsol | Nama bidang filter API | Hasil yang difilter |
| --- | --- | --- | --- |
| Dan | and | [danSemua](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html#bedrock-Type-agent-runtime_RetrievalFilter-andAll) | Hasil memenuhi semua ekspresi penyaringan 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 penyaringan 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) atau[Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.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 di dalam kotak. Pisahkan setiap bagian ekspresi dengan spasi putih. Tekan **Enter** untuk menambahkan filter.
Untuk daftar operator pemfilteran yang diterima, lihat tabel **Pemfilteran operator** di atas. Anda juga dapat melihat daftar operator pemfilteran ketika Anda 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"**
![\[Tambahkan satu filter.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/kb/filter-one.png)
+ Untuk menambahkan filter lain, masukkan ekspresi penyaringan lain di dalam kotak dan tekan **Enter**. Anda dapat menambahkan hingga 5 filter dalam grup.
![\[Tambahkan filter lain.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/kb/filter-more.png)
+ 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** antara dua operasi penyaringan dan pilih atau.**
![\[Ubah operasi logis antar filter.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/kb/filter-logical.png)
+ Untuk menggabungkan operator logis yang berbeda, pilih **\$1 Tambah Grup** untuk menambahkan grup filter. Masukkan ekspresi pemfilteran di grup baru. Anda dapat menambahkan hingga 5 grup filter.
![\[Tambahkan grup filter untuk menggabungkan operator logis yang berbeda.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/kb/filter-group.png)
+ ****Untuk mengubah operator logis yang digunakan di antara semua grup penyaringan, pilih menu tarik-turun AND antara dua grup filter dan pilih OR.****
![\[Ubah operasi logis antara grup filter.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/kb/filter-group-logical.png)
+ Untuk mengedit filter, pilih, ubah operasi penyaringan, dan pilih **Terapkan**.
![\[Edit filter.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/kb/filter-edit.png)
+ Untuk menghapus grup filter, pilih ikon tempat sampah (![\[Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/trash.png)) di sebelah grup. Untuk menghapus filter, pilih ikon hapus (![\[Close or cancel icon represented by an "X" symbol.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/close.png)) di sebelah filter.
![\[Hapus grup filter atau filter.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/kb/filter-delete.png)
Gambar berikut menunjukkan contoh konfigurasi filter yang mengembalikan semua dokumen yang ditulis setelah genre **2018** siapa**"entertainment"**, selain dokumen yang genre-nya **"cooking"** atau **"sports"** dan yang penulisnya dimulai**"C"**.
![\[Contoh konfigurasi filter.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/kb/filter-example.png)
------
#### [ API ]
Saat Anda membuat [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html)atau [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html)meminta, 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 badan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html)permintaan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html)dan permintaan dalam 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": {
"vectorSearchConfiguration": {
"filter": {
"": {
"key": "string",
"value": "string" | number | boolean | ["string", "string", ...]
}
}
}
}
```
1. Gunakan operator logis (lihat tabel **Operator logis** di atas) untuk menggabungkan hingga 5.
```
"retrievalConfiguration": {
"vectorSearchConfiguration": {
"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 tersebut dengan operator penyaringan lain.
```
"retrievalConfiguration": {
"vectorSearchConfiguration": {
"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": {
"vectorSearchConfiguration": {
"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 | Tipe data nilai yang didukung | Hasil yang difilter |
| --- | --- | --- |
| equals | string, nomor, boolean | Atribut cocok dengan nilai yang Anda berikan |
| notEquals | string, nomor, 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 Tanpa Server) |
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 penyaringan dalam grup |
| orAll | Daftar hingga 5 jenis filter | Hasil memenuhi setidaknya satu ekspresi penyaringan dalam grup |
Sebagai contoh, lihat [Mengirim kueri dan menyertakan filter (Ambil)](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html#API_agent-runtime_Retrieve_Example_2) dan [Kirim kueri dan sertakan filter (RetrieveAndGenerate)](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html#API_agent-runtime_RetrieveAndGenerate_Example_2).
------
## Pemfilteran metadata implisit
Amazon Bedrock Knowledge Base menghasilkan dan menerapkan filter pengambilan berdasarkan kueri pengguna dan skema metadata.
**catatan**
Fitur saat ini hanya berfungsi dengan AnthropicClaude 3.5 Sonnet.
`implicitFilterConfiguration`Ini ditentukan dalam `vectorSearchConfiguration` badan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html)permintaan. Sertakan bidang-bidang berikut:
+ `metadataAttributes`— Dalam array ini, berikan skema yang menjelaskan atribut metadata yang model akan menghasilkan filter untuk.
+ `modelArn`— ARN dari model yang akan digunakan.
Berikut ini menunjukkan contoh skema metadata yang dapat Anda tambahkan ke array di. `metadataAttributes`
```
[
{
"key": "company",
"type": "STRING",
"description": "The full name of the company. E.g. `Amazon.com, Inc.`, `Alphabet Inc.`, etc"
},
{
"key": "ticker",
"type": "STRING",
"description": "The ticker name of a company in the stock market, e.g. AMZN, AAPL"
},
{
"key": "pe_ratio",
"type": "NUMBER",
"description": "The price to earning ratio of the company. This is a measure of valuation of a company. The lower the pe ratio, the company stock is considered chearper."
},
{
"key": "is_us_company",
"type": "BOOLEAN",
"description": "Indicates whether the company is a US company."
},
{
"key": "tags",
"type": "STRING_LIST",
"description": "Tags of the company, indicating its main business. E.g. `E-commerce`, `Search engine`, `Artificial intelligence`, `Cloud computing`, etc"
}
]
```
## Pagar pembatas
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 dan filter konten yang tidak diinginkan untuk memblokir konten berbahaya dalam input dan tanggapan 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 pada Claude 3 Soneta dan Haiku.
Untuk pedoman teknik cepat umum, lihat[Konsep rekayasa yang cepat](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) atau[Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md). Di jendela pengujian, nyalakan **Hasilkan respons**. Kemudian, di panel **Konfigurasi**, perluas bagian **Guardrails**.
1. Di bagian **Guardrails**, pilih **Nama** dan **Versi** pagar pembatas Anda. **Jika Anda ingin melihat detail untuk pagar pembatas dan versi yang Anda pilih, pilih Lihat.**
Atau, Anda dapat membuat yang baru dengan memilih tautan **Guardrail**.
1. Setelah selesai mengedit, pilih **Simpan perubahan**. Untuk keluar tanpa menyimpan pilih **Buang perubahan**.
------
#### [ API ]
Saat Anda mengajukan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](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 tersebut. Untuk melihat lokasi bidang ini, lihat badan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](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 dalam [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` dan pagar `guardrailVersion` pembatas pilihan Anda.
------
## Reranking
Anda dapat menggunakan model reranker untuk merank ulang hasil dari kueri basis pengetahuan. Ikuti langkah-langkah konsol di [Kueri basis pengetahuan dan ambil data](kb-test-retrieve.md) atau[Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.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 **Jalankan** untuk menguji hasil setelah reranking.
## Dekomposisi kueri
Dekomposisi kueri adalah teknik yang digunakan untuk memecah kueri kompleks menjadi sub-kueri yang lebih kecil dan lebih mudah dikelola. Pendekatan ini dapat membantu dalam mengambil informasi yang lebih akurat dan relevan, terutama ketika kueri awal multifaset atau terlalu luas. Mengaktifkan opsi ini dapat mengakibatkan beberapa kueri dieksekusi terhadap Basis Pengetahuan Anda, yang dapat membantu dalam respons akhir yang lebih akurat.
Misalnya, untuk pertanyaan seperti *“Siapa yang mencetak gol lebih tinggi di Piala Dunia FIFA 2022, Argentina atau Prancis?*” , Basis pengetahuan Amazon Bedrock pertama-tama dapat menghasilkan sub-kueri berikut, sebelum menghasilkan jawaban akhir:
1. *Berapa banyak gol yang dicetak Argentina di final Piala Dunia FIFA 2022?*
1. *Berapa banyak gol yang dicetak Prancis di final Piala Dunia FIFA 2022?*
------
#### [ Console ]
1. Membuat dan menyinkronkan sumber data atau menggunakan basis pengetahuan yang ada.
1. Buka jendela uji dan buka panel konfigurasi.
1. Aktifkan dekomposisi kueri.
------
#### [ API ]
```
POST /retrieveAndGenerate HTTP/1.1
Content-type: application/json
{
"input": {
"text": "string"
},
"retrieveAndGenerateConfiguration": {
"knowledgeBaseConfiguration": {
"orchestrationConfiguration": { // Query decomposition
"queryTransformationConfiguration": {
"type": "string" // enum of QUERY_DECOMPOSITION
}
},
...}
}
```
------
## Parameter inferensi
Saat menghasilkan respons berdasarkan pengambilan informasi, Anda dapat menggunakan [parameter inferensi](inference-parameters.md) untuk mendapatkan kontrol lebih besar atas perilaku model selama inferensi dan memengaruhi keluaran model.
Untuk mempelajari cara memodifikasi parameter inferensi, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk memodifikasi parameter inferensi saat menanyakan basis pengetahuan** — Ikuti langkah konsol di [Kueri basis pengetahuan dan ambil data](kb-test-retrieve.md) atau. [Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md) Saat Anda membuka panel **Konfigurasi**, Anda akan melihat bagian parameter **Inferensi**. Ubah parameter seperlunya.
**Untuk mengubah parameter inferensi saat mengobrol dengan dokumen Anda** — Ikuti langkah-langkahnya di. [Mengobrol dengan dokumen Anda tanpa basis pengetahuan yang dikonfigurasi](knowledge-base-chatdoc.md) Di panel **Konfigurasi**, perluas bagian **Parameter inferensi dan ubah parameter** seperlunya.
------
#### [ API ]
Anda memberikan parameter model dalam panggilan ke [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html)API. Anda dapat menyesuaikan model dengan memberikan parameter inferensi di `inferenceConfig` bidang `knowledgeBaseConfiguration` (jika Anda menanyakan basis pengetahuan) atau `externalSourcesConfiguration` (jika Anda [mengobrol dengan dokumen Anda](knowledge-base-chatdoc.md)).
Di dalam `inferenceConfig` bidang adalah `textInferenceConfig` bidang yang berisi parameter berikut yang dapat Anda:
+ suhu
+ TopP
+ maxTokenCount
+ StopSequences
Anda dapat menyesuaikan model dengan menggunakan parameter berikut di `inferenceConfig` bidang keduanya `externalSourcesConfiguration` dan`knowledgeBaseConfiguration`:
+ suhu
+ TopP
+ maxTokenCount
+ StopSequences
Untuk penjelasan rinci tentang fungsi masing-masing parameter ini, lihat[Mempengaruhi generasi respons dengan parameter inferensi](inference-parameters.md).
Selain itu, Anda dapat memberikan parameter khusus yang tidak didukung oleh `textInferenceConfig` melalui `additionalModelRequestFields` peta. Anda dapat memberikan parameter unik untuk model tertentu dengan argumen ini, untuk parameter unik lihat[Parameter permintaan inferensi dan bidang respons untuk model dasar](model-parameters.md).
Jika parameter dihilangkan dari`textInferenceConfig`, nilai default akan digunakan. Parameter apa pun yang tidak dikenali `textInferneceConfig` akan diabaikan, sementara parameter apa pun yang tidak dikenali `AdditionalModelRequestFields` akan menyebabkan pengecualian.
Pengecualian validasi dilemparkan jika ada parameter yang sama di keduanya `additionalModelRequestFields` dan`TextInferenceConfig`.
**Menggunakan parameter model di RetrieveAndGenerate**
Berikut ini adalah contoh struktur untuk `inferenceConfig` dan `additionalModelRequestFields` di bawah `generationConfiguration` dalam badan `RetrieveAndGenerate` permintaan:
```
"inferenceConfig": {
"textInferenceConfig": {
"temperature": 0.5,
"topP": 0.5,
"maxTokens": 2048,
"stopSequences": ["\nObservation"]
}
},
"additionalModelRequestFields": {
"top_k": 50
}
```
Contoh proses menetapkan 0,5, 0,5, `temperature` `top_p` dari 2048, `maxTokens` menghentikan pembangkitan jika menemukan string "\$1nObservation” dalam respons yang dihasilkan, dan melewati nilai kustom `top_k` 50.
------
## Templat prompt basis pengetahuan: orkestrasi & pembuatan
Saat Anda menanyakan basis pengetahuan dan pembuatan respons permintaan, Amazon Bedrock menggunakan templat prompt yang menggabungkan instruksi dan konteks dengan kueri pengguna untuk membuat prompt pembuatan yang dikirim ke model untuk pembuatan respons. Anda juga dapat menyesuaikan prompt orkestrasi, yang mengubah prompt pengguna menjadi kueri penelusuran. Anda dapat merekayasa template prompt dengan alat-alat berikut:
+ **Placeholder prompt — Variabel** yang telah ditentukan sebelumnya di Pangkalan Pengetahuan Batuan Dasar Amazon yang diisi secara dinamis saat runtime selama kueri basis pengetahuan. Dalam prompt sistem, Anda akan melihat placeholder ini dikelilingi oleh simbol. `$` Daftar berikut menjelaskan placeholder yang dapat Anda gunakan:
**catatan**
`$output_format_instructions$`Placeholder adalah bidang wajib untuk kutipan yang akan ditampilkan dalam respons.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/kb-test-config.html)
+ **Tag Anthropic XML—model** mendukung penggunaan tag XMLuntuk menyusun dan menggambarkan petunjuk Anda. Gunakan nama tag deskriptif untuk hasil yang optimal. Misalnya, dalam prompt sistem default, Anda akan melihat `` tag yang digunakan untuk menggambarkan database pertanyaan yang diajukan sebelumnya). Untuk informasi selengkapnya, lihat [Menggunakan tag XMLdi](https://docs.anthropic.com/claude/docs/use-xml-tags) [panduan Anthropic pengguna](https://docs.anthropic.com/en/docs/welcome).
Untuk pedoman teknik cepat umum, lihat[Konsep rekayasa yang cepat](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) atau[Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md). Di jendela pengujian, nyalakan **Hasilkan respons**. Kemudian, di panel **Konfigurasi**, perluas bagian **template prompt dasar Pengetahuan**.
1. Pilih **Edit**.
1. Edit prompt sistem di editor teks, termasuk placeholder prompt dan tag XHTML seperlunya. Untuk kembali ke template prompt default, pilih **Reset ke default**.
1. Setelah selesai mengedit, pilih **Simpan perubahan**. Untuk keluar tanpa menyimpan prompt sistem, pilih **Buang perubahan**.
------
#### [ API ]
Saat Anda membuat [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html)permintaan, sertakan `generationConfiguration` bidang, dipetakan ke [GenerationConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GenerationConfiguration.html)objek. Untuk melihat lokasi bidang ini, lihat badan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](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 dalam [GenerationConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GenerationConfiguration.html)objek untuk mengatur jumlah maksimum hasil yang diambil untuk kembali:
```
"generationConfiguration": {
"promptTemplate": {
"textPromptTemplate": "string"
}
}
```
Masukkan template prompt kustom Anda di `textPromptTemplate` bidang, termasuk placeholder prompt dan tag XHTML seperlunya. Untuk jumlah maksimum karakter yang diizinkan dalam prompt sistem, lihat `textPromptTemplate` bidang di [GenerationConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GenerationConfiguration.html).
------