42 lines
2.3 KiB
Markdown
42 lines
2.3 KiB
Markdown
# Prompt 管理中心
|
||
|
||
后台入口为“系统工具 → Prompt 中心”，用于在不重新发布应用的情况下管理 AI Prompt。
|
||
|
||
## 能力
|
||
|
||
- 模板管理：以稳定的 `promptCode` 和生成类型标识业务 Prompt。
|
||
- 版本管理：System Prompt 与 User Prompt 模板均进入不可变版本，支持发布、退役和回滚，并保存 SHA-256 指纹。
|
||
- 模型配置：每个版本独立绑定 Provider 和 Model；调试时也可以临时选择可用网关与模型。
|
||
- 在线调试：草稿、已发布和已退役版本均可测试，记录输入、输出、模型、耗时、成功状态和人工评分。
|
||
- A/B 测试：同一模板下选择两个不可变版本，用相同输入运行对比，统计成功次数、平均耗时与人工评分。
|
||
|
||
## 唯一来源
|
||
|
||
Prompt 中心的数据库发布版是运行时唯一来源。系统不提供代码内置 Prompt、初始化 V1 或缺失回退；模板没有当前已发布版本、被停用或版本内容校验失败时，生成任务会明确失败。首个版本应通过部署 SQL 导入，或由管理员在 Prompt 中心创建并发布。
|
||
|
||
## 数据库升级
|
||
|
||
按顺序执行：
|
||
|
||
1. `sql/factory_prompt_registry.sql`
|
||
2. 如果 Prompt 表已在旧版本创建，执行 `sql/factory_prompt_user_template_upgrade.sql`
|
||
3. `sql/factory_prompt_lab.sql`
|
||
4. `sql/prompt_registry_menu.sql`
|
||
|
||
完成升级后，确认每个正在使用的生成类型都有当前已发布版本。运行时始终读取数据库，不存在切换到代码内置 Prompt 的配置项。
|
||
|
||
## 结构化上下文契约
|
||
|
||
前台 AI 生成入口只向 Prompt Registry 传递 JSON 动态上下文。角色设定、输出格式、字段约束、禁止项和纠错规则均由 Prompt 中心的 System Prompt 与 User Prompt 模板控制，User Prompt 模板必须保留 `{{input}}`。
|
||
|
||
当前版本通常使用 `context-json:<generateType>:v1`。契约和 Prompt 正文均随后台版本保存；升级前的 `legacy-builder:*` 版本不会触发代码回退，应在 Prompt 中心创建并发布完整的新版本。
|
||
|
||
## 权限
|
||
|
||
- `generator:prompt:list/query/add/edit`
|
||
- `generator:prompt:version/publish/rollback`
|
||
- `generator:prompt:debug`
|
||
- `generator:prompt:experiment`
|
||
|
||
在线调试会真实调用模型并产生费用，也会保存测试输入和输出；生产环境应仅授予可信管理员，并避免输入密钥、个人信息等敏感数据。
|