腾讯云数据库 AI 服务查询 Memory Prompt

一、接口介绍

·按 ID 查询：传入 memory_prompt_id，返回一条 Prompt 完整记录（名称、正文、层级、版本等）。

·查询最终生效值：传入 team_id 和 layer，可选传 agent_id；系统按 Agent → 团队 → 实例 → 系统默认的优先级解析，返回最终实际生效的 Prompt 内容及其来源。

·查询列表：不传上述定位条件，可按 layer 筛选并分页，获取当前实例下的 Prompt 列表。

二、Method 与 URL

GET https://memory.tdai.tencentyun.com/v3/memory-prompt/get

三、按 ID 查询

curl -i -X GET \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ "https://memory.tdai.tencentyun.com/v3/memory-prompt/get?memory_prompt_id=mp-550e8400-e29b-41d4-a716-446655440000"

四、查询 Agent 最终生效值

五、分页列表查询

六、请求参数

参数	必选	参数含义	配置方法及要求
memory_prompt_id	否	Prompt ID	数据类型：String。按 Prompt ID 精确查询指定的 Prompt 记录，与 team_id、agent_id 互斥。
team_id	否	团队 ID	数据类型：String。指定团队 ID，查询该团队（或其下 Agent）当前实际使用的 Prompt。
agent_id	否	Agent ID	数据类型：String。指定 Agent ID，查询该 Agent 当前实际使用的 Prompt。必须同时传入 team_id。
layer	否	Memory 层级	数据类型：String。取值范围：l1、l2、l3。查询指定团队或 Agent 当前实际使用的 Prompt 时必填，列表查询时用作筛选条件。
limit	否	单页数量	数据类型：Integer。取值范围：[1, 100]，默认值：20。
offset	否	分页偏移量	数据类型：Integer。最小值：0，默认值：0。
time_order	否	时间排序方向	数据类型：String。取值范围：asc（升序）、desc（降序，默认）。

七、按 ID 查询响应

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "memory_prompt_id":"mp-550e8400-e29b-41d4-a716-446655440000", "name":"L1 用户偏好提取", "layer":"l1", "prompt":"请从对话中提取稳定、可复用的用户偏好，忽略临时性信息。", "version":2, "status":"active", "created_by":"user-001", "updated_by":"user-001", "created_at_ms":1723881600000, "updated_at_ms":1723968000000 }}

八、查询最终生效值响应

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "memory_prompt_id":"mp-550e8400-e29b-41d4-a716-446655440000", "prompt":"请从对话中提取稳定、可复用的用户偏好，忽略临时性信息。", "layer":"l1", "source":"team", "version":2 }}

注意：说明：

注意：若目标 Agent/团队/实例均未设置自定义 Prompt，系统将返回内置默认值，此时 source 为 system，prompt 为空字符串，memory_prompt_id 为空字符串。示例如下：

注意：{ "code":0, "message":"ok", "request_id":"req-8ae4c3ee", "data":{ "memory_prompt_id":"", "prompt":"", "layer":"l1", "source":"system", "version":0 }}

九、列表查询响应

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "items":[ { "memory_prompt_id":"mp-550e8400-e29b-41d4-a716-446655440000", "name":"L1 用户偏好提取", "layer":"l1", "prompt":"请从对话中提取稳定、可复用的用户偏好…", "version":2, "status":"active", "created_by":"user-001", "updated_by":"user-001", "created_at_ms":1723881600000, "updated_at_ms":1723968000000 } ] }}

十、按 ID 查询 / 列表查询（MemoryPromptRecord）

参数名（一级）	参数名（二级）	参数含义
data	memory_prompt_id	Prompt 唯一标识 ID。
	name	Prompt 名称。
	layer	Prompt 所属层级（l1/l2/l3）。
	prompt	Prompt 正文内容。
	version	当前版本号，每次修改自动递增。
	status	Prompt 状态：active（生效中）、deleting（删除中）。
	created_by	创建人用户 ID（可能为空）。
	updated_by	最后更新人用户 ID（可能为空）。
	created_at_ms	创建时间，Unix 时间戳，单位为毫秒。
	updated_at_ms	最后更新时间，Unix 时间戳，单位为毫秒。

十一、查询最终生效值（EffectiveMemoryPrompt）

参数名（一级）	参数名（二级）	参数含义
data	memory_prompt_id	最终生效的 Prompt ID。
	prompt	最终生效的 Prompt 正文内容。
	layer	Prompt 所属层级。
	source	生效来源：agent（Agent 级）、team（团队级）、instance（实例级）、system（系统默认）。
	version	当前版本号。

十二、错误码

HTTP 状态码	错误信息	说明
400	request: Invalid input	请求参数不合法。
401	Missing or invalid Authorization header	Bearer API Key 缺失或格式不正确。
401	Missing x-tdai-service-id header	请求头中未携带 x-tdai-service-id。
404	MEMORY_PROMPT_NOT_FOUND	指定 Prompt 不存在或已不可用。
503	Memory prompt store not available	Prompt 存储服务暂时不可用，请稍后重试。
503	Memory prompt store does not support this operation	当前存储实现不支持该操作。

腾讯云数据库 AI 服务 查询 Memory Prompt