# 短期记忆操作
短期记忆以"消息（Message）"为单位存储。对话中的用户输入、Agent回复、工具调用和系统消息，均作为消息写入会话，实现对话上下文的持久化。
#### 追加消息
在Agent的对话循环中，每轮交互后追加消息。支持一次写入多条消息，便于一次性提交完整对话轮次。
```
from agentarts.sdk.memory.inner.config import TextMessage
messages = [
    TextMessage(
        role="user",
        content="你好，我想了解机器学习的基础知识",
        actor_id="user-001"
    ),
    TextMessage(
        role="assistant",
        content="机器学习是人工智能的一个分支，主要研究如何让计算机从数据中学习规律。",
        actor_id="assistant-001"
    )
]
client.add_messages(
    space_id=space_id,
    session_id=session_id,
    messages=messages
)
```
写入特性：
- 同步写入，写入后立即可读
- 批量追加在单个事务中执行，全部成功或全部失败
- 服务端自动分配递增序号（seq），保证消息顺序
- 写入后消息不可修改、不可删除
 
#### 列出消息
按会话分页查询消息列表，支持排序。
```
result = client.list_messages(
    space_id=space_id,
    session_id=session_id,
    limit=20,
    offset=0,
    order="asc",
    sort_by="seq"
)
```
参数说明：
| 参数           | 说明                                    |
|:---|:---|
| space_id     | 记忆库ID                               |
| session_id | 会话ID                                |
| limit        | 每页数量，1\~20，默认 20                      |
| offset     | 偏移量，默认0，配合limit实现分页                  |
| order      | 排序方向，asc（从旧到新，默认）/ desc（从新到旧）         |
| sort_by      | 排序字段，seq（按序号，默认）/ message_time（按消息时间） |
   
#### 查看单条消息
```
message = client.show_message(
    space_id=space_id,
    session_id=session_id,
    message_id="消息ID"
)
```