Memory API 是 Memory 服务对外开放的数据面接口集合，用于在你的应用或 Agent 中读写、检索和管理记忆数据。通过这套 API，你可以把对话内容写入 Memory 实例，按条件查询历史消息，进行记忆检索，以及读写沉淀后的场景记忆与个性化画像。
接入方式
提供三种等价的接入方式，覆盖不同的开发语言与运行环境，所有接入方式底层共享同一套 Memory 服务能力。
接入方式 | 适用场景 | 接入文档 |
HTTP API | 任意语言、任意运行环境；适合自行封装、嵌入网关或在不便引入 SDK 的场景下使用。 | HTTP API 接入指南 |
Python SDK | Python 应用、AI Agent 框架（LangChain、LlamaIndex 等）、数据处理脚本。 | Python SDK 接入指南 |
TypeScript SDK | Node.js 服务端、浏览器端 Web 应用，以及基于 TypeScript 的全栈项目。 | TypeScript SDK 接入指南 |
不同接入方式之间功能完全对齐，可按团队技术栈自由选择；同一个 Memory 实例也支持多种接入方式并存。具体的安装、初始化、鉴权与示例代码请参考各自的接入文档。
能力概览
Memory API 围绕「写入 → 沉淀 → 读取 / 检索 → 维护」的使用链路提供以下能力：
写入原始对话：将一段对话消息流提交给 Memory 服务，由服务自动完成后续的记忆抽取与沉淀。
查询与读取：按会话、时间窗等条件分页查询对话消息；按路径读取沉淀后的场景记忆文件；读取 Agent 维度的个性化画像。
语义检索：在对话消息和原子记忆两个层级上提供语义检索接口，按相关度返回 Top-K 命中结果。
更新与删除：对沉淀产物（原子记忆、场景记忆、个性化画像）做按需订正；按消息 ID、会话或主键批量清理不再需要的数据。
更详细的数据模型与各接口参数说明，请参见对应的接入文档与接口参考。
使用前提
调用任一接口前，请先在控制台完成以下准备工作：
1. 开通并创建 Memory 实例，获取实例 ID。
2. 申请 API Key，用于接口鉴权。
3. 选择上文中的任一接入方式，按对应文档完成 SDK 安装或 HTTP 客户端配置。
