更新时间：2026-09-14 GMT+08:00
管理会话
记忆的读写操作都在会话上下文中进行。每次对话开始前，需要创建一个会话。
创建会话
创建一个会话，用于承载一次对话的短期记忆。会话可绑定用户、助手等归属信息。
session_data = client.create_memory_session(
space_id="记忆库ID",
actor_id="user-001",
assistant_id="assistant-001"
)
session_id = session_data.id 参数说明：
- space_id：记忆库ID。
- actor_id：终端用户的唯一标识，用于按用户隔离记忆。
- assistant_id：Agent的标识。
- 同一个用户的不同会话应使用相同的actor_id，这样长期记忆才能跨会话共享。
- 不同用户必须使用不同的actor_id，否则记忆数据会串扰。
- 建议使用业务系统中的用户ID作为 actor_id。
获取会话信息
查询会话的详情或列表，用于恢复会话上下文或管理会话。
# 查询单个会话详情
session_data = client.show_memory_session(
space_id="记忆库ID",
session_id="会话ID"
)
# 查询会话列表
session_list = client.list_memory_sessions(
space_id="记忆库ID",
actor_id="user-001", # 可选
limit=20, # 可选
offset=0 # 可选
) | 参数 | 说明 | 约束 |
|---|---|---|
| space_id | 记忆库ID（必填，路径参数） | — |
| actor_id | 按Actor ID过滤（可选） | 1~64 字符 |
| limit | 每页数量（可选） | 1~20，默认 20 |
| offset | 偏移量（可选），从第几条开始返回（跳过前 offset 条），配合 limit 实现分页 | 0~2147483647，默认 0 |
关闭会话
关闭（删除）会话。关闭后会话不可再写入或查询消息，会话中的消息按空间配置的保留期异步清理。
client.delete_memory_session(
space_id="记忆库ID",
session_id="会话ID"
) 注意事项
关闭会话为逻辑删除，会话内的消息不会立即清除，将按空间配置的保留期异步清理。若业务涉及数据删除合规要求，请知悉该行为。
父主题： 在Agent中集成记忆库
