方法介绍
get_prompt 用于查询单份 Memory Prompt 的详细信息。功能说明如下:完整详情:返回 Prompt 的名称、正文内容、适用层级等完整信息。
版本追踪:包含当前版本号,可用于判断 Prompt 是否已被修改。
时间信息:返回创建时间和最后更新时间,便于了解 Prompt 生命周期。
导入
from tencentdb_agent_memory.v3 import AsyncMemoryPromptClient
方法签名
async def get(self,memory_prompt_id: str,) -> 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.get(memory_prompt_id="mp-550e8400-e29b-41d4-a716-446655440000" # 必填,Prompt ID)print(result)
请求参数
参数名 | 类型 | 必填 | 描述说明 |
memory_prompt_id | str | 是 | 待查询的 Prompt ID |
响应示例
{"memory_prompt_id": "mp-550e8400-e29b-41d4-a716-446655440000","name": "客服偏好提取","layer": "l1","prompt": "请提取用户明确表达的长期偏好信息,忽略一次性请求。","version": 3,"created_at_ms": 1723900000000,"updated_at_ms": 1723968000000}
响应参数说明
参数名 | 类型 | 参数含义 |
memory_prompt_id | str | Prompt 唯一标识 ID |
name | str | Prompt 名称 |
layer | str | 适用的 Memory 层级 |
prompt | str | Prompt 正文内容 |
version | int | 当前版本号,每次实际内容变更时递增 |
created_at_ms | int | 创建时间,Unix 时间戳,单位为毫秒 |
updated_at_ms | int | 最后更新时间,Unix 时间戳,单位为毫秒 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | memory_prompt_id 格式不合法 | 检查参数格式 |
401 | API Key 缺失或格式不正确 | 检查 Bearer Token 配置 |
404 | 指定 Prompt 不存在或已被删除 | 确认 Prompt ID 是否正确 |
503 | Prompt 存储服务暂时不可用 | 稍后重试 |