本文档汇总 Memory API 的通用调用约定，包括服务接入地址、鉴权、调用上下文与隔离、公共请求/响应结构以及双路语义检索语义。所有接口在调用前均需阅读本文档；各接口正文不再重复说明这些通用规则。
服务接入地址
https://memory.tdai.tencentyun.com
说明：
Memory 数据面接入域名以实际接入文档为准。
鉴权说明
所有接口均需在请求头中携带以下两个鉴权字段，缺一不可：
请求头 | 是否必选 | 说明 |
Authorization | 是 | 身份验证凭证，格式为 Bearer <API Key>。 |
x-tdai-service-id | 是 | 实例 ID，形如 mem-xxxxxxxx，可在 Memory 智能体控制台查看。 |
公共响应结构
所有接口响应统一采用如下信封结构：
{"code": 0,"message": "ok","request_id": "req-xxxxxxxx","data": {}}
公共响应字段说明：
参数名 | 数据类型 | 参数含义 |
code | Integer | 0 表示成功，非 0 表示失败。 |
message | String | 响应描述信息，成功时通常为 ok。 |
request_id | String | 平台生成的请求标识，用于排查定位。 |
data | Object | 接口特定数据，结构见各接口定义。 |
双路语义检索说明
原始对话/原子记忆各自的
search 接口在对应层内做双路检索（关键词 + 语义向量后融合），返回结构与对应层的 query 接口同形（ConversationItem / AtomDetail 列表），仅在每条命中项额外回带 score 字段表示相关度，按 score 倒序排列。双路融合策略由系统统一决定，当前不提供跨层混排召回接口。
