方法介绍
read_core 用于读取当前作用域下的 L3 核心记忆。功能说明如下：记忆定位：核心记忆是跨 Agent、跨会话的全局知识，代表从 L0–L2 数据中持续提炼出的高价值信息。
存储模式：以 Agent 为单位聚合，每次写入覆盖整个 Agent 的快照并生成新版本。
不存在时的表现：当前作用域下尚无核心记忆时，服务端返回成功响应但
content 为 null，不会返回 404 错误。客户端需根据 content 是否为 null 判断核心记忆是否已创建。导入
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.read_core()print(f"版本: {result['version']}, 更新时间: {result['updated_at']}")print(result["content"])
请求参数
read_core 不接收任何请求参数，直接返回当前作用域下的核心记忆。响应示例
{"agent_id": "agt-xyz789","version": 4,"content": "该 Agent 负责产品评审和团队周会的会议纪要整理...","updated_at": "2026-07-22T08:00:00Z"}
Running Environment
Operating System: Ubuntu 24.04.3 LTS / x86_64
Runtime Version: Python 3.11.1
响应参数说明
参数名 | 类型 | 参数含义 |
agent_id | str | 核心记忆所属的 Agent ID |
version | int | 当前读取的版本号 |
content | str | None | 核心记忆内容，尚无核心记忆时返回 None |
updated_at | str | 最近更新时间，ISO 8601 格式 |
错误码
错误码 | 触发场景 | 处理建议 |
401 | API Key 无效或过期 | 检查 api_key 配置 |
422 | 构造参数缺失 | 确保构造时传入必填归属参数 |
注意：
Agent 无核心记忆时不会返回 404 错误，而是返回成功响应且
content 为 None。客户端应通过判断 content 是否为 None 来检测核心记忆是否已创建。
