ai-contract-platform/project-docs/V2-ai-platform-prompt-release-rollback-2026-06-23.md

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/知识库的异常率变化。