方法介绍
delete_conversation 用于删除 L0 原始对话消息。功能说明如下：删除方式：支持按
message_ids 精确删除（单次 1–100 条），或按 session_id 删除某会话下的全部消息。二者至少提供一项，也可同时提供（此时按 message_ids 精确删除，额外携带 session_id 限定会话范围）。注意：若构造时已绑定 session_id，按 message_ids 删除时会自动携带该 session_id。不可逆：删除为不可逆操作，被删除的消息将从 L0 存储中移除。
说明：
已基于该消息抽取出的 L1/L2/L3 记忆不受影响——Memory 抽取为增量式，已沉淀的记忆不会因原始消息删除而回退。
导入
from tencentdb_agent_memory.v3 import MemoryClient
使用示例
按消息 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"],)print(f"已删除 {result['deleted_count']} 条消息")
按 session 删除全部消息
result = client.delete_conversation(session_id="agent-main:sess-old",)
请求参数
参数名 | 类型 | 必填 | 描述说明 |
message_ids | List[str] | 否 | 待删除的消息 id 列表，单次1 – 100条 |
session_id | str | 否 | 删除该会话下全部消息 |
说明：
message_ids 和 session_id 至少提供一个，可同时传入；均不提供时 API 返回 400。响应示例
{"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 | 构造参数缺失 | 确保构造时传入必填归属参数 |
