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

update_prompt

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

方法介绍

update_prompt 用于修改已创建的 Memory Prompt 的名称或正文内容。功能说明如下:
部分更新nameprompt 至少提供一项,未提供的字段保持不变。
版本自增:当内容实际发生变化时,version 自动加 1。
操作审计:支持传入 user_id,操作记录将写入变更日志,便于后续审计追溯。

导入

from tencentdb_agent_memory.v3 import AsyncMemoryPromptClient

方法签名

async def update(
self,
memory_prompt_id: str,
*,
name: Optional[str] = None,
prompt: Optional[str] = None,
) -> Dict[str, Any]

使用示例

from tencentdb_agent_memory.v3 import AsyncMemoryPromptClient

client = AsyncMemoryPromptClient(
endpoint="https://memory.tdai.tencentyun.com",
api_key="sk-xxxxxxxxxxxxxxxx",
service_id="tdai-mem-xxxxxxxx"
)

result = await client.update(
memory_prompt_id="mp-550e8400-e29b-41d4-a716-446655440000", # 必填,Prompt ID
prompt="请提取用户明确表达且长期稳定的偏好,不记录一次性请求。", # 可选,新正文(与 name 至少提供一项)
)
print(result)

请求参数

参数名
类型
必填
描述说明
memory_prompt_id
str
待修改的 Prompt ID
name
str
新的 Prompt 名称。长度限制:[1, 100] 个 Unicode 字符。nameprompt 至少提供一项
prompt
str
新的 Prompt 正文内容。长度限制:[1, 10000] 个 Unicode 字符。nameprompt 至少提供一项
user_id
str
操作人用户 ID,传入后将记录到操作日志中

响应示例

{
"memory_prompt_id": "mp-550e8400-e29b-41d4-a716-446655440000",
"version": 3,
"updated_at_ms": 1723968000000
}

响应参数说明

参数名
类型
参数含义
memory_prompt_id
str
本次修改的 Prompt ID
version
int
更新后的版本号,每次实际变更递增
updated_at_ms
int
更新时间,Unix 时间戳,单位为毫秒

错误码

错误码
触发场景
处理建议
400
name 和 prompt 均未提供,或参数长度超限
至少提供 name 或 prompt 中的一项
401
API Key 缺失或格式不正确
检查 Bearer Token 配置
404
指定 Prompt 不存在或已被删除
确认 Prompt ID 是否正确
503
Prompt 存储服务暂时不可用
稍后重试