接口介绍
当默认记忆抽取策略无法满足业务需求时，可自定义 Prompt 精确控制记忆的生成逻辑。本接口（
/v3/memory-prompt/create）用于创建一份自定义 Memory Prompt，以覆盖系统内置的记忆生成策略。功能说明如下：适用层级：每份 Prompt 绑定一个 Memory 层级（
l1 原子记忆、l2 场景记忆、l3 核心记忆），创建后层级不可变更。数量限制：单个实例最多可创建 500 份 Prompt，超出时返回 409 错误。
长度限制：
name 最多 100 个 Unicode 字符，prompt 最多 10000 个 Unicode 字符。版本控制：新建 Prompt 版本号初始化为 1，后续通过修改接口自动递增。
Method 与 URL
POST https://memory.tdai.tencentyun.com/v3/memory-prompt/create
使用示例
curl -i -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer *********************************' \\-H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\-H "x-tdai-user-id: user-001" \\https://memory.tdai.tencentyun.com/v3/memory-prompt/create \\-d '{"name":"L1 用户偏好提取","layer":"l1","prompt":"请从对话中提取稳定、可复用的用户偏好，忽略临时性信息。"}'
请求参数
参数 | 必选 | 参数含义 | 配置方法及要求 |
name | 是 | Prompt 名称 | 数据类型：String 长度限制：[1, 100] 个 Unicode 字符 |
layer | 是 | 该 Prompt 适用的 Memory 层级 | 数据类型：String。 取值范围： l1（原子记忆）、l2（场景记忆）、l3（核心记忆）创建后不可变更 |
prompt | 是 | Prompt 正文内容 | 数据类型：String 长度限制：[1, 10000] 个 Unicode 字符 |
响应示例
{"code":0,"message":"ok","request_id":"req-7fd3b2dd","data":{"memory_prompt_id":"mp-550e8400-e29b-41d4-a716-446655440000","version":1,"created_at_ms":1723881600000}}
响应参数说明
参数名（一级） | 参数名（二级） | 参数含义 |
data | memory_prompt_id | 系统为本次创建的 Prompt 分配的唯一标识 ID。 |
| version | 当前 Prompt 版本号，初始为 1。 |
| created_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。 |
409 | PROMPT_LIMIT_EXCEEDED: maximum 500 prompts per instance | 实例中的 Prompt 数量已达到 500 上限。 |
503 | Memory prompt store not available | Prompt 存储服务暂时不可用，请稍后重试。 |
503 | Memory prompt store does not support this operation | 当前存储实现不支持该操作。 |
