腾讯云数据库 AI 服务 write_core

接口介绍
写入或全量覆盖 Agent 核心记忆。核心记忆是 Agent 维度的单体快照，路径由系统固定，本接口同时承担"写入即创建"与"全量覆盖更新"两种语义：
正文写入：通过 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:
        raise
﻿
client.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 后重试或上报。
﻿

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

write_core — 写入或覆盖核心记忆

本页目录：

接口介绍

使用示例

请求参数

返回信息

错误处理

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

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

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