메모리 레코드 검색
RetrieveMemoryRecords API를 사용하여 추출된 메모리를 검색할 수 있습니다. 이 작업을 사용하면 의미 체계 쿼리를 기반으로 추출된 메모리 레코드를 검색할 수 있으므로 에이전트의 메모리에서 관련 정보를 쉽게 찾을 수 있습니다.
필수 파라미터
RetrieveMemoryRecords 작업에는 다음 키 파라미터가 필요합니다.
- memoryId
-
검색하려는 레코드가 포함된 메모리 리소스의 식별자입니다.
- 네임스페이스
-
메모리 레코드가 저장되는 정확한 네임스페이스입니다. 작업은 제공된 네임스페이스와 일치하는 네임스페이스에 페이지가 매겨진 메모리 레코드를 반환합니다.
- namespacePath
-
메모리 레코드가 저장되는의 네임스페이스 경로입니다. 작업은 제공된 네임스페이스 계층 구조 아래에 제공된 경로로 시작하는 페이지가 지정된 메모리 레코드를 반환합니다.
- searchCriteria
-
검색 파라미터를 포함하는 구조:
-
searchQuery - 관련 메모리(최대 10,000자)를 찾는 데 사용되는 의미 체계 쿼리 텍스트입니다.
-
memoryStrategyId(선택 사항) - 검색을 특정 전략에 의해 생성된 메모리로 제한합니다.
-
topK - 반환할 가장 관련성이 높은 결과의 최대 수입니다(기본값: 10, 최대: 100).
-
응답 형식
작업은 검색 기준과 일치하는 메모리 레코드 요약 목록을 반환합니다. 각 요약에는 임베딩 벡터의 코사인 유사성에서 파생된 관련성 점수가 포함됩니다. 이 점수는 백분율 일치를 나타내지 않지만 대신 두 벡터가 고차원 공간에서 얼마나 근접하게 정렬되는지 측정합니다. 점수가 높을수록 메모리 레코드와 검색 쿼리의 관련성이 높음을 나타냅니다. 결과는 페이지 매김되며 기본값은 페이지당 최대 100개의 결과입니다. nextToken 파라미터를 사용하여 결과의 추가 페이지를 검색할 수 있습니다.
모범 사례
메모리를 검색할 때는 다음 모범 사례를 고려하세요.
-
찾고 있는 정보를 명확하게 설명하는 특정 검색 쿼리를 생성합니다.
-
topK파라미터를 사용하여 애플리케이션의 요구 사항에 따라 결과 수를 제어합니다. -
큰 메모리로 작업할 때는 페이지 매김을 구현하여 모든 관련 결과를 효율적으로 처리합니다.
-
특정 추출 전략의 메모리가 필요한
memoryStrategyId경우를 기준으로 필터링하는 것이 좋습니다.
검색되면 이러한 메모리 레코드를 에이전트의 컨텍스트에 통합하여 보다 개인화되고 컨텍스트에 맞는 응답을 제공할 수 있습니다.
