1.6 KiB
1.6 KiB
Prompt 与个性化(Personalization)管理 API
Prompt(主提示词)存储位置
- 路径:
api/users/<user>/data/prompts/<name>.txt - 内容格式:纯文本
个性化存储位置
- 路径:
api/users/<user>/data/personalization/<name>.json - 内容格式:JSON,对应原有 personalization 配置结构
接口
列出 Prompt
GET /api/v1/prompts
响应:
{ "success": true, "items": [ { "name": "default", "size": 123, "updated_at": 1769182550.59 } ] }
获取 Prompt 内容
GET /api/v1/prompts/{name}
响应:
{ "success": true, "name": "custom_a", "content": "你的主系统提示..." }
创建/覆盖 Prompt
POST /api/v1/prompts
{ "name": "custom_a", "content": "你的主系统提示内容" }
成功返回 { "success": true, "name": "custom_a" }
列出个性化
GET /api/v1/personalizations
获取个性化内容
GET /api/v1/personalizations/{name}
创建/覆盖个性化
POST /api/v1/personalizations
{ "name": "biz_mobile", "content": { ... personalization json ... } }
在对话/消息中使用
POST /api/v1/conversations可选参数:prompt_name、personalization_name,会写入对话元数据并在后续消息中应用。POST /api/v1/messages可选参数:prompt_name、personalization_name,立即应用并写入元数据。- 元数据字段:
custom_prompt_name、personalization_name;对话加载时会自动套用对应文件(若不存在则忽略)。
优先级:调用时传入 > 对话元数据 > 默认主 prompt / 默认个性化配置。