腾讯云数据库 AI 服务 按 id 批量删除原子记忆笔记

本接口(/atom/delete)用于按主键批量删除原子记忆。通过 ids 传入要删除的原子记忆主键列表,系统精确删除一组目标。

相关产品
腾讯云数据库 AI 服务 产品页,含版本规格、价格与购买入口。

一、接口介绍

·删除范围:通过 ids 传入主键数组(必填,非空),单次至多 100 条。

·不支持条件批删:仅支持按 id 精确删除,不接受按 type / 时间区间等条件批量删除——原子记忆是经系统抽取后的细粒度沉淀产物,按条件批删容易牵连无关历史语义;可先通过 POST /atom/query 或 POST /atom/search 获取目标 id 后再执行删除。

注意:说明:

注意:ids 为空数组视为非法请求,返回业务错误码 400,避免空入参导致整个租户全量数据被删。服务端执行删除前会独立比对归属字段,不属于当前调用上下文的 id 静默跳过,不计入 deleted_count。

二、Method 与 URL

POST https://{服务访问地址}/v2/atom/delete

三、使用示例

curl -i -k -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer ******************************' \\ -H "x-tdai-service-id: mem-8i8t****" \\ https://memory.tdai.tencentyun.com/v2/atom/delete \\ -d '{ "ids": ["note-3a7b9c1d", "note-4e8d2f60", "note-5f9e3a71"] }'

注意:说明:

注意:鉴权说明:所有接口都必须在请求头中携带 Authorization: Bearer <API Key> 与 x-tdai-service-id: <Service_ID>,否则将返回鉴权失败。

四、请求参数

参数名 类型 必填 描述说明
ids List[str] 是 原子记忆 ID 列表。需要进行批量处理的原子记忆唯一主键数组。数量限制:单次请求最多支持传入 100 条 ID。约束条件:传入的数组不能为空(不可传空数组 [])。

五、响应示例

{ "code": 0, "message": "ok", "request_id": "req-7fd3b2dd", "data": { "deleted_count": 5 }}

字段名 类型 说明
deleted_count int 实际成功删除的原子记忆条数。
赞 (0)
上一篇 4天前
下一篇 4天前