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

LangGraph 代理程式的語意長期記憶體

LangGraph 會分隔兩種類型的代理程式狀態。短期狀態是對話執行緒本身，檢查點程式會持續存在，以便執行緒可以繼續、重播和復原 （請參閱 使用 DynamoDB 做為 LangGraph 代理程式的檢查點存放區)。長期記憶體是代理程式跨執行緒知道的，LangGraph 將其建模為存放區：代理程式刻意寫入並稍後讀取的命名空間鍵值表面。

在 langgraph-checkpoint-aws 套件中， DynamoDBStore類別是該存放區的 DynamoDB 實作。它使用階層式命名空間處理鍵值端、過期記憶體的存留時間，以及基本篩選。設定向量索引後 （請參閱 在 DynamoDB 中使用向量索引)，其search()方法會執行語意搜尋：記憶體會在寫入時內嵌、非同步編製索引，並依意義叫用，並依相似性進行排名，從保留它們的相同資料表進行排序。沒有要佈建的個別向量資料庫，也沒有管道將資料複製到其中。

先決條件

使用 pip 安裝程式庫：

pip install langgraph langgraph-checkpoint-aws langchain-aws

設定 存放區

使用 index區塊設定存放區並呼叫 setup()：

from langchain_aws import BedrockEmbeddings
from langgraph_checkpoint_aws import DynamoDBStore

store = DynamoDBStore(
    table_name="support-agent-memory",
    region_name="us-east-1",
    index={
        "embed": BedrockEmbeddings(model_id="amazon.titan-embed-text-v2:0"),
        "dims": 1024,
        "fields": ["text"],
        "distance_function": "COSINE",
    },
)

store.setup()

index 區塊中的四個設定值得了解：

setup() 會在資料表不存在時建立資料表、連接向量索引，並在您設定時啟用存留時間。在現有資料表上，它只會新增遺失的項目，因此現有DynamoDBStore部署可以採用語意搜尋，而無需重新建立資料表或遷移項目。請記住，在索引報告ACTIVE且不再回填之前， setup()不會傳回：在回填ACTIVE時報告 的索引會拒絕SearchVectors呼叫。在新的空白資料表上，等待時間很短。只要回填需要的時間，即可在具有現有項目的資料表上重新調整。

寫入記憶體

撰寫是一般 put()。內嵌會為您進行：

namespace = ("memories", "acme-corp", "user-8812")

store.put(namespace, "mem-1", {
    "text": "Account runs a proxy that closes idle sockets after 60 seconds",
    "source": "ticket-4471",
})
store.put(namespace, "mem-2", {
    "text": "Customer prefers email, asked not to be called by phone",
    "source": "ticket-4471",
})
store.put(namespace, "mem-3", {
    "text": "Uses a custom build of the SDK pinned to version 2.14",
    "source": "ticket-4502",
})

依意義叫用

客戶開啟新的對話，並說他們的連線在大約一分鐘後持續下降：

results = store.search(
    namespace,
    query="connection drops after a minute of inactivity",
    limit=3,
)

for item in results:
    print(round(item.score, 3), item.value["text"])

輸出：

0.324 Account runs a proxy that closes idle sockets after 60 seconds
0.039 Customer prefers email, asked not to be called by phone
0.031 Uses a custom build of the SDK pinned to version 2.14

相關的記憶體會先排名，且查詢中沒有任何索引鍵符合任何項目。 SearchItem.score遵循 LangGraph 慣例，其中較高者更為相關。DynamoDB 會傳回距離，其中下限更接近，因此存放區會轉換：COSINE對於分數為 1 - distance，對於EUCLIDEAN分數為 1 / (1 + distance)，而DOT_PRODUCT分數會保持不變。如果您進入絕對分數以判斷記憶體是否足以插入提示，請針對您自己的資料和您選擇的距離函數校正該閾值。

使用搜尋結構描述的範圍記憶體

當 DynamoDBStore建立向量索引時，它會將資料表的分割區索引鍵宣告為索引搜尋結構描述中的HASH元素。由於存在該元素，因此每次搜尋都必須提供其條件，而 存放區會提供命名空間：命名空間元組會聯結以形成分割區索引鍵值，因此每次語意搜尋都會固定到剛好一個命名空間。三個後果如下：

下表摘要說明如何選擇命名空間形狀。

避免將每個記憶體放在一個命名空間中，並在中繼資料上進行篩選：在 DynamoDB 已在整個命名空間中選擇最接近的相符項目之後套用篩選條件，且單一搜尋最多傳回前 100 個相符項目，因此一旦一個忙碌租用戶填滿常見查詢的前 100 個，即使存在其記憶體，安靜租用戶的搜尋仍會傳回少於請求的結果。對於決定正確性的任何項目，偏好透過篩選條件進行命名空間範圍調整。比您的召回界限更精細也是一種合法的設計：需要使用者特定和全帳戶內容的代理程式會同時搜尋命名空間並合併結果。

考量事項

其他資源