feat: add ai prompt release workflow

2026-06-23 09:06:13 +08:00
parent f145a38ee5
commit b2d60871a5
15 changed files with 1062 additions and 6 deletions
@@ -0,0 +1,64 @@
+# V2 AI Platform Prompt 发布与回滚闭环记录 - 2026-06-23
+
+## 背景
+
+根据《AI 合同平台 V2 重构版开发方案》，AI 中台必须统一承接模型网关、知识库、RAG、Prompt、法条引用、AI 审计和质量评测。合同系统不应直接拼 Prompt 或绕过 SDK 调模型。
+
+上一轮已经完成 AI 质量改进项运营增强，本轮继续补齐 Prompt 中心的版本发布与回滚能力，让“调整 Prompt”从运营建议变成可执行、可追溯的配置变更。
+
+## 本轮完成内容
+
+1. AI Platform 后端 Prompt 版本状态
+   - `PromptTemplateModel` 增加 `status`、`rollback_from_version`、`published_at`。
+   - Prompt 状态支持 `draft`、`published`、`archived`。
+   - 默认 Prompt seed 后自动发布，确保法律问答读取的是明确的运行版本。
+
+2. 发布闭环
+   - 新增 `POST /api/v1/prompt-templates/{name}/publish`。
+   - 发布某个版本后，同名其他版本自动归档并禁用。
+   - `get_prompt_template(name)` 只返回同名已发布且启用的最新版本。
+
+3. 回滚闭环
+   - 新增 `POST /api/v1/prompt-templates/{name}/rollback`。
+   - 回滚不会直接覆盖历史版本，而是复制来源版本内容，生成一个新的已发布版本。
+   - 新版本记录 `rollback_from_version`，便于审计和问题复盘。
+
+4. OpenAPI 与 SDK
+   - OpenAPI 增加 publish/rollback 路径与请求 schema。
+   - Python SDK 增加 `PromptTemplatePublishRequest`、`PromptTemplateRollbackRequest`。
+   - `AiPlatformClient` 增加 `publish_prompt_template` 和 `rollback_prompt_template`。
+
+5. 合同系统后台 Prompt 中心
+   - 新增 `/admin/ai-prompts`。
+   - 管理员可保存 Prompt 草稿、发布指定版本、从历史版本回滚发布。
+   - 管理首页新增“Prompt 中心”入口。
+   - 前端通过 `/api/ai-platform/prompt-templates` 代理调用 AI Platform，保持合同系统不直接承接 Prompt 业务逻辑。
+
+## 验收结果
+
+- `python -m pytest yuqei-ai-platform/services/ai-platform-api/tests yuqei-ai-sdk-python/tests -q`
+  - 27 passed
+- `npm run web:typecheck`
+  - passed
+- `python -c "import yaml ... openapi.yaml ..."`
+  - passed
+
+## 当前闭环价值
+
+Prompt 调整现在具备完整运营路径：
+
+1. AI 质量运营看板发现某个 Prompt 异常集中。
+2. 管理员进入 Prompt 中心创建新草稿。
+3. 管理员发布新版本。
+4. 后续 AI 调用审计记录 Prompt 版本与运行结果。
+5. 如果新版本效果不好，管理员从历史版本回滚并形成新发布版本。
+
+这让 V2 AI 中台从“能调模型”进一步变成“能运营、能复盘、能回滚”的生产级平台能力。
+
+## 下一步建议
+
+下一步自然进入“知识库导入批次与质量改进项关联”：
+
+- 改进项类型为“补知识库”时，可关联具体知识库和导入批次。
+- Prompt 改进项可关联具体 Prompt 版本。
+- AI 质量看板可展示改进动作执行后，相关 Prompt/知识库的异常率变化。