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

一、接口介绍

按主键批量删除原子记忆。传入要删除的原子记忆主键列表，系统精确删除一组目标：

·删除范围：通过 ids 传入主键数组（必填，非空），单次至多 100 条。

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

项	值
HTTP 方法与路径	POST /v2/atomic/delete
HTTP 文档	按 id 批量删除原子记忆
函数签名	delete_atomic(ids)

注意：说明：

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

二、使用示例

# 先查再删的两步流程query_resp = client.query_atomic(type="episodic", limit=10)ids = [item["id"] for item in query_resp["data"]["items"]]if ids: del_resp = client.delete_atomic(ids=ids) print(f"实际删除 {del_resp['deleted_count']} 条")

注意：说明：

注意：client 实例的构造方式参见新建客户端；异步调用时将方法前加 await 即可。

三、请求参数

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

四、返回信息

返回字典包含本次实际删除的条数与请求追踪 ID：

{ "deleted_count": 2, "trace_id": "tr-xxxxxxxx-xxxxxxxx"}

字段名	类型	说明
deleted_count	int	实际成功删除的原子记忆条数。
trace_id	str	请求追踪 ID。用于全链路日志排查。该值与 HTTP 响应头中的 x-trace-id 保持一致，是审计大批量高危删除行为的核心凭证。

五、错误处理

错误码	触发场景	处理建议
400	ids 为空数组、单次超过 100 条。	请分批删除后重试。
500	服务端错误。	记录 trace_id 后重试或上报。