方法介绍
write_scenario 用于全量覆盖写入指定路径下已存在的 L2 场景记忆文件。功能说明如下：写入方式：每次写入以新内容覆盖该文件的全部内容，并生成新版本号（数值类型，从
0 开始）。写入与当前版本内容相同时版本号可能不增加。幂等性：多次写入相同内容，内容不变且版本号可能不增加。
摘要字段：支持传入
summary 摘要，便于在不读取全文的情况下快速浏览文件概要。导入
from tencentdb_agent_memory.v3 import MemoryClient
使用示例
from tencentdb_agent_memory.v3 import MemoryClientwith MemoryClient(endpoint="https://memory.tdai.tencentyun.com",api_key="sk-xxxxxxxxxxxxxxxx",service_id="tdai-mem-xxxxxxxx",team_id="team-abc123",agent_id="agt-xyz789",user_id="usr-456",) as client:result = client.write_scenario(path="product-review/2025-q4-review",content="""## 2025 Q4 产品评审总结### 关键结论- 功能迭代方向确认：优先完善 L2 场景记忆的版本回溯能力- 性能优化目标：检索延迟 P99 < 200ms### 参与人员- 产品：张三- 研发：李四""",summary="2025 Q4 产品评审会议纪要，含功能迭代方向和参与人员",)print(f"已写入到 {result['version']}，时间: {result['updated_at']}")
请求参数
参数名 | 类型 | 必填 | 描述说明 |
path | str | 是 | 文件路径，相对路径不带前导 /（如 product-review/2025-q4-review），服务端会拒绝以 / 开头的路径并返回 400。必须是已存在的路径，不支持自动创建新路径 |
content | str | 是 | 文件内容，长度上限 65536 字符 |
summary | str | 否 | 文件摘要描述（SDK 额外字段） |
响应示例
{"path": "product-review/2025-q4-review","version": 6,"updated_at": "2026-07-22T15:00:00Z"}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
path | str | 被写入的文件路径 |
version | int | 写入后生成的新版本号，从 0 开始。写入与当前内容相同时可能不增加 |
updated_at | str | 更新时间，ISO 8601 格式 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | path 或 content 为空 | 检查必填参数 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
404 | 文件路径不存在（需先由系统创建） | 确认路径已存在 |
422 | 构造参数缺失 | 确保构造时传入必填归属参数 |
