擷取記憶體記錄
您可以使用 RetrieveMemoryRecords API 擷取擷取的記憶體。此操作可讓您根據語意查詢搜尋擷取的記憶體記錄，讓您輕鬆從代理程式的記憶體中找到相關資訊。
必要參數
RetrieveMemoryRecords 操作需要下列金鑰參數：
- memoryId
-
記憶體資源的識別符，其中包含您要擷取的記錄。
- 命名空間
-
存放記憶體記錄的確切命名空間。操作會在與提供的命名空間相符的命名空間中傳回分頁記憶體記錄。
- namespacePath
-
存放記憶體記錄的命名空間路徑。操作會在提供的命名空間階層下傳回以提供的路徑開頭的分頁記憶體記錄。
- searchCriteria
-
包含搜尋參數的結構：
-
searchQuery - 用於尋找相關記憶體的語意查詢文字 （最多 10，000 個字元）。
-
memoryStrategyId （選用） - 將搜尋限制為特定策略建立的記憶體。
-
topK - 要傳回的最相關結果數目上限 （預設值：10，上限：100)。
-
回應格式
操作會傳回符合您搜尋條件的記憶體記錄摘要清單。每個摘要都包含相關性分數 ，這是衍生自內嵌向量的餘弦相似性。此分數不代表百分比相符，而是測量兩個向量在高維度空間中對齊的程度。分數越高表示記憶體記錄與搜尋查詢的相關性越大。結果會分頁，預設每頁最多 100 個結果。您可以使用 nextToken 參數來擷取其他結果頁面。
最佳實務
擷取記憶體時，請考慮下列最佳實務：
-
製作特定的搜尋查詢，清楚描述您要尋找的資訊。
-
使用
topK參數，根據應用程式的需求來控制結果的數量。 -
使用大型記憶體時，請實作分頁以有效率地處理所有相關結果。
-
當您需要特定擷取策略的記憶體
memoryStrategyId時，請考慮依 篩選。
擷取後，這些記憶體記錄可以整合到代理程式的內容中，讓回應更具個人化和上下文意識。
