方法介绍
create_prompt 用于创建一份 Memory Prompt,创建后可绑定到实例、团队或 Agent 以定制记忆抽取策略。功能说明如下:自定义 Prompt:指定 Prompt 名称和正文内容,用于控制记忆抽取行为。
层级绑定:通过
layer 参数指定 Prompt 适用的 Memory 层级(L1/L2/L3)。操作审计:支持传入
user_id,操作记录将写入变更日志,便于后续审计追溯。版本管理:创建时自动初始化版本号为 1,后续每次修改自动递增。
导入
from tencentdb_agent_memory.v3 import AsyncMemoryPromptClient
方法签名
async def create(self,*,name: str,layer: str,prompt: 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.create(name="客服偏好提取", # 必填,Prompt 名称layer="l1", # 必填,适用层级:l1/l2/l3prompt="请提取用户明确表达的长期偏好信息,忽略一次性请求。", # 必填,Prompt 正文)print(result)
请求参数
参数名 | 类型 | 必填 | 描述说明 |
name | str | 是 | Prompt 名称。长度限制:[1, 100] 个 Unicode 字符 |
layer | str | 是 | 适用的 Memory 层级。取值范围: l1、l2、l3 |
prompt | str | 是 | Prompt 正文内容。长度限制:[1, 10000] 个 Unicode 字符 |
user_id | str | 否 | 操作人用户 ID,传入后将记录到操作日志中 |
响应示例
{"memory_prompt_id": "mp-550e8400-e29b-41d4-a716-446655440000","version": 1,"created_at_ms": 1723968000000}
响应参数说明
参数名 | 类型 | 参数含义 |
memory_prompt_id | str | 新创建的 Prompt 唯一标识 ID |
version | int | 版本号,创建时为 1 |
created_at_ms | int | 创建时间,Unix 时间戳,单位为毫秒 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | 请求参数不合法(如 name 为空、layer 取值不在范围内) | 检查参数是否符合约束条件 |
401 | API Key 缺失或格式不正确 | 检查 Bearer Token 配置 |
401 | 请求头中未携带 x-tdai-service-id | 确认 service_id 已正确设置 |
503 | Prompt 存储服务暂时不可用 | 稍后重试 |