方法介绍
delete_conversation 用于删除 L0 原始对话消息。功能说明如下：删除方式：支持按
message_ids 精确删除（单次 1–100 条），或按 session_ids（数组，可传入多个会话 ID）删除多个会话下的全部消息，或按 session_id（单个字符串，已废弃）删除单个会话下的全部消息。三者至少提供一项。推荐使用 session_ids 替代 session_id。不可逆：删除为不可逆操作，被删除的消息将从 L0 存储中移除。
说明：
Memory 抽取为增量式，已沉淀的记忆不会因原始消息删除而回退。
导入
from tencentdb_agent_memory.v3 import MemoryClient
方法签名
def delete_conversation(self,*,message_ids: Optional[List[str]] = None,session_ids: Optional[List[str]] = None,session_id: Optional[str] = None, # 已废弃，推荐使用 session_ids) -> Dict[str, Any]
使用示例
按消息 ID 删除
from tencentdb_agent_memory.v3 import MemoryClientwith MemoryClient(endpoint="https://memory.tdai.tencentyun.com",api_key="sk-xxxxxxxxxxxxxxxx",service_id="tdai-mem-xxxxxxxx",team_id="team-abc123",agent_id="agt-xyz789",user_id="usr-456",) as client:result = client.delete_conversation(message_ids=["msg-aaaa", "msg-bbbb", "msg-cccc"], # 可选，待删除的消息 ID 列表)print(f"已删除 {result['deleted_count']} 条消息")
按会话删除全部消息
result = client.delete_conversation(session_ids=["agent-main:sess-old", "agent-main:sess-expired"], # 删除指定会话下全部消息)print(f"已删除 {result['deleted_count']} 条消息")
请求参数
参数名 | 类型 | 必填 | 描述说明 |
message_ids | List[str] | 否 | 待删除的消息 id 列表，单次 1–100 条 |
session_ids | List[str] | 否 | 删除多个会话下全部消息（推荐） |
session_id | str | 否 | 删除该会话下全部消息（已废弃，推荐使用 session_ids） |
响应示例
{"deleted_count": 3}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
deleted_count | int | 成功删除的消息数量 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | message_ids 和 session_id 均未提供 | 确保至少提供一项 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
422 | 构造参数缺失 | 确保构造时传入必填归属参数 |
