腾讯云数据库 AI 服务 rm_scenario — 删除单个场景记忆

一、接口介绍

按完整路径删除一份场景记忆。通过 path 指定目标，系统按指向类型执行删除：

·目标定位：通过 path 指定要删除的完整路径（必填）。

·支持文件与目录：path 既可指向场景记忆文件（如工作/交付物/2026Q1.md），也可指向目录（以 / 结尾，如工作/交付物/）；删除目录时按系统约定的递归策略处理。

项	值
HTTP 方法与路径	POST /v2/scenario/rm
HTTP 文档	删除单个场景记忆
函数签名	rm_scenario(path)

注意：说明：

注意：path 由 JSON body 承载，无需 encodeURIComponent。若 path 不存在或不属于当前调用上下文，统一返回业务错误码 404。

二、使用示例

# 删除单个文件result = client.rm_scenario(path="工作/交付物/2026Q1.md")# 递归删除整个目录result = client.rm_scenario(path="工作/交付物/")print(f"实际删除 {result['deleted_count']} 个节点")

注意：说明：

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

三、请求参数

参数名	类型	必填	描述说明
path	str	是	目标场景记忆的全路径（支持文件或目录）。系统会严格根据路径末尾是否包含斜杠 / 来判定删除行为，请谨慎传入：单文件删除（末尾不带 /）：例如 "工作/交付物/2026Q1.md"，此时仅删除该指定文件。目录级递归删除（末尾带 /）：例如 "工作/交付物/"，此时将彻底删除该目录及其下的所有子文件与子文件夹（高危操作，请务必前置二次确认）。

四、返回信息

返回字典包含被删除路径、实际删除节点数与请求追踪 ID：

{ "path": "工作/交付物/2026Q1.md", "deleted_count": 1, "trace_id": "tr-xxxxxxxx-xxxxxxxx"}

字段	类型	说明
path	str	被成功执行删除操作的目标路径。
deleted_count	int	整数类型，代表本次操作实际删除的文件总条数。若执行的是单文件删除（路径不带 /），该值通常为 1。若执行的是目录级递归删除（路径带 /），该值会显示该目录下被一并清空的所有文件总数（如 12），便于客户端向用户展示“已成功清理 X 个文件”的提示。
trace_id	str	本次请求的全局链路追踪 ID，常用于审计高危删除行为。

五、错误处理

错误码	触发场景	处理建议
404	path 不存在或不属于当前调用上下文。	请校验路径合法性。
500	服务端错误。	记录 trace_id 后重试或上报。