기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Neptune Analytics 그래프에 연결된 지식 기반 쿼리
Amazon Neptune Analytics 그래프를 사용하는 지식 기반을 쿼리하고 데이터 소스에서 관련 텍스트만 반환할 수 있습니다. 이 쿼리의 경우 표준 지식 기반과 같이 [Amazon Bedrock Agents 런타임 엔드포인트](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에서 메타데이터 필터링으로 결과를 필터링할 수 있습니다. |
## 메타데이터 및 필터링을 사용합니다
지식 기반을 쿼리하고 응답을 생성할 때 메타데이터를 기준으로 필터링하여 더 관련성이 높은 문서를 찾을 수 있습니다. 예를 들어 문서의 게시 날짜를 기준으로 필터링할 수 있습니다. 이 목적으로 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) API는 몇 가지 일반 필터 조건을 지정할 수 있습니다.
다음은 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"
}
}
]
}
]
}
}
}
```