Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Gunakan model reranker di Amazon Bedrock Anda dapat menggunakan model reranker secara langsung atau saat mengambil hasil selama kueri basis pengetahuan. Pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya: ------ #### [ Console ] Anda tidak dapat menggunakan model reranker secara langsung di Konsol Manajemen AWS, tetapi Anda dapat menggunakan model reranker saat menanyakan basis pengetahuan Anda dengan melakukan hal berikut: 1. Saat Anda menanyakan basis pengetahuan, buka panel **Konfigurasi** dengan memilih ikon. ![Icon showing three horizontal sliders at different positions for adjusting settings.](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/configurations.png) 1. Perluas bagian **Reranking**. 1. Pilih **Pilih model** dan pilih model reranker. 1. Jika peran layanan Amazon Bedrock Knowledge Bases Anda tidak memiliki [izin untuk menggunakan model reranker](rerank-prereq.md), pilih **Perbarui peran layanan untuk mengubah peran** dengan izin yang tepat. 1. (Opsional) Di bagian **Opsi Reranking Tambahan**, ubah opsi apa pun yang Anda butuhkan. 1. Masukkan prompt dan pilih **Jalankan**. Responsnya adalah hasil setelah menerapkan model reranker. Untuk petunjuk lebih rinci tentang melakukan kueri basis pengetahuan, lihat [Kueri basis pengetahuan dan ambil data](kb-test-retrieve.md) dan[Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md). ------ #### [ API ] Untuk petunjuk tentang penggunaan model reranker selama kueri basis pengetahuan, lihat [Kueri basis pengetahuan dan ambil data](kb-test-retrieve.md) dan. [Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md) Untuk menggunakan model reranker secara langsung dengan Amazon Bedrock API, kirim permintaan [Rerank](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rerank.html) dengan titik akhir waktu proses Agen [untuk Amazon](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt) Bedrock. Bidang berikut diperlukan: **** | Bidang | Deskripsi dasar | | --- | --- | | pertanyaan | Sebuah array dari satu [RerankQuery](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankQuery.html)objek. Tentukan TEXT sebagai type dan sertakan kueri di textQuery lapangan. | | sumber | Array [RerankSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankSource.html)objek untuk dikirimkan ke model reranking. Untuk masing-masingRerankSource, tentukan INLINE sebagai type dan sertakan [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html)objek di inlineDocumentSource lapangan. Lihat di bawah untuk detailnyaRerankDocument. | | RerankingConfiguration | Termasuk Amazon Resource Name (ARN) dari model reranking yang akan digunakan, dan jumlah hasil yang akan dikembalikan setelah pencatatan ulang, dan, secara opsional, konfigurasi inferensi untuk model. Anda menentukan konfigurasi model tambahan sebagai pasangan nilai kunci. Untuk informasi lebih lanjut, lihat [Rerank](https://docs.cohere.com/reference/rerank) di situs web Cohere dokumentasi. | Bidang berikut adalah opsional: **** | Bidang | Kasus penggunaan | | --- | --- | | nextToken | Token dikembalikan dalam respons sebelumnya yang dapat Anda sertakan untuk memberikan kumpulan hasil berikutnya. | Format `RerankSource` objek yang Anda sertakan tergantung pada format dokumen. Untuk melihat format untuk berbagai `RerankSource` jenis, pilih tab yang sesuai dengan format dokumen: ------ #### [ String ] Jika dokumen adalah string, maka tentukan nilai `type` bidang [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html)objek sebagai `TEXT` dan sertakan dokumen di `text` lapangan. Contoh: ``` { "inlineDocumentSource": { "textDocument": { "text": "string" }, "type": "TEXT" }, "type": "INLINE" } ``` ------ #### [ JSON object ] Jika dokumen adalah objek JSON, maka tentukan nilai `type` bidang dalam [RerankDocument](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankDocument.html)objek sebagai `JSON` dan sertakan dokumen di `jsonDocument` bidang. Contoh: ``` { "inlineDocumentSource": { "jsonDocument": JSON value, "type": "JSON" }, "type": "INLINE" } ``` ------ Respons terhadap `Rerank` permintaan Anda mengembalikan daftar [RerankResult](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RerankResult.html)objek di `results` bidang. Setiap objek berisi bidang-bidang berikut: + `document`— Termasuk informasi tentang dokumen yang Anda kirimkan. + `relevanceScore`— Skor relevansi untuk dokumen, yang ditetapkan oleh model reranking. + `index`— Menunjukkan peringkat dokumen relatif terhadap dokumen lain dalam daftar. Semakin rendah skor, semakin tinggi peringkatnya. Jika ada terlalu banyak hasil untuk ditampilkan, maka respons mengembalikan nilai di `nextToken` bidang. Dalam hal ini, untuk melihat kumpulan hasil berikutnya, sertakan token itu dalam permintaan berikutnya. **Contoh kode** Contoh berikut menunjukkan cara memanggil API Rerank menggunakan AWS SDK. ------ #### [ Python ] ``` import boto3 client = boto3.client('bedrock-agent-runtime', region_name='us-east-1') response = client.rerank( queries=[{ 'type': 'TEXT', 'textQuery': {'text': 'What is Amazon Bedrock?'} }], sources=[ { 'type': 'INLINE', 'inlineDocumentSource': { 'type': 'TEXT', 'textDocument': {'text': 'Amazon Bedrock is a fully managed service for foundation models.'} } }, { 'type': 'INLINE', 'inlineDocumentSource': { 'type': 'TEXT', 'textDocument': {'text': 'Amazon S3 is an object storage service.'} } } ], rerankingConfiguration={ 'type': 'BEDROCK_RERANKING_MODEL', 'bedrockRerankingConfiguration': { 'modelConfiguration': { 'modelArn': 'arn:aws:bedrock:us-east-1::foundation-model/cohere.rerank-v3-5:0' }, 'numberOfResults': 2 } } ) for result in response['results']: print(f'Index: {result["index"]}, Score: {result["relevanceScore"]}') ``` ------ #### [ Node.js ] ``` import { BedrockAgentRuntimeClient, RerankCommand } from "@aws-sdk/client-bedrock-agent-runtime"; const client = new BedrockAgentRuntimeClient({ region: "us-east-1" }); const response = await client.send(new RerankCommand({ queries: [{ type: "TEXT", textQuery: { text: "What is Amazon Bedrock?" } }], sources: [ { type: "INLINE", inlineDocumentSource: { type: "TEXT", textDocument: { text: "Amazon Bedrock is a fully managed service for foundation models." } } }, { type: "INLINE", inlineDocumentSource: { type: "TEXT", textDocument: { text: "Amazon S3 is an object storage service." } } } ], rerankingConfiguration: { type: "BEDROCK_RERANKING_MODEL", bedrockRerankingConfiguration: { modelConfiguration: { modelArn: "arn:aws:bedrock:us-east-1::foundation-model/cohere.rerank-v3-5:0" }, numberOfResults: 2 } } })); for (const result of response.results) { console.log(`Index: ${result.index}, Score: ${result.relevanceScore}`); } ``` ------ ------