腾讯云数据库 AI 服务 write_core — 写入或覆盖核心记忆

一、接口介绍

·正文写入：通过 content 传入本次写入的全量正文（必填，整体覆盖旧内容，不做 diff / merge）。

·路径固定：核心记忆文件路径由系统固定（Agent 维度单体），无需传入 path。

·创建与更新统一：尚未沉淀出核心记忆时即创建，已存在时整体覆盖旧内容；该入口是核心记忆唯一的写入接口。

项	值
HTTP 方法与路径	POST /v2/core/write
HTTP 文档	写入或覆盖核心记忆
函数签名	write_core(content)

二、使用示例

from tencentdb_agent_memory.errors import TdaiMemoryError# 直接写入或覆盖result = client.write_core( content="# Agent 核心记忆\\n## 用户画像\\n用户偏好关西线路…",)print(result["updated_at"])# 读后写的典型流程try: current = client.read_core() new_content = current["content"] + "\\n\\n## 新追加章节\\n…"except TdaiMemoryError as e: if e.code == 404: new_content = "# Agent 核心记忆\\n（首次写入）" else: raiseclient.write_core(content=new_content)

注意：说明：

注意：client 实例的构造方式参见新建客户端；异步调用时将方法前加 await 即可。

三、请求参数

参数名	类型	必填	描述说明
content	str	是	本次写入的全量正文内容。注意：写入机制：该操作为破坏性覆盖。系统会直接用本次传入的文本替换掉旧内容，底层不会对新旧内容进行任何差异比对（diff）或自动合并（merge）。请务必在客户端或前端组装好最完整的最终文本再发起请求，否则未包含在其中的旧数据将会永久丢失。

四、返回信息

返回字典包含本次写入后的时间戳与请求追踪 ID：

{"updated_at": "2026-05-22T14:30:00+08:00","trace_id": "tr-xxxxxxxx-xxxxxxxx"}

字段	类型	说明
updated_at	str	系统最新的更新时间戳（ISO 8601 格式）。由于该接口不做 diff / merge，此时间代表旧内容已被完全替换，新内容正式生效的时间点。
trace_id	str	本次覆盖写入请求的全局链路追踪 ID，作为高危写操作的审计凭证，方便后续排查数据覆盖日志。

五、错误处理

错误码	触发场景	处理建议
400	content 为空。	请校验入参后重试。
500	服务端错误。	记录 trace_id 后重试或上报。