接口介绍
本接口（
/v3/scenario/write）用于全量覆盖写入指定路径下已存在的 L2 场景文件。功能说明如下：写入方式：每次写入以新内容覆盖该文件的全部内容，并生成新版本号。
摘要字段：支持传入
summary 摘要，便于在不读取全文的情况下快速浏览文件概要。Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/scenario/write
使用示例
curl -i -k -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer *********************************' \\-H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\https://memory.tdai.tencentyun.com/v3/scenario/write \\-d '{"team_id":"team-abc123","user_id":"usr-456","agent_id":"agt-xyz789","path":"work/projects/product-review.md","content":"# 产品评审\\n\\n## 2026-07-22 评审\\n\\n### 议题\\n1. V3 API 设计评审\\n2. 性能优化方案讨论\\n\\n### 决议\\n- 采用 RESTful 风格统一 V3 接口\\n- 批量操作上限统一为 100 条","summary":"2026-07-22 产品评审会：V3 API 设计定稿、性能优化方案启动"}'
请求参数
参数 | 是否必选 | 参数含义 | 配置方法及要求 |
team_id | 否 | 团队 ID。 | 数据类型：String。 |
user_id | 否 | 用户 ID。 | 数据类型：String。 |
agent_id | 否 | Agent ID（全局唯一）。 | 数据类型：String。 |
task_id | 否 | Task ID。 | 数据类型：String。 |
path | 是 | 场景文件的相对路径。 | 数据类型：String。 格式：相对路径，不带前导 /（如 work/projects/review.md），服务端会拒绝以 / 开头的路径并返回 400。指向已存在的文件。 |
content | 是 | 文件内容。 | 数据类型：String。 写入后将全量覆盖该文件的原有内容。 |
summary | 否 | 文件内容摘要。 | 数据类型：String。 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"path":"work/projects/product-review.md","version":4,"updated_at":"2026-07-22T10:00:00Z"}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | path | 写入文件的完整路径。 |
| version | 写入后的文件版本号，数值类型，从 0 开始递增。 注意： 写入与当前版本内容相同时版本号可能不增加。 |
| updated_at | 写入时间，ISO 8601 格式。 |
