接口介绍
本接口(
/v3/conversation/delete)用于按消息 ID 批量删除 L0 原始对话消息。功能说明如下:删除方式:支持按
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}}
响应参数说明
参数名(一级) | 参数名(二级) | 参数含义 |
data | deleted_count | 成功删除的消息数量。 |