接口介绍
本接口（
/v3/memory-prompt/get）用于查询 Memory Prompt 信息，当前某个 Agent 或团队实际使用的是哪份 Prompt，或分页查看实例下的所有自定义 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 最终生效值
curl -i -X GET \\-H 'Authorization: Bearer *********************************' \\-H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\"https://memory.tdai.tencentyun.com/v3/memory-prompt/get?team_id=team-001&agent_id=agent-001&layer=l1"
分页列表查询
curl -i -X GET \\-H 'Authorization: Bearer *********************************' \\-H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\"https://memory.tdai.tencentyun.com/v3/memory-prompt/get?layer=l1&limit=20&offset=0&time_order=desc"
请求参数
参数 | 必选 | 参数含义 | 配置方法及要求 |
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 | 当前存储实现不支持该操作。 |
