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

create_prompt

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

方法介绍

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 AsyncMemoryPromptClient

client = 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/l3
prompt="请提取用户明确表达的长期偏好信息,忽略一次性请求。", # 必填,Prompt 正文
)
print(result)

请求参数

参数名
类型
必填
描述说明
name
str
Prompt 名称。长度限制:[1, 100] 个 Unicode 字符
layer
str
适用的 Memory 层级。取值范围:l1l2l3
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 存储服务暂时不可用
稍后重试