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

delete_atomic

最近更新时间:2026-08-27 17:42:04
我的收藏

方法介绍

delete_atomic 用于按笔记 id 批量删除 L1 原子记忆笔记。功能说明如下:
删除方式:按笔记 id 删除,单次最少 1 条、最多 100 条。
不可逆:删除为不可逆操作,被删除的笔记将从 L1 存储中移除。

导入

from tencentdb_agent_memory.v3 import MemoryClient

方法签名

def delete_atomic(
self,
ids: List[str],
*,
session_id: Optional[str] = None,
) -> Dict[str, Any]

使用示例

from tencentdb_agent_memory.v3 import MemoryClient

with MemoryClient(
endpoint="https://memory.tdai.tencentyun.com",
api_key="sk-xxxxxxxxxxxxxxxx",
service_id="tdai-mem-xxxxxxxx",
team_id="team-abc123",
agent_id="agt-xyz789",
user_id="usr-456",
) as client:
result = client.delete_atomic(
["note-xxxx", "note-yyyy", "note-zzzz"], # 必填,待删除的笔记 ID 列表(位置参数)
)
print(f"已删除 {result['deleted_count']} 条笔记")

请求参数

参数名
类型
必填
描述说明
ids
List[str]
待删除的笔记 id 列表,单次 1–100 条(位置参数)
session_id
str
会话 ID,限定删除范围

响应示例

{
"deleted_count": 3
}

Running Environment

Operating System: Ubuntu 24.04.3 LTS / x86_64

Runtime Version: Python 3.11.1

响应参数说明

参数名
类型
参数含义
deleted_count
int
成功删除的笔记数量

错误码

错误码
触发场景
处理建议
400
ids 为空或超过 100 条
检查 ids 长度
401
API Key 无效或过期
检查 api_key 配置
422
构造参数缺失
确保构造时传入必填归属参数