本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 查詢連線至 Amazon Neptune Analytics 圖形的知識庫
<a name="kb-test-neptune"></a>

您可以查詢使用 Amazon Neptune Analytics 圖形的知識庫，並僅傳回資料來源的相關文字。在此查詢中，使用 [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_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html) 請求，例如使用標準知識庫。如需有關查詢知識庫、擷取資料和產生回應的資訊，請參閱：
+  [查詢知識庫並擷取資料](kb-test-retrieve.md) 
+  [查詢知識庫並根據擷取的資料產生回應](kb-test-retrieve-generate.md) 

使用 Amazon Neptune Analytics 圖形從知識庫傳回的回應結構與標準 [KnowledgeBaseRetrievalResult](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_KnowledgeBaseRetrievalResult.html) 相同。不過，回應也包含來自 Amazon Neptune 的幾個額外欄位。

下表說明您在傳回的回應中可能看到的 Neptune Analytics 欄位。Amazon Bedrock 會從 Neptune Analytics 回應中取得這些欄位。如果該回應不包含這些欄位，則從 Amazon Bedrock 傳回的查詢結果也不會包含這些欄位。


| 欄位 | 說明 | 
| --- | --- | 
|  x-amz-bedrock-kb-source-uri  |  傳回文件的 Amazon S3 URL。  | 
|  分數  |  表示回應與所提供查詢相符程度的差距，其中較低的值表示較相符。  | 
|  x-amz-bedrock-kb-data-source-id  |  用於知識庫的資料來源 ID。  | 
|  x-amz-bedrock-kb-chunk-id  |  用來擷取查詢資訊並產生回應的區塊 ID。  | 
|  DocumentAttributes  |  Amazon Kendra 的文件屬性或中繼資料欄位。知識庫傳回的查詢結果會將這些結果存放為中繼資料鍵值對。您可以使用來自 Amazon Bedrock 的中繼資料篩選來篩選結果。  | 

## 使用中繼資料和篩選
<a name="kb-test-neptune-metadata"></a>

當您查詢知識庫並產生回應時，您可以篩選中繼資料以尋找更相關的文件。例如，您可以根據文件的發佈日期進行篩選。您可以使用 Amazon Bedrock 主控台或執行時期 API [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) 來達成此目的，這可以指定一些一般篩選條件。

以下是針對 Neptune Analytics 圖形使用 `RetrievalFilter` API 的一些考量。
+ 不支援 `startsWith` 和 `listContains` 篩選條件。
+ 不支援 `stringContains` 篩選條件的清單變體。

如下列範例所示：

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