# 管理会话
记忆的读写操作都在会话上下文中进行。每次对话开始前，需要创建一个会话。
#### 创建会话
创建一个会话，用于承载一次对话的短期记忆。会话可绑定用户、助手等归属信息。
```
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的标识。
![](https://support.huaweicloud.com/highcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
- 同一个用户的不同会话应使用相同的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"
)
```
#### 注意事项
关闭会话为逻辑删除，会话内的消息不会立即清除，将按空间配置的保留期异步清理。若业务涉及数据删除合规要求，请知悉该行为。