腾讯云数据库 AI 服务 read_core

接口介绍
读取 Agent 核心记忆 Markdown 文件全文。核心记忆是 Agent 维度的单体快照，路径由系统固定，无需指定目标：
路径固定：核心记忆文件路径由系统固定（Agent 维度单体），既无需 list 也无需传入 path。
无入参：方法无需任何业务参数；底层请求体为预留扩展位的空对象 {}。
项
值
HTTP 方法与路径
POST /v2/core/read
HTTP 文档
﻿读取核心记忆﻿
函数签名
read_core()
说明：
尚未沉淀出核心记忆时返回业务错误码 404，可通过 write_core 写入即创建。
使用示例
from tencentdb_agent_memory.errors import TdaiMemoryError
﻿
try:
    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 后重试或上报。

read_core — 读取核心记忆

本页目录：

接口介绍

使用示例

请求参数

返回信息

错误处理

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

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

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