接口介绍
本接口(
/v3/conversation/delete)用于按消息 ID 批量删除 L0 原始对话消息。功能说明如下:删除方式:支持按
message_ids 精确删除(单次 1–100 条),也可按 session_id 删除某会话下的全部消息,二者至少提供一项。不管按哪种方式删除,都需携带 session_id 参数(若未显式传入则使用该实例下与 message 绑定的 session_id)。不可逆:删除为不可逆操作,被删除的消息将从 L0 存储中移除。
Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/conversation/delete
使用示例
curl -i -k -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 '{"message_ids":["msg-aaaa","msg-bbbb","msg-cccc"]}'
说明:
所有接口都必须在请求头中携带
Authorization: Bearer <API Key> 与 x-tdai-service-id: <实例 ID>,否则将返回鉴权失败。请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
message_ids | 是 | 待删除的消息 ID 列表。 | 数据类型:Array of String。 数量限制:单次最少 1 条,最多支持 100 条。 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"deleted_count":3}}
响应参数说明
参数名(一级) | 参数名(二级) | 参数含义 |
data | deleted_count | 成功删除的消息数量。 |