腾讯云数据库 AI 服务 调用方式(HTTP)

这篇档汇总 Memory API 的通用调用约定,包括服务接入地址、鉴权、调用上下面与隔离、公共请求/响应结构以及双路语义检索语义。所有接口在调用前均需阅读这篇档;各接口正文不再重复说明这些通用规则。

相关产品
腾讯云数据库 AI 服务 产品页,含版本规格、价格与购买入口。

一、服务接入地址

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

赞 (0)
上一篇 4天前
下一篇 4天前