方法介绍
update_prompt 用于修改已创建的 Memory Prompt 的名称或正文内容。功能说明如下:部分更新:
name 和 prompt 至少提供一项,未提供的字段保持不变。版本自增:当内容实际发生变化时,
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 AsyncMemoryPromptClientclient = 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 IDprompt="请提取用户明确表达且长期稳定的偏好,不记录一次性请求。", # 可选,新正文(与 name 至少提供一项))print(result)
请求参数
参数名 | 类型 | 必填 | 描述说明 |
memory_prompt_id | str | 是 | 待修改的 Prompt ID |
name | str | 否 | 新的 Prompt 名称。长度限制:[1, 100] 个 Unicode 字符。 name 与 prompt 至少提供一项 |
prompt | str | 否 | 新的 Prompt 正文内容。长度限制:[1, 10000] 个 Unicode 字符。 name 与 prompt 至少提供一项 |
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 存储服务暂时不可用 | 稍后重试 |