接口介绍
本接口（
/v3/memory-prompt/setting/list）用于查询实例、团队或 Agent 与 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 | 当前存储实现不支持该操作。 |
