一、接口介绍
·删除方式：支持按 message_ids 精确删除（单次1 – 5000条），也可按 session_ids 删除指定会话下的全部消息（单次1 – 100个会话），二者至少提供一项，也可同时提供；无需限定单个 session。SDK 删除不会回退到构造时的 session_id，按会话删除须显式指定 session_ids（旧参数 session_id 仅作兼容并合并到 session_ids）。
·不可逆：删除为不可逆操作，被删除的消息将从 L0 存储中移除。
二、Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/conversation/delete
三、使用示例
请用实例的服务访问地址、API Key 和实例 ID 替换示例中的域名、Authorization 和 x-tdai-service-id。业务身份 ID 应与待删除消息一致。获取实例配置的方法见 接入准备。
curl -i -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ https://memory.tdai.tencentyun.com/v3/conversation/delete \\ -d '{ "team_id":"team-abc123", "user_id":"usr-456", "agent_id":"agt-xyz789", "message_ids":["msg-aaaa","msg-bbbb","msg-cccc"] }'
注意：说明：
注意：所有接口都必须在请求头中携带 Authorization: Bearer <API Key> 与 x-tdai-service-id: <实例 ID>，否则将返回鉴权失败。
SDK 调用时，team_id / user_id / agent_id 在 V3 客户端构造时必填，可通过 with_isolation() 调整，SDK 会自动注入 HTTP 请求；HTTP 是否强制校验取决于服务端严格隔离配置，可通过请求体或对应请求头提供。
四、请求参数
| 参数 | 是否必选 | 参数含义 | 配置方法及要求 |
| team_id | 是 | 团队 ID。 | 数据类型：String。 |
| user_id | 是 | 用户 ID。 | 数据类型：String。 |
| agent_id | 是 | Agent ID（全局唯一）。 | 数据类型：String。 |
| message_ids | 否（与 session_ids 至少填一项） | 待删除的消息 ID 列表。 | 数据类型：Array of String。数量限制：单次最少1条，最多支持5000条。 |
| session_ids | 否（与 message_ids 至少填一项） | 待删除的会话 ID 列表。 | 数据类型：Array of String。单次1 – 100个会话；删除这些会话下的全部消息。可与 message_ids 同时提供。 |
五、响应示例
{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "deleted_count":3 }}
六、响应参数说明
请求失败时，请检查 HTTP 状态码及响应中的 code、message，并保留 request_id 用于排查。错误含义与处理建议见 错误码。
| 参数名（一级） | 参数名（二级） | 参数含义 |
| data | deleted_count | 成功删除的消息数量。 |