客户端介绍
MemoryPromptClient 是 Memory Prompt 管理的专用客户端类，提供 Prompt 的创建、查询、修改、删除以及 Prompt 设置（应用/清除/查询/日志）等完整能力。通过该客户端，您可以：创建和管理 Memory Prompt 定义。
将 Prompt 应用到实例级、团队级或 Agent 级范围。
查询 Prompt 的绑定关系及变更日志。
访问方式
AsyncMemoryPromptClient 是 Prompt 管理的独立客户端，需单独构造：from tencentdb_agent_memory.v3 import AsyncMemoryPromptClientclient = AsyncMemoryPromptClient(endpoint="https://memory.tdai.tencentyun.com",api_key="your_api_key",service_id="tdai-mem-xxxxxxxx")# 直接调用 Prompt 方法result = await client.create(name="...", layer="l1", prompt="...")
方法总览
Prompt CRUD
方法 | 说明 | 文档 |
create_prompt | 创建 Memory Prompt | |
get_prompt | 查询 Prompt 详情 | |
update_prompt | 修改 Prompt | |
delete_prompts | 批量删除 Prompt |
Prompt 设置管理
方法 | 说明 | 文档 |
set_prompt | 应用或清除 Prompt 设置 | |
list_prompt_settings | 查询 Prompt 绑定关系 | |
list_prompt_logs | 查询 Prompt 设置日志 |
错误处理
所有方法在请求失败时会抛出异常，常见错误码如下：
HTTP 状态码 | 错误信息 | 说明 |
400 | request: Invalid input | 请求参数不合法。 |
400 | PROMPT_LAYER_MISMATCH | Prompt 自身的层级与请求指定的 layer 不一致。 |
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 | 当前存储实现不支持该操作。 |
