帮你快速理解、总结文档立即下载

批量删除原始对话消息

最近更新时间:2026-11-06 17:47:00
我的收藏

接口介绍

本接口(/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
}
}

响应参数说明

请求失败时,请检查 HTTP 状态码及响应中的 code、message,并保留 request_id 用于排查。错误含义与处理建议见 错误码。
参数名(一级)
参数名(二级)
参数含义
data
deleted_count
成功删除的消息数量。