帮你快速理解、总结文档立即下载

Memory SDK 方法总览

最近更新时间:2026-08-27 17:42:02
我的收藏
MemoryClientAsyncMemoryClient 共享完全相同的 18 个数据面方法,覆盖 L0–L3 四层记忆的读写、检索、删除和统计操作。
说明:
同步 / 异步用法一致:下方所有方法在 MemoryClient 中直接调用,在 AsyncMemoryClient 中加 await 调用,参数和返回结构完全一致。

L0 原始对话

L0 层提供对话记录的写入、分页查询、语义检索、批量删除和统计能力。
方法
说明
文档
add_conversation
追加对话记录
query_conversation
分页查询对话记录
search_conversation
语义检索对话记录
delete_conversation
批量删除对话记录
count_conversation
统计对话记录数量

L1 原子记忆

L1 层提供原子记忆的更新、分页查询、语义检索、批量删除和统计能力。原子记忆由系统从 L0 对话中自动抽取生成,也支持通过 update_atomic 手动干预。
方法
说明
文档
update_atomic
更新原子记忆
query_atomic
分页查询原子记忆
search_atomic
语义检索原子记忆
delete_atomic
批量删除原子记忆
count_atomic
统计原子记忆数量

L2 场景记忆

L2 层提供场景记忆文件的列出、读取、写入、删除和统计能力。场景记忆以路径(path)为唯一标识,支持类文件系统的层级管理。
方法
说明
文档
list_scenarios
列出场景记忆文件
read_scenario
读取场景记忆内容
write_scenario
写入场景记忆内容
rm_scenario
删除场景记忆文件
count_scenario
统计场景记忆数量

L3 核心记忆

L3 层提供核心记忆的读取、写入和统计能力。核心记忆为最高层级的结构化长期记忆,由系统从 L1/L2 中归纳生成,也支持手动写入。
方法
说明
文档
read_core
读取核心记忆
write_core
写入核心记忆
count_core
统计核心记忆数量