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

get_prompt

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

方法介绍

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 AsyncMemoryPromptClient

client = 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 存储服务暂时不可用
稍后重试