接口介绍
本接口(
/scenario/delete)用于按完整路径删除一份场景记忆。通过 path 指定目标,系统按指向类型执行删除:目标定位:通过
path 指定要删除的完整路径(必填)。支持文件与目录:
path 既可指向场景记忆文件(如 工作/交付物/2026Q1.md),也可指向目录(以 / 结尾,如 工作/交付物/);删除目录时按系统约定的递归策略处理。Method 与 URL
POST https://{服务访问地址}/v2/scenario/delete
使用示例
curl -i -k -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer ******************************' \\-H "x-tdai-service-id: mem-8i8t****" \\https://memory.tdai.tencentyun.com/v2/scenario/delete \\-d '{"path": "工作/交付物/2026Q1.md"}'
说明:
鉴权说明:所有接口都必须在请求头中携带
Authorization: Bearer <API Key> 与 x-tdai-service-id: <Service_ID>,否则将返回鉴权失败。请求参数
参数名 | 类型 | 必填 | 描述说明 |
path | str | 是 | 目标场景记忆的全路径(支持文件或目录)。系统会严格根据路径末尾是否包含斜杠 / 来判定删除行为,请谨慎传入: 单文件删除(末尾不带 /):例如 "工作/交付物/2026Q1.md",此时仅删除该指定文件。 目录级递归删除(末尾带 /):例如 "工作/交付物/",此时将彻底删除该目录及其下的所有子文件与子文件夹(高危操作,请务必前置二次确认)。 |
响应示例
{"code": 0,"message": "ok","path": "工作/交付物/2026Q1.md","deleted_count": 1}
字段 | 类型 | 说明 |
path | str | 被成功执行删除操作的目标路径。 |
deleted_count | int | 整数类型,代表本次操作实际删除的文件总条数。 若执行的是单文件删除(路径不带 /),该值通常为 1。 若执行的是目录级递归删除(路径带 /),该值会显示该目录下被一并清空的所有文件总数(如 12),便于客户端向用户展示“已成功清理 X 个文件”的提示。 |