一、服务接入地址
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 倒序排列。双路融合策略由系统统一决定,当前不提供跨层混排召回接口。