接口介绍
本接口（
/scenario/write）用于全量覆盖一份已存在的场景记忆。通过 path 定位目标，传入新的全量正文，系统按"全量覆盖"语义替换旧内容：目标定位：通过
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 格式），代表该文件内容或摘要被成功覆盖的时间。 |
