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

一、接口介绍

·多维筛选：支持按 memory_prompt_id、target_type、team_id、agent_id、layer 组合筛选。

·互斥约束：target_type=instance 时不能同时包含团队或 Agent 条件；target_type=team 时不能包含 Agent 条件。

·分页查询：通过 limit 和 offset 实现分页，time_order 控制排序方向。

注意：说明：

注意：运营人员需要查看当前实例中哪些团队或 Agent 已绑定了自定义 Prompt，或确认某份 Prompt 被多少目标引用。

二、Method 与 URL

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

三、使用示例

curl -i -X GET \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ "https://memory.tdai.tencentyun.com/v3/memory-prompt/setting/list?target_type=team&layer=l1&limit=20&offset=0"

四、请求参数

参数	必选	参数含义	配置方法及要求
memory_prompt_id	否	按 Prompt ID 筛选	数据类型：String
target_type	否	目标类型	数据类型：String取值范围：instance（实例级）、team（团队级）、agent（Agent 级）互斥约束：instance 不可同时传 team_id 或 agent_id；team 不可同时传 agent_id
team_id	否	团队 ID	数据类型：String
agent_id	否	Agent ID	数据类型：String传入时必须同时传 team_id
layer	否	Memory 层级筛选	数据类型：String取值范围：l1、l2、l3
limit	否	单页数量	数据类型：Integer取值范围：[1, 100]，默认值：20
offset	否	分页偏移量	数据类型：Integer最小值：0，默认值：0
time_order	否	时间排序方向	数据类型：String取值范围：asc（升序）、desc（降序，默认）

五、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "items":[ { "setting_id":"ps-aabb1122", "target_type":"team", "team_id":"team-001", "agent_id":null, "layer":"l1", "memory_prompt_id":"mp-550e8400-e29b-41d4-a716-446655440000", "updated_by":"user-001", "updated_at_ms":1723968000000 } ] }}

六、响应参数说明

参数名（一级）	参数名（二级）	参数含义
data	items	设置记录列表。
items[]	setting_id	设置记录唯一标识 ID。
	target_type	目标类型：instance、team、agent。
	team_id	团队 ID。当 target_type 为 instance 时，该字段返回 null。
	agent_id	Agent ID。当 target_type 非 agent 时，该字段返回 null。
	layer	设置的 Memory 层级。
	memory_prompt_id	绑定的 Prompt ID。
	updated_by	最后操作人用户 ID（可能为空）。
	updated_at_ms	最后更新时间，Unix 时间戳，单位为毫秒。

七、错误码

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。
503	Memory prompt store not available	Prompt 存储服务暂时不可用，请稍后重试。
503	Memory prompt store does not support this operation	当前存储实现不支持该操作。

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