API-AI-010：PromptVersion / OutputSchemaVersion 记录字段设计 #171

New Issue

wangdl · 2026-06-10T21:02:30+08:00

wangdl commented

2026-06-10 21:02:30 +08:00

目标

为 AI 分析、题目生成、卡片生成增加 Prompt 版本和输出 Schema 版本追踪能力。

要求

AiRuntimeJob 必须记录 promptVersion。
AiRuntimeJob 必须记录 outputSchemaVersion。
AiRuntimeResult 必须记录 schemaVersion。
ModelInvocationLog 必须记录 promptName / promptVersion / outputSchemaVersion。
AI 分析结果表必须能追溯 promptVersion。
题目 / 卡片产物必须能追溯生成版本。

可选表

第一阶段可以不做完整 PromptTemplate 表，但必须预留字段。

后续可扩展：

PromptTemplate: id, name, version, content, status, createdAt

说明

promptVersion / outputSchemaVersion 字段为后续 Prompt A/B 测试和质量对比预留。本批不实现完整实验框架。

验收标准

所有 Runtime Job 记录 promptVersion。
所有 Runtime Result 记录 schemaVersion。
所有模型调用日志记录 promptName / promptVersion。
后续可以根据版本筛选失败率和质量反馈。
文档说明第一阶段 Prompt 模板实际存放在 Runtime 项目，API 只记录版本。

## 目标为 AI 分析、题目生成、卡片生成增加 Prompt 版本和输出 Schema 版本追踪能力。 ## 要求 1. AiRuntimeJob 必须记录 promptVersion。 2. AiRuntimeJob 必须记录 outputSchemaVersion。 3. AiRuntimeResult 必须记录 schemaVersion。 4. ModelInvocationLog 必须记录 promptName / promptVersion / outputSchemaVersion。 5. AI 分析结果表必须能追溯 promptVersion。 6. 题目 / 卡片产物必须能追溯生成版本。 ## 可选表第一阶段可以不做完整 PromptTemplate 表，但必须预留字段。后续可扩展： PromptTemplate: id, name, version, content, status, createdAt ## 说明 promptVersion / outputSchemaVersion 字段为后续 Prompt A/B 测试和质量对比预留。本批不实现完整实验框架。 ## 验收标准 1. 所有 Runtime Job 记录 promptVersion。 2. 所有 Runtime Result 记录 schemaVersion。 3. 所有模型调用日志记录 promptName / promptVersion。 4. 后续可以根据版本筛选失败率和质量反馈。 5. 文档说明第一阶段 Prompt 模板实际存放在 Runtime 项目，API 只记录版本。

wangdl added this to the M-API-AI-RUNTIME：API AI Runtime 调度与落库 milestone 2026-06-10 21:02:30 +08:00

wangdl added the

labels 2026-06-10 21:02:30 +08:00

Sign in to join this conversation.