一、接口介绍
·部分更新:至少提供 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 | 当前存储实现不支持该操作。 |