成绩录入与学分认定的资料版本与变更维护:引用来源与溯源

围绕成绩录入与学分认定的资料版本与变更维护,说明引用来源与溯源的配置前提与核对动作,结合成绩单、缓考申请确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

本页围绕成绩录入与学分认定品类,处理成绩单、缓考申请、补考安排三类材料的版本与引用溯源。成绩单是学分认定的主记录,字段含课程名称、学分、成绩、任课教师签字与日期;缓考申请是流程前置材料,含申请事由、原考试日期、审批签字与回执;补考安排是后续安排材料,含补考时间、地点、监考签字与回执。三类材料常由不同环节分别维护,更新节奏不同:成绩单随成绩发布变更,缓考申请随审批流转变更,补考安排随考务调整变更。材料进入知识库检索节点时,各自作为可被引用的原文片段,由引用内容数组带出来源标识,供后续比对字段、写台账、生成报告。同一记录在两份材料里的名称、数量、日期对不上,版本未同步,缺签字或回执,都会让引用与原文无法回指。

配置怎么定

这一环由知识库检索节点的引用输出执行,输出引用内容数组,每条含原文片段与来源标识,长度可以为 0。「版本台账与变更记录」由后续 AI 节点、代码节点或人工接着完成。

对象判断核验动作
成绩单字段含课程名称、学分、成绩、任课教师签字与日期,与缓考申请、补考安排里的同一记录名称、数量、日期需一致在引用数组里逐条打开来源标识,对照成绩单原文段落,核 quoteList 里的字段与签字日期
缓考申请字段含申请事由、原考试日期、审批签字与回执,与成绩单里的课程名称、日期需对得上用同一课程名检索,看引用片段是否回指缓考申请原文,核签字与回执是否齐全
补考安排字段含补考时间、地点、监考签字与回执,与成绩单、缓考申请里的日期需一致核 responseData(开启详情返回后的非流式模块结果) 中引用条数与命中材料是否一致,再看补考安排原文的日期与签字
知识库检索节点选中的是同一向量模型的知识库,引用内容以数组输出,长度可以为 0核已选集合与它们的向量模型;用无匹配材料的问句试跑,看输出为空而链路继续;引用上限只核引用文本的 tokens,数组条数单独记录

容易做错的三处

  • 现象:同一课程在两份材料里的名称或日期对不上。原因:成绩单与缓考申请、补考安排各自维护,版本未同步,引用片段只回指其中一份。
  • 现象:引用数组为空但回答仍在继续。原因:本轮未命中材料,空数组是正常输出,不等于检索失败,需先核命中情况再看裁剪。
  • 现象:引用片段与原文对不上。原因:先核本轮是否命中、命中的是哪条材料,再看 quoteMaxToken 裁剪,不直接归因于长度裁剪。

怎么确认配好了

本功能验收:问一个有原文依据的问题,核引用数组与角标能否回指原文,并核 quoteList 与 responseData 里的来源标识;再问一个无匹配材料的问题,确认数组为空而链路走通。

业务测试:改一处内容,看版本号与引用是否同步更新。

  • 在节点里核对已选知识库集合与它们的向量模型,确认选中的是同一向量模型的知识库。
  • 打开搜索参数面板逐项核对取值,与知识库检索一节里设置的取值一致;引用上限只核引用文本的 tokens,数组条数单独记录。

References