接口介绍
按主键批量删除原子记忆。传入要删除的原子记忆主键列表，系统精确删除一组目标：
删除范围：通过
ids 传入主键数组（必填，非空），单次至多 100 条。不支持条件批删：仅支持按
id 精确删除，不接受按 type / 时间区间等条件批量删除——原子记忆是经系统抽取后的细粒度沉淀产物，按条件批删容易牵连无关历史语义；可先通过 query_atomic 或 search_atomic 获取目标 id 后再执行删除。项 | 值 |
HTTP 方法与路径 | POST /v2/atomic/delete |
HTTP 文档 | |
函数签名 | 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']} 条")
说明：
请求参数
参数名 | 类型 | 必填 | 描述说明 |
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 后重试或上报。 |
