接口介绍
本接口(
/v3/memory-prompt/update)用于修改已创建的 Memory Prompt 的名称和/或正文内容。功能说明如下:部分更新:至少提供
name、prompt 中的一项,未提供的字段保持不变。版本自增:当内容实际发生变化时,
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 字符 name 与 prompt 至少提供一项 |
prompt | 否 | 新的 Prompt 正文内容 | 数据类型:String 长度限制:[1, 10000] 个 Unicode 字符 name 与 prompt 至少提供一项 |
响应示例
{"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 | 请求参数不合法,如 name 和 prompt 均未提供。 |
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 | 当前存储实现不支持该操作。 |