MemoryClient 和 AsyncMemoryClient 共享完全相同的 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 | 统计核心记忆数量 |