方法介绍
rm_scenario 用于按文件路径删除 L2 场景记忆文件(单路径删除)。功能说明如下:删除方式:每次删除单个
path 指定的文件,需要批量删除时须多次调用。不可逆:删除为不可逆操作,被删除文件的全部版本历史将一并移除。
导入
from tencentdb_agent_memory.v3 import MemoryClient
使用示例
from tencentdb_agent_memory.v3 import MemoryClientwith 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.rm_scenario(path="product-review/2025-q3-draft",)print(f"已删除 {result['deleted_count']} 个文件")
批量删除(多次调用)
paths = ["product-review/2025-q3-draft", "product-review/2025-q2-notes"]for p in paths:client.rm_scenario(path=p)
请求参数
参数名 | 类型 | 必填 | 描述说明 |
path | str | 是 | 待删除的文件路径 |
响应示例
{"deleted_count": 1}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
deleted_count | int | 成功删除的文件数量(单路径删除时固定为 1) |
错误码
错误码 | 触发场景 | 处理建议 |
400 | path 为空 | 检查 path 参数 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
404 | 文件不存在或无权访问 | 检查路径是否正确 |
422 | 构造参数缺失 | 确保构造时传入必填归属参数 |