# 메모리 레코드 검색
<a name="long-term-retrieve-records"></a>

[RetrieveMemoryRecords](https://docs.aws.amazon.com/bedrock-agentcore/latest/APIReference/API_RetrieveMemoryRecords.html) API를 사용하여 추출된 메모리를 검색할 수 있습니다. 이 작업을 사용하면 의미 체계 쿼리를 기반으로 추출된 메모리 레코드를 검색할 수 있으므로 에이전트의 메모리에서 관련 정보를 쉽게 찾을 수 있습니다.

## 필수 파라미터
<a name="retrieve-records-parameters"></a>

`RetrieveMemoryRecords` 작업에는 다음 키 파라미터가 필요합니다.

 **memoryId**   
검색하려는 레코드가 포함된 메모리 리소스의 식별자입니다.

 **네임스페이스**   
메모리 레코드가 저장되는 정확한 네임스페이스입니다. 작업은 제공된 네임스페이스와 일치하는 네임스페이스에 페이지가 매겨진 메모리 레코드를 반환합니다.

 **namespacePath**   
메모리 레코드가 저장되는의 네임스페이스 경로입니다. 작업은 제공된 네임스페이스 계층 구조 아래에 제공된 경로로 시작하는 페이지가 지정된 메모리 레코드를 반환합니다.

 **searchCriteria**   
검색 파라미터를 포함하는 구조:  
+  *searchQuery* - 관련 메모리(최대 10,000자)를 찾는 데 사용되는 의미 체계 쿼리 텍스트입니다.
+  *memoryStrategyId*(선택 사항) - 검색을 특정 전략에 의해 생성된 메모리로 제한합니다.
+  *topK* - 반환할 가장 관련성이 높은 결과의 최대 수입니다(기본값: 10, 최대: 100).

## 응답 형식
<a name="retrieve-records-response"></a>

작업은 검색 기준과 일치하는 메모리 레코드 요약 목록을 반환합니다. 각 요약에는 임베딩 벡터의 코사인 유사성에서 파생된 *관련성 점수*가 포함됩니다. 이 점수는 백분율 일치를 **** 나타내지 않지만 대신 두 벡터가 고차원 공간에서 얼마나 근접하게 정렬되는지 측정합니다. 점수가 높을수록 메모리 레코드와 검색 쿼리의 관련성이 높음을 나타냅니다. 결과는 페이지 매김되며 기본값은 페이지당 최대 100개의 결과입니다. `nextToken` 파라미터를 사용하여 결과의 추가 페이지를 검색할 수 있습니다.

## 모범 사례
<a name="retrieve-records-best-practices"></a>

메모리를 검색할 때는 다음 모범 사례를 고려하세요.
+ 찾고 있는 정보를 명확하게 설명하는 특정 검색 쿼리를 생성합니다.
+ `topK` 파라미터를 사용하여 애플리케이션의 요구 사항에 따라 결과 수를 제어합니다.
+ 큰 메모리로 작업할 때는 페이지 매김을 구현하여 모든 관련 결과를 효율적으로 처리합니다.
+ 특정 추출 전략의 메모리가 필요한 `memoryStrategyId` 경우를 기준으로 필터링하는 것이 좋습니다.

검색되면 이러한 메모리 레코드를 에이전트의 컨텍스트에 통합하여 보다 개인화되고 컨텍스트에 맞는 응답을 제공할 수 있습니다.