一、接口介绍
·目标定位：通过 path 指定场景记忆的完整路径（必填），该路径必须已存在。
·正文覆盖：通过 content 传入更新后的全量正文（必填，整体覆盖旧内容，不做 diff / merge）。
·摘要更新：通过 summary 传入该场景记忆的一句话摘要（可选）；字段缺省表示本次不更新摘要，显式传入空串 "" 则代表清空摘要。
注意：说明：
注意：写入语义仅为"更新"、不支持"新增"。若目标 path 不存在或不属于当前调用上下文，统一返回业务错误码 404，不会自动创建场景记忆——场景记忆的创建路径由系统自动沉淀产生（来自原始对话与原子记忆的聚合），无法直接通过此接口建档。
二、Method 与 URL
POST https://{服务访问地址}/v2/scenario/write
三、使用示例
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/write \\ -d '{ "path": "工作/交付物/2026Q1.md", "content": "# 2026Q1 交付物清单\\n\\n- 项目 A：4 月 15 日交付（已完成）\\n- 项目 B：4 月 28 日交付（进行中）\\n- 项目 C：5 月 10 日交付（新增）", "summary": "2026Q1 交付物清单更新，新增项目 C。" }'
注意：说明：
注意：鉴权说明：所有接口都必须在请求头中携带 Authorization: Bearer <API Key> 与 x-tdai-service-id: <Service_ID>，否则将返回鉴权失败。
四、请求参数
| 参数名 | 类型 | 必填 | 描述说明 |
| path | str | 是 | 目标场景记忆文件的完整路径。说明：必须传入一个已存在的有效全路径（如 "工作/交付物/2026Q1.md"），若路径不存在，接口将报错。 |
| content | str | 是 | 新的记忆全量正文。传入更新后的完整文本（通常为 Markdown 格式）。说明：该操作为全量覆盖，会直接替换原文件中的所有内容。 |
| summary | str | 否 | 文件的一句话摘要/简介。用于调整或重置大模型为该文件生成的摘要。其传值规则如下：不更新：传 None（或不传该字段），系统将保留原摘要不变。清空：显式传入空字符串 ""，系统将彻底清除原摘要。 |
五、响应示例
{ "code": 0, "message": "ok", "request_id": "req-7fd3b2dd", "data": { "path": "工作/交付物/2026Q1.md", "updated_at": "2026-04-21T08:30:15Z" }}
| 字段 | 类型 | 说明 |
| path | str | 确认被成功更新的场景记忆文件全路径。 |
| updated_at | str | 系统最新的更新时间戳（ISO 8601 格式），代表该文件内容或摘要被成功覆盖的时间。 |