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

rm_scenario

最近更新时间:2026-07-28 10:20:02

我的收藏

方法介绍

rm_scenario 用于按文件路径删除 L2 场景记忆文件(单路径删除)。功能说明如下:
删除方式:每次删除单个 path 指定的文件,需要批量删除时须多次调用。
不可逆:删除为不可逆操作,被删除文件的全部版本历史将一并移除。

导入

from tencentdb_agent_memory.v3 import MemoryClient

使用示例

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.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
构造参数缺失
确保构造时传入必填归属参数