Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Kueri basis pengetahuan yang terhubung ke grafik Amazon Neptunus Analytics
<a name="kb-test-neptune"></a>

Anda dapat menanyakan basis pengetahuan yang menggunakan grafik Amazon Neptunus Analytics, dan hanya menampilkan teks yang relevan dari sumber data. Untuk kueri ini, kirim [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 dengan [titik akhir runtime Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt), seperti dengan basis pengetahuan standar. Untuk informasi tentang menanyakan basis pengetahuan dan mengambil data dan menghasilkan tanggapan, lihat:
+  [Kueri basis pengetahuan dan ambil data](kb-test-retrieve.md) 
+  [Kueri basis pengetahuan dan hasilkan tanggapan berdasarkan data yang diambil](kb-test-retrieve-generate.md) 

Struktur respons yang dikembalikan dari basis pengetahuan dengan grafik Amazon Neptunus Analytics, sama dengan standar. [ KnowledgeBaseRetrievalResult](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalResult.html) Namun, tanggapannya juga mencakup beberapa bidang tambahan dari Amazon Neptunus.

Tabel berikut menjelaskan bidang dari Neptunus Analytics yang mungkin Anda lihat dalam respons yang dikembalikan. Amazon Bedrock mendapatkan bidang ini dari respons Neptunus Analytics. Jika respons tersebut tidak berisi bidang ini, maka hasil kueri yang dikembalikan dari Amazon Bedrock juga tidak akan memiliki bidang ini.


| Bidang | Deskripsi | 
| --- | --- | 
|  x-amz-bedrock-kb-sumber-uri  |  URL Amazon S3 dari dokumen yang dikembalikan.  | 
|  skor  |  Ukuran jarak yang menunjukkan seberapa dekat respons cocok dengan kueri yang disediakan, di mana nilai yang lebih rendah menunjukkan kecocokan yang lebih baik.  | 
|  x-amz-bedrock-kb-data-source-id  |  ID sumber data yang digunakan untuk basis pengetahuan.  | 
|  x-amz-bedrock-kb-potongan-id  |  ID potongan yang digunakan untuk mengambil informasi untuk kueri dan menghasilkan respons.  | 
|  DocumentAttributes  |  Atribut dokumen atau bidang metadata dari Amazon Kendra. Hasil kueri yang dikembalikan dari basis pengetahuan menyimpan ini sebagai pasangan nilai kunci metadata. Anda dapat memfilter hasil dengan pemfilteran metadata dari Amazon Bedrock.  | 

## Menggunakan metadata dan penyaringan
<a name="kb-test-neptune-metadata"></a>

Saat Anda menanyakan basis pengetahuan dan menghasilkan respons, Anda dapat memfilter metadata untuk menemukan dokumen yang lebih relevan. Misalnya, Anda dapat memfilter berdasarkan tanggal publikasi dokumen. Anda dapat menggunakan konsol Amazon Bedrock atau API runtime [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrievalFilter.html)untuk tujuan ini, yang dapat menentukan beberapa kondisi filter umum.

Berikut ini adalah beberapa pertimbangan untuk menggunakan `RetrievalFilter` API untuk grafik Neptunus Analytics.
+ `listContains`Filter `startsWith` dan tidak didukung.
+ Varian daftar `stringContains` filter tidak didukung.

Berikut ini menunjukkan contoh:

```
"vectorSearchConfiguration": {
        "numberOfResults": 5,
        "filter": {
            "orAll": [
                {
                    "andAll": [
                        {
                            "equals": {
                                "key": "genre",
                                "value": "entertainment"
                            }
                        },
                        {
                            "greaterThan": {
                                "key": "year",
                                "value": 2018
                            }
                        }
                    ]
                },
                {
                    "andAll": [                        
                        {
                            "startsWith": {
                                "key": "author",
                                "value": "C"
                            }
                        }
                    ]
                }
            ]
        }
    }
}
```