一、接口介绍
·写入方式：每次写入以新内容覆盖该文件的全部内容，并生成新版本号。
·摘要字段：支持传入 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 格式。 |