腾讯云数据库 AI 服务 修改 Memory Prompt

本接口(/v3/memory-prompt/update)用于修改已创建的 Memory Prompt 的名称和/或正文内容。功能说明如下。

相关产品
腾讯云数据库 AI 服务 产品页,含版本规格、价格与购买入口。

一、接口介绍

·部分更新:至少提供 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 当前存储实现不支持该操作。
赞 (0)
上一篇 4天前
下一篇 4天前