腾讯云数据库 AI 服务 快慢召回实践教程

一、接口介绍

·目标范围：由参数组合决定，不传 team_id 和 agent_ids 为实例级；仅传 team_id 为团队级；同时传 team_id 和 agent_ids 为 Agent 级（支持批量设置 1 至 100 个 Agent）。

·应用操作（action=apply）：必须传 memory_prompt_id，且 Prompt 自身的 layer 必须与请求的 layer 一致，否则返回 400 错误。

·清除操作（action=clear）：无需传入 memory_prompt_id（即使传入也不生效），清除目标范围上已有的自定义设置，恢复向上继承。

·幂等性：重复应用相同 Prompt 或清除不存在的设置时，affected 返回 0。

注意：说明：

注意：为不同业务团队或 Agent 配置差异化的记忆生成策略。例如，为客服 Agent 应用“仅提取用户投诉要点”的 Prompt，为销售 Agent 应用“重点记录客户偏好”的 Prompt。

二、Method 与 URL

POST https://memory.tdai.tencentyun.com/v3/memory-prompt/set

三、应用到团队

curl -i -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ -H "x-tdai-user-id: user-001" \\ https://memory.tdai.tencentyun.com/v3/memory-prompt/set \\ -d '{ "action":"apply", "memory_prompt_id":"mp-550e8400-e29b-41d4-a716-446655440000", "team_id":"team-001", "layer":"l1" }'

四、批量清除 Agent 设置

curl -i -X POST \\ -H 'Content-Type: application/json' \\ -H 'Authorization: Bearer *********************************' \\ -H "x-tdai-service-id: tdai-mem-xxxxxxxx" \\ -H "x-tdai-user-id: user-001" \\ https://memory.tdai.tencentyun.com/v3/memory-prompt/set \\ -d '{ "action":"clear", "team_id":"team-001", "agent_ids":["agent-001","agent-002"], "layer":"l1" }'

五、请求参数

六、响应示例

{ "code":0, "message":"ok", "request_id":"req-7fd3b2dd", "data":{ "affected":3 }}

七、响应参数说明

八、错误码