Update add_message.md

Author: dolnna

content/cn/memos_cloud/mem_operations/add_message.md

@@ -1,5 +1,5 @@
 ---
-title: 添加消息
+title: Add Message
 desc: MemOS 会将您添加的多模态内容如文本、文件、图片等，自动处理为可检索的个人记忆。
 ---
 
@@ -44,8 +44,6 @@ desc: MemOS 会将您添加的多模态内容如文本、文件、图片等，
 
 *   **消息（messages）**：用于添加到 MemOS 的用户与 AI 对话内容的有序消息列表。
 
-*   **元信息（info）**：由您自定义的、随消息一同提交的补充信息，可用于后续记忆检索时进行过滤。
-    
 
 ## 3. 工作原理
 
@@ -94,9 +92,9 @@ print(f"result: {res.json()}")
 想知道生成了哪些记忆？一键复制上述代码并运行，前往[**检索记忆**](/memos_cloud/mem_operations/search_memory)。
 :::
 
-## 5. 使用场景
+## 5. 更多使用方法
 
-### 5.1 实时导入对话
+### 实时导入对话
 
 你可以在用户每次收到模型回复时，实时调用接口添加消息，随时与 MemOS 同步用户与助手的对话。MemOS将在后端不断根据新的对话，更新用户记忆。
 
@@ -138,7 +136,9 @@ add_message("memos_user_123", "memos_conversation_123",
 
 ```
 
-### 5.2 导入历史对话
+<br>
+
+### 导入历史对话
 
 如果你已经构建了 AI 对话应用，MemOS 也支持批量导入已有聊天记录，帮助对话助手记住用户，更个性化地回复。
 
@@ -154,7 +154,9 @@ add_message("memos_user_123", "memos_conversation_123",
 ]
 ```
 
-### 5.3 记录用户偏好或行为
+<br>
+
+### 记录用户偏好或行为
 
 除了导入对话内容，用户的个人偏好、行为等数据，例如首次启动应用时填写的兴趣问卷信息，同样可以导入 MemOS，作为记忆的一部分。
 
@@ -180,6 +182,100 @@ add_message("memos_user_123", "memos_conversation_123",
 ]
 ```
 
+<br>
+
+### 配合记忆过滤器添加消息
+MemOS 支持开发者针对自己的需求从选定的记忆范围中召回记忆。在添加消息时，使用以下字段对生成的记忆进行标记，就能在检索记忆时使用[记忆过滤器（filter）](/memos_cloud/features/basic/filters)完成精确过滤。
+
+
+1. **同一个用户与多 Agent （在多个应用内）聊天**
+
+添加消息时带上 `agent_id` `app_id` 等信息，标识当前与用户对话所关联的 Agent、应用，用来区分“同一用户在不同 Agent / App 下的记忆”。
+
+```python
+data = {
+  "user_id": "memos_user_123",
+  "agent_id":"health_assistant", #开发者传入的当前对话的 agent。
+  "conversation_id": 0610,
+  "messages":[
+    {"role": "user", "content": "我今天早上跑了5公里，膝盖有点酸"}, 
+    {"role": "assistant", "content": "你今天跑了5公里，膝盖有点酸，说明关节和肌肉还在适应强度。明天建议把距离控制在3公里左右，重点放在充分热身和放松。"
+    }
+  ]
+}
+
+# 在后续检索中，您可以传入"agent_id":"health_assistant"来检索用户与该助手聊天的记忆。
+```
+
+<br>
+
+2. **用已有的标签体系，对记忆进行语义分类**
+
+MemOS 会为每条记忆自动生成标签，但这些标签可能与您业务中所使用的标签不完全一致。您可以在添加消息时带上自定义的`tags`，MemOS 将基于您提供的标签含义，对记忆内容自动应用相关标签。
+
+```python
+data = {
+  "user_id": "memos_user_123",
+  "conversation_id": 0610,
+  "tags":["运动建议","健身规划","运动记录"], #开发者传入的对“健身助手话题分类”的自定义标签。
+  "messages":[
+    {"role": "user", "content": "我今天早上跑了5公里，膝盖有点酸"}, 
+    {"role": "assistant", "content": "你今天跑了5公里，膝盖有点酸，说明关节和肌肉还在适应强度。明天建议把距离控制在3公里左右，重点放在充分热身和放松。"
+    }
+  ]
+}
+
+# 在后续检索中，您可以传入"tags":"运动建议"来检索围绕“运动建议”的用户记忆。
+```
+
+::note
+如果你想了解更多，详见[自定义标签](/memos_cloud/features/basic/custom_tags)
+::
+
+<br>
+
+3. **使用自带的业务信息，精确过滤**
+
+添加消息时带上`info`，传入更多结构化的业务字段或自定义补充信息，例如`scene = 订单`等，用来按照业务维度精确区分当前的场景、业务线、来源、状态等等。
+
+
+```python
+data = {
+  "user_id": "memos_user_123",
+  "conversation_id": 0610,
+  "messages":[
+    {"role": "user", "content": "帮我查找时间合适的机票"}, 
+    {"role": "assistant", "content": "我帮你查到了几班时间合适的航班：\n1. 北京 → 上海，2月15日08:30出发，12:30到达\n2. 北京 → 上海，2月15日14:00出发，18:00到达\n3. 北京 → 上海，2月16日09:00出发，13:00到达\n你希望我帮你预订哪一班，或者需要我筛选其他条件吗？"
+    }
+  ],
+  "info":{
+    "scene":"机票"
+  }
+}
+
+# 在后续检索中，您可以传入"info":{"scene":"机票"}来检索围绕“机票购买”业务场景的用户记忆。
+```
+
+<br>
+
+**使用提示**
+
+`info`支持传入任意自定义键值对，所有字段均可正常存储和检索。
+
+当前系统对以下字段提供了更优的查询性能支持（因为这些字段已经添加索引）：
+- business_type（业务类型）
+- biz_id（业务唯一标识）
+- scene（业务或对话场景）
+- custom_status（自定义状态）
+
+是否使用上述字段并非强制要求，使用其他自定义字段在功能上完全一致，仅在检索性能上可能有所差异。
+
+::note 注意
+info 为扁平化的键值对结构，字段名和字段值均需为字符串类型，用于在检索时进行条件过滤；非字符串值需先转换为字符串再传入。
+::
+
+<br>
+
 ## 6. 更多功能
 
 :::note
@@ -188,10 +284,7 @@ add_message("memos_user_123", "memos_conversation_123",
 
 | **功能** | **字段** | **说明** |
 | --- | --- | --- |
-| 关联更多实体 | `agent_id` `app_id` | 当前用户的对话消息关联 Agent、应用等实体的唯一标识符，便于后续按实体维度检索记忆。 |
-| 消息 | `messages` | 用于添加的对话消息列表。<br>支持的角色类型包括：user / assistant / system / tool；<br>支持的消息类型包括：<br>• 文本<br>• 文档、图片，详见[多模态消息](/memos_cloud/features/basic/multimodal)。<br>• 工具调用信息，详见[工具调用](/memos_cloud/features/advanced/tool_calling)。 |
+| 多模态消息 | `messages` | 用于添加的对话消息列表。<br>支持的角色类型包括：user / assistant / system / tool；<br>支持的消息类型包括：<br>• 文本<br>• 文档、图片，详见[多模态消息](/memos_cloud/features/basic/multimodal)。<br>• 工具调用信息，详见[工具调用](/memos_cloud/features/advanced/tool_calling)。 |
 | 异步模式 | `async_mode` | 控制添加消息后的处理方式，支持异步与同步两种模式，详见[异步模式](/memos_cloud/features/basic/async_mode)。 |
-| 自定义标签 | `tags` | 为当前用户的对话消息添加自定义标签，用于后续记忆检索与过滤，例如检索时的"图召回"和其他内部推理的节点召回，详见[自定义标签](/memos_cloud/features/basic/custom_tags)。 |
-| 元信息 | `info` | 自定义元信息字段，用于补充当前用户的对话消息，并在后续记忆检索中作为过滤条件使用。<br><br>`info` 支持传入任意自定义键值对，所有字段均可正常存储和检索。<br><br>当前系统对以下字段提供了更优的查询性能支持（因为这些字段已经添加索引）：<br>• `business_type`（业务类型）<br>• `biz_id`（业务唯一标识）<br>• `scene`（业务或对话场景）<br>• `custom_status`（自定义状态）<br><br>是否使用上述字段并非强制要求，使用其他自定义字段在功能上完全一致，仅在检索性能上可能有所差异。<br><br>注意 info 为扁平化的键值对结构，字段名和字段值均需为字符串类型，用于在检索时进行条件过滤；非字符串值需先转换为字符串再传入。 |
 | 写入公共记忆 | `allow_public` | 控制当前用户对话消息生成的记忆是否要写入项目级公共记忆，供项目下所有用户共享，默认关闭。 |
 | 写入知识库记忆 | `allow_knowledgebase_ids` | 控制当前用户对话消息生成的记忆是否写入指定的项目关联的知识库中，供所有可访问该知识库的用户共享。默认为空，使用时您可以将需要写入的知识库列表传入。详见[知识库](/memos_cloud/features/advanced/knowledge_base)。 |