腾讯云数据库 AI 服务创建 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	当前存储实现不支持该操作。

腾讯云数据库 AI 服务 创建 Memory Prompt