yuqei
a3bb78e06b
Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 16m35s
77 lines
3.9 KiB
Markdown
77 lines
3.9 KiB
Markdown
# V2 AI 配置执行动作增强闭环 - 2026-06-23
|
|
|
|
## 本轮目标
|
|
|
|
继续遵循《AI 合同平台 V2 重构版开发方案》，把质量改进项详情页中的执行动作继续落到真实配置管理能力上：
|
|
|
|
- Prompt 草稿创建后能直达草稿并发布。
|
|
- 知识库支持真实文件上传、解析、入库、切分和索引状态展示。
|
|
- 模型参数发布记录支持对比，并能从发布前快照发起回滚。
|
|
|
|
本轮仍保持 V2 分层：AI Platform 负责 Prompt、知识库、模型配置和审计；Contract Web 只提供管理员操作入口和同源代理。
|
|
|
|
## 完成内容
|
|
|
|
1. Prompt 草稿直达发布
|
|
- 质量改进项详情页创建 Prompt 草稿后，返回带 `publish=1` 的 Prompt 中心定位链接。
|
|
- Prompt 中心读取 `templateId`、`version`、`publish=1` 后自动定位草稿版本。
|
|
- 目标草稿卡片展示发布提示，管理员审阅无误后可直接发布为运行版本。
|
|
- 已关联草稿的质量改进项详情页提供“进入草稿发布”入口。
|
|
|
|
2. 知识库真实文件上传
|
|
- AI Platform 新增 `POST /api/v1/knowledge-bases/{knowledge_base_id}/documents`。
|
|
- 支持 `txt`、`md`、`csv`、`json`、`pdf`、`docx` 文件解析。
|
|
- 上传后自动创建导入批次、写入知识文档、切分 chunk，并返回解析状态。
|
|
- OpenAPI 新增 `KnowledgeDocumentUploadResult`。
|
|
- Python SDK 新增 `upload_knowledge_document`。
|
|
- Contract Web 新增同源代理：
|
|
- `/api/ai-platform/knowledge-bases/[knowledgeBaseId]/documents`
|
|
- 知识库管理页新增“上传知识文件”面板，上传后自动展开新批次并展示文档/chunk 状态。
|
|
|
|
3. 模型参数对比与回滚入口
|
|
- 模型参数发布记录详情页继续展示发布前/发布后快照。
|
|
- 当存在发布前快照时，详情页提供“回滚到发布前参数”入口。
|
|
- 模型配置页读取 `rollbackFromChange` 参数后，把发布前快照预填到编辑表单。
|
|
- 管理员保存后生成一条新的模型参数发布记录，保证回滚动作也进入审计链。
|
|
- 模型配置列表中的发布记录增加“查看对比”入口。
|
|
|
|
## 路线核查
|
|
|
|
- 没有把模型 provider 调用、Prompt 拼装或知识库内部表操作塞回合同业务系统。
|
|
- 文件解析入口在 AI Platform 中实现，Contract Web 只转发 `FormData`。
|
|
- 模型回滚没有绕过审计，而是复用模型配置保存能力生成新的发布记录。
|
|
- Prompt 发布仍要求管理员在 Prompt 中心审阅后手动发布，避免质量改进项详情页越权直接改变运行版本。
|
|
- 当前文件解析是同步 MVP；大文件、OCR、失败重试和长流程状态后续应进入 worker/durable workflow。
|
|
|
|
## 验证结果
|
|
|
|
- `python -m pytest yuqei-ai-platform\services\ai-platform-api\tests\test_platform_data.py -q`
|
|
- 21 passed
|
|
- `python -m pytest yuqei-ai-sdk-python\tests\test_ai_platform.py -q`
|
|
- 2 passed
|
|
- `npm --prefix yuqei-contract-platform/apps/contract-web run build`
|
|
- passed
|
|
- `python -c "import pathlib, yaml; yaml.safe_load(pathlib.Path('yuqei-ai-platform/packages/ai-openapi/openapi.yaml').read_text(encoding='utf-8')); print('openapi ok')"`
|
|
- openapi ok
|
|
- `git diff --check`
|
|
- passed，仅有 Windows LF/CRLF 提示
|
|
|
|
## 当前闭环价值
|
|
|
|
现在质量运营链路进一步变成：
|
|
|
|
1. Trace 或质量看板发现问题。
|
|
2. 创建质量改进项。
|
|
3. 在改进项详情页选择处理动作。
|
|
4. Prompt 问题直达草稿并发布。
|
|
5. 知识库问题可上传真实文件并看到解析/切片状态。
|
|
6. 模型问题可查看参数版本对比，并从旧快照回滚生成新审计记录。
|
|
7. 后续 Trace 继续用于回看质量是否改善。
|
|
|
|
## 下一步建议
|
|
|
|
- 知识库上传接入 worker 任务状态、失败重试和 OCR。
|
|
- Prompt 发布记录增加版本 diff 和回滚前影响提示。
|
|
- 模型参数回滚前增加风险确认和变更审批。
|
|
- 将 Prompt 发布、知识库上传、模型回滚统一纳入配置执行时间线。
|