腾讯云数据库 AI 服务 read_core — 读取核心记忆

一、接口介绍

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

·无入参：方法无需任何业务参数；底层请求体为预留扩展位的空对象 {}。

项	值
HTTP 方法与路径	POST /v2/core/read
HTTP 文档	读取核心记忆
函数签名	read_core()

注意：说明：

注意：尚未沉淀出核心记忆时返回业务错误码 404，可通过 write_core 写入即创建。

二、使用示例

from tencentdb_agent_memory.errors import TdaiMemoryErrortry: result = client.read_core() print(result["content"])except TdaiMemoryError as e: if e.code == 404: # 尚未沉淀，写入即创建 client.write_core(content="# Agent 核心记忆\\n（首次写入）") else: raise

注意：说明：

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

三、请求参数

无业务参数。

四、返回信息

返回字典包含核心记忆全文、时间戳与请求追踪 ID：

{ "content": "# Agent 核心记忆\\n## 用户画像\\n…", "created_at": "2026-04-01T09:00:00+08:00", "updated_at": "2026-05-22T14:30:00+08:00", "trace_id": "tr-xxxxxxxx-xxxxxxxx"}

字段	类型	说明
content	str	成功写入的完整 Markdown 文本。
created_at / updated_at	str	核心记忆文件的首次创建时间（created_at）与本次最新同步时间（updated_at）。
trace_id	str	本次写入请求的全局链路追踪 ID，方便用于高频写入场景下的性能监控与日志对齐。

五、错误处理

错误码	触发场景	处理建议
404	尚未沉淀出核心记忆。	调用 write_core 写入即创建。
500	服务端错误。	记录 trace_id 后重试或上报。