Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil **penting** Guardrails diterapkan hanya untuk input dan respon yang dihasilkan dari LLM. Mereka tidak diterapkan pada referensi yang diambil dari Pangkalan Pengetahuan saat runtime. Setelah basis pengetahuan Anda disiapkan, Anda dapat melakukan kueri dan menghasilkan respons berdasarkan potongan yang diambil dari data sumber Anda dengan menggunakan operasi API. [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) Tanggapan dikembalikan dengan kutipan ke data sumber asli. Anda juga dapat [menggunakan model reranking](rerank.md) alih-alih ranker Amazon Bedrock Knowledge Bases default untuk memberi peringkat potongan sumber untuk relevansi selama pengambilan. **Batasan konten multimodal** `RetrieveAndGenerate`memiliki dukungan terbatas untuk konten multimodal. Saat menggunakan Nova Multimodal Embeddings, fungsionalitas RAG dibatasi hanya untuk konten teks. Untuk dukungan multimodal penuh termasuk pemrosesan audio dan video, gunakan BDA dengan model penyematan teks. Lihat perinciannya di [Membangun basis pengetahuan untuk konten multimodal](kb-multimodal.md). **catatan** Gambar yang dikembalikan dari `Retrieve` respons selama `RetrieveAndGenerate` aliran disertakan dalam prompt untuk pembuatan respons. `RetrieveAndGenerate`Respons tidak dapat menyertakan gambar, tetapi dapat mengutip sumber yang berisi gambar. Untuk mempelajari cara menanyakan basis pengetahuan Anda, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya: ------ #### [ Console ] **Untuk menguji basis pengetahuan Anda** 1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock). 1. Di panel navigasi kiri, pilih **Basis pengetahuan**. 1. Di bagian **Basis pengetahuan**, lakukan salah satu tindakan berikut: + Pilih tombol radio di sebelah basis pengetahuan yang ingin Anda uji dan pilih **Uji basis pengetahuan**. Jendela uji mengembang dari kanan. + Pilih basis pengetahuan yang ingin Anda uji. Jendela uji mengembang dari kanan. 1. Untuk menghasilkan tanggapan berdasarkan informasi yang diambil dari basis pengetahuan Anda, aktifkan **Hasilkan tanggapan untuk kueri Anda**. Amazon Bedrock akan menghasilkan tanggapan berdasarkan sumber data Anda dan mengutip informasi yang diberikannya dengan catatan kaki. 1. Untuk memilih model yang akan digunakan untuk menghasilkan respons, pilih **Pilih model**. Kemudian pilih **Terapkan**. 1. (Opsional) Pilih ikon konfigurasi (![\[Three horizontal sliders with adjustable circular controls for settings or parameters.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/configurations.png)) untuk membuka **Konfigurasi**. Untuk informasi tentang konfigurasi, lihat[Konfigurasikan dan sesuaikan kueri dan pembuatan respons](kb-test-config.md). 1. Masukkan kueri di kotak teks di jendela obrolan dan pilih **Jalankan** untuk mengembalikan respons dari basis pengetahuan. 1. Pilih catatan kaki untuk melihat kutipan dari sumber yang dikutip untuk bagian respons tersebut. Pilih tautan untuk menavigasi ke objek S3 yang berisi file. 1. Untuk melihat detail tentang potongan yang dikembalikan, pilih **Tampilkan detail sumber**. + Untuk melihat konfigurasi yang Anda tetapkan untuk kueri, perluas **konfigurasi Kueri**. + Untuk melihat detail tentang potongan sumber, perluas dengan memilih panah kanan (![\[Play button icon with a triangular shape pointing to the right.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/caret-right-filled.png)) di sebelahnya. Anda dapat melihat informasi berikut: + Teks mentah dari potongan sumber. Untuk menyalin teks ini, pilih ikon salin (![\[Icon representing a crop or resize function, with two overlapping rectangles.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/copy.png)). Jika Anda menggunakan Amazon S3 untuk menyimpan data Anda, pilih ikon tautan eksternal (![\[Icon of a square with an arrow pointing outward from its top-right corner.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/external.png)) untuk menavigasi ke objek S3 yang berisi file. + Metadata yang terkait dengan potongan sumber, jika Anda menggunakan Amazon S3 untuk menyimpan data Anda. attribute/field Kunci dan nilai didefinisikan dalam `.metadata.json` file yang terkait dengan dokumen sumber. Untuk informasi selengkapnya, lihat bagian **Metadata dan pemfilteran** di. [Konfigurasikan dan sesuaikan kueri dan pembuatan respons](kb-test-config.md) **Opsi obrolan** + Untuk menggunakan model yang berbeda untuk menghasilkan respons, Pilih **Ubah model**. Jika Anda mengubah model, teks di jendela obrolan akan sepenuhnya dihapus. + **Beralih ke mengambil potongan sumber secara langsung dengan membersihkan Hasilkan respons.** Jika Anda mengubah pengaturan, teks di jendela obrolan akan sepenuhnya dihapus. + Untuk menghapus jendela obrolan, pilih ikon sapu (![\[Magnifying glass icon with a checkmark inside, symbolizing search or inspection.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/broom.png)). + Untuk menyalin semua output di jendela obrolan, pilih ikon salin (![\[Icon representing a crop or resize function, with two overlapping rectangles.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/copy.png)). ------ #### [ API ] Untuk menanyakan basis pengetahuan dan menggunakan model dasar untuk menghasilkan respons berdasarkan hasil dari sumber data, kirim [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 dengan titik akhir [waktu proses Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). [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 mengembalikan data dalam format streaming dan memungkinkan Anda mengakses respons yang dihasilkan dalam potongan tanpa menunggu seluruh hasilnya. Bidang berikut diperlukan: **catatan** Respons API berisi peristiwa kutipan. `citation`Anggota sudah tidak digunakan lagi. Kami menyarankan Anda menggunakan `retrievedReferences` bidang `generatedResponse` dan sebagai gantinya. Untuk referensi, lihat [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_CitationEvent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_CitationEvent.html). **** | Bidang | Deskripsi dasar | | --- | --- | | input | Berisi text bidang untuk menentukan kueri. | | retrieveAndGenerateKonfigurasi | Berisi [RetrieveAndGenerateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateConfiguration.html), yang menentukan konfigurasi untuk pengambilan dan pembuatan. Lihat di bawah untuk lebih jelasnya. | Bidang berikut adalah opsional: **** | Bidang | Kasus penggunaan | | --- | --- | | sessionId | Gunakan nilai yang sama dengan sesi sebelumnya untuk melanjutkan sesi itu dan mempertahankan konteksnya untuk model. | | SessionConfiguration | Untuk menyertakan kunci KMS kustom untuk enkripsi sesi. | Sertakan `knowledgeBaseConfiguration` bidang di [RetrieveAndGenerateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerateConfiguration.html). Bidang ini memetakan ke [KnowledgeBaseRetrieveAndGenerateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrieveAndGenerateConfiguration.html)objek, yang berisi bidang-bidang berikut: + Bidang berikut diperlukan: **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/kb-test-retrieve-generate.html) + Bidang berikut adalah opsional: **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/kb-test-retrieve-generate.html) Anda dapat menggunakan model reranking di atas model peringkat Basis Pengetahuan Amazon Bedrock default dengan menyertakan `rerankingConfiguration` bidang di [KnowledgeBaseVectorSearchConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseVectorSearchConfiguration.html)dalam. [KnowledgeBaseRetrievalConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalConfiguration.html) `rerankingConfiguration`Bidang memetakan ke [VectorSearchRerankingConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_VectorSearchRerankingConfiguration.html)objek, di mana Anda dapat menentukan model reranking yang akan digunakan, bidang permintaan tambahan apa pun yang akan disertakan, atribut metadata untuk memfilter dokumen selama penanking ulang, dan jumlah hasil yang akan dikembalikan setelah pencatatan ulang. Untuk informasi selengkapnya, lihat [VectorSearchRerankingConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_VectorSearchRerankingConfiguration.html). **catatan** Jika Anda `numberOfRerankedResults` nilai yang Anda tentukan lebih besar dari `numberOfResults` nilai dalam [KnowledgeBaseVectorSearchConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseVectorSearchConfiguration.html), jumlah maksimum hasil yang akan dikembalikan adalah nilai untuk`numberOfResults`. Pengecualian adalah jika Anda menggunakan dekomposisi kueri (untuk informasi selengkapnya, lihat bagian **modifikasi kueri** di[Konfigurasikan dan sesuaikan kueri dan pembuatan respons](kb-test-config.md). Jika Anda menggunakan dekomposisi kueri, `numberOfRerankedResults` bisa sampai lima kali. `numberOfResults` Respons mengembalikan respons yang dihasilkan di `output` lapangan dan potongan sumber yang dikutip sebagai array di lapangan. `citations` Setiap objek [Citation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Citation.html) berisi bidang-bidang berikut. **** | Bidang | Deskripsi dasar | | --- | --- | | generatedResponsePart | Di textResponsePart lapangan, kutipan text yang berkaitan dengan disertakan. spanBidang menyediakan indeks untuk awal dan akhir bagian output yang memiliki kutipan. | | RetrievedReferences | Array [RetrievedReference](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievedReference.html)objek, yang masing-masing berisi potongan sumber, metadata terkait dengan dokumen, dan URI atau URL location dokumen dalam sumber data. content Jika konten adalah gambar, URI data dari konten yang disandikan base64 dikembalikan dalam format berikut:. data:image/jpeg;base64,\$1\$1base64-encoded string\$1 | Respons juga mengembalikan `sessionId` nilai, yang dapat Anda gunakan kembali dalam permintaan lain untuk mempertahankan percakapan yang sama. Jika Anda memasukkan a `guardrailConfiguration` dalam permintaan, `guardrailAction` bidang memberi tahu Anda apakah konten diblokir atau tidak. Jika data yang diambil berisi gambar, respons juga mengembalikan header respons berikut, yang berisi metadata untuk potongan sumber yang dikembalikan dalam respons: + `x-amz-bedrock-kb-byte-content-source`— Berisi URI Amazon S3 dari gambar. + `x-amz-bedrock-kb-description`— Berisi string yang dikodekan base64 untuk gambar. **catatan** Anda tidak dapat memfilter header respons metadata ini saat [mengonfigurasi](kb-test-config.md) filter metadata. ------ **catatan** Jika Anda menerima kesalahan bahwa prompt melebihi batas karakter saat menghasilkan respons, Anda dapat mempersingkat prompt dengan cara berikut: Kurangi jumlah maksimum hasil yang diambil (ini mempersingkat apa yang diisi untuk placeholder \$1search\$1results\$1 di). [Templat prompt basis pengetahuan: orkestrasi & pembuatan](kb-test-config.md#kb-test-config-prompt-template) Buat ulang sumber data dengan strategi chunking yang menggunakan potongan yang lebih kecil (ini mempersingkat apa yang diisi untuk placeholder \$1search\$1results\$1 di). [Templat prompt basis pengetahuan: orkestrasi & pembuatan](kb-test-config.md#kb-test-config-prompt-template) Mempersingkat template prompt. Persingkat kueri pengguna (ini mempersingkat apa yang diisi untuk placeholder \$1query\$1 di). [Templat prompt basis pengetahuan: orkestrasi & pembuatan](kb-test-config.md#kb-test-config-prompt-template)