yuqei/ai-contract-platform

Fork 0

Files

T

yuqei a3bb78e06b

Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 16m35s

Details

release: freeze V2 release candidate

2026-07-12 15:32:24 +08:00

3.5 KiB

Raw Blame History

V2 AI 质量改进项执行记录闭环 - 2026-06-23

本轮目标

按照《AI 合同平台 V2 重构版开发方案》的边界继续推进：AI 中台负责模型参数、Prompt、知识库索引和 AI 审计闭环；合同系统只负责管理后台展示和业务入口。本轮把“执行动作”挂回质量改进项详情页，让管理员能从一个质量问题直接看到对应的模型参数发布记录、Prompt 发布记录、知识库重建索引记录，并查看执行后的 Trace 质量变化。

已完成内容

AI Platform 执行记录能力
- 新增 Prompt 发布记录模型 PromptTemplateChange。
- 新增知识库重建索引记录模型 KnowledgeReindexExecution。
- 新增聚合返回模型 AiQualityImprovementExecutionBundle。
- 新增 GET /api/v1/audit/quality-improvement-actions/{action_id}/executions。
- POST /api/v1/prompt-templates/{name}/publish 支持 changed_by、change_note。
- POST /api/v1/knowledge-documents/reindex 支持 triggered_by、execution_note。
数据库闭环
- 新增迁移 20260623_0010_add_prompt_and_reindex_execution_records.py。
- 新增表 prompt_template_changes。
- 新增表 knowledge_reindex_executions。
- SQLAlchemy 仓库和内存仓库均支持执行记录写入、查询和按质量改进项聚合。
OpenAPI 与 Python SDK
- OpenAPI 同步新增执行记录接口和 schema。
- Python SDK 新增：
  - PromptTemplateChange
  - KnowledgeReindexExecution
  - AiQualityImprovementExecutionBundle
  - get_quality_improvement_action_executions(action_id)
- SDK 请求模型同步支持执行人和说明字段。
合同系统后台
- 新增同源代理：
  - /api/ai-platform/audit/quality-improvement-actions/[actionId]/executions
- 质量改进项详情页新增 Execution records 区块：
  - Model config publishes
  - Prompt publishes
  - Knowledge reindex
- 同页显示执行后质量回看指标：
  - Post-change traces
  - Post-change issue rate
  - Quality score delta
  - Source traces

当前闭环价值

现在质量运营链路变成：

AI Trace 或质量看板发现问题。
管理员创建质量改进项。
管理员执行模型参数调整、Prompt 发布、知识库重建索引。
执行动作自动写入 AI 中台审计表。
管理员回到质量改进项详情页，能直接看到执行记录和后续 Trace 质量变化。

这让“发现问题 -> 执行动作 -> 效果回看”真正形成闭环，而不是停留在人工备注。

验证结果

python -m py_compile yuqei-ai-platform\services\ai-platform-api\src\yuqei_ai_platform_api\repository.py yuqei-ai-platform\services\ai-platform-api\src\yuqei_ai_platform_api\main.py yuqei-ai-platform\services\ai-platform-api\src\yuqei_ai_platform_api\models.py yuqei-ai-sdk-python\src\yuqei_sdk\ai_platform.py
python -m pytest yuqei-ai-platform\services\ai-platform-api\tests\test_platform_data.py -q
- 16 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

下一步建议

继续沿 V2 方案推进“配置执行动作自动化”：

从质量改进项详情页直接发起 Prompt 草稿创建/发布。
从质量改进项详情页直接进入知识库导入批次并上传真实文件。
模型参数发布增加版本对比和回滚入口。
将执行动作与后续 Trace 自动按时间窗口关联，形成更精确的改善率统计。

3.5 KiB Raw Blame History