帮你快速理解、总结文档立即下载

修改 Memory Prompt

最近更新时间:2026-08-27 17:42:00
我的收藏

接口介绍

本接口(/v3/memory-prompt/update)用于修改已创建的 Memory Prompt 的名称和/或正文内容。功能说明如下:
部分更新:至少提供 nameprompt 中的一项,未提供的字段保持不变。
版本自增:当内容实际发生变化时,version 自动加 1;提交相同内容时视为无变更,版本号不递增。
层级不可变:Prompt 所属的 layer 不支持修改;如需更换层级,请删除后重新创建。
说明:
Agent 运营过程中需要迭代记忆抽取策略时,可通过本接口修改 Prompt 内容,已绑定该 Prompt 的团队或 Agent 会自动使用最新版本。

Method 与 URL

POST https://memory.tdai.tencentyun.com/v3/memory-prompt/update

使用示例

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/update \\
-d '{
"memory_prompt_id":"mp-550e8400-e29b-41d4-a716-446655440000",
"prompt":"请提取用户明确表达且长期稳定的偏好,不记录一次性请求。"
}'

请求参数

参数
必选
参数含义
配置方法及要求
memory_prompt_id
待修改的 Prompt ID
数据类型:String
name
新的 Prompt 名称
数据类型:String
长度限制:[1, 100] 个 Unicode 字符
nameprompt 至少提供一项
prompt
新的 Prompt 正文内容
数据类型:String
长度限制:[1, 10000] 个 Unicode 字符
nameprompt 至少提供一项

响应示例

{
"code":0,
"message":"ok",
"request_id":"req-7fd3b2dd",
"data":{
"memory_prompt_id":"mp-550e8400-e29b-41d4-a716-446655440000",
"version":3,
"updated_at_ms":1723968000000
}
}

响应参数说明

参数名(一级)
参数名(二级)
参数含义
data
memory_prompt_id
本次修改的 Prompt ID。
version
更新后的版本号,每次实际变更递增。
updated_at_ms
更新时间,Unix 时间戳,单位为毫秒。

错误码

HTTP 状态码
错误信息
说明
400
request: Invalid input
请求参数不合法,如 nameprompt 均未提供。
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
当前存储实现不支持该操作。