成绩录入与学分认定的授权访问与对外服务:引用来源与溯源

围绕成绩录入与学分认定的授权访问与对外服务,说明引用来源与溯源的配置前提与核对动作,结合成绩单、缓考申请确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

本页围绕成绩录入与学分认定场景,把成绩单、缓考申请、补考安排三类材料纳入授权访问与对外服务链路。成绩单承载课程名称、学分、成绩、任课教师签字与开课日期;缓考申请承载申请事由、原考试日期、审批人签字与回执;补考安排承载补考课程、补考时间、考场与监考签字。三类材料进入知识库检索节点后,各自作为独立来源参与引用输出,引用片段回指对应原文段落,来源标识区分材料类型与版本。材料更新节奏跟随教务周期:成绩单在成绩发布后同步,缓考申请在审批完成后归档,补考安排在考前发布。字段特征上,同一记录在成绩单与补考安排中的课程名称、学分数量、日期须一致,版本号与签字回执决定材料是否可对外。对外入口与授权范围由后续节点或人工依据引用数组比对生成,访问者身份与可见范围匹配时开放,越权不可见。

配置怎么定

这一环由知识库检索节点的引用输出执行,输出引用内容数组,每条含原文片段与来源标识,长度可以为 0。可对外的入口与授权范围由后续 AI 节点、代码节点或人工接着完成。引用数组只承载原文片段与来源标识,不承担差异清单、台账、报告或授权范围的生成职责。

对象判断核验动作
成绩单课程名称、学分数量、成绩、任课教师签字与开课日期须与补考安排、缓考申请中的同一记录逐项一致打开引用角标对照来源文档,核对字段与日期;引用条数按数组长度记录,引用文本的 tokens 单独看 quoteMaxToken
缓考申请申请事由、原考试日期、审批人签字与回执齐全,且与成绩单中的课程名称、日期对得上在对话中展开引用片段,回指原文段落;用 quoteList 查看节点输出,确认来源标识指向该材料版本
补考安排补考课程、补考时间、考场与监考签字与成绩单、缓考申请中的同一记录名称、数量、日期一致,版本已同步用一条没有匹配材料的问句试跑,看 responseData(开启详情返回后的非流式模块结果) 中引用数组为空而链路继续走通
对外入口与授权范围访问者身份与可见范围匹配,越权不可见用受限身份访问一次,看可见范围是否符合设定

容易做错的三处

  • 现象:同一课程在成绩单与补考安排里的名称、学分数量、日期对不上。原因:两份材料各自录入,未做字段比对与版本同步。
  • 现象:缓考申请缺审批人签字或回执,材料仍进入对外服务。原因:归档环节未核签字与回执完整性,版本未同步。
  • 现象:回答里没有引用角标,或引用片段与原文对不上。原因:先核本轮是否命中、命中的是哪条材料,再看长度裁剪,不直接归因于裁剪。

怎么确认配好了

本功能验收:问一个有原文依据的问题,核引用数组与角标能否回指原文,引用条数按数组长度记录,引用文本的 tokens 与 quoteMaxToken 单独核对,不做相等比较;再问一个无匹配材料的问题,确认数组为空而链路走通。

业务测试:用受限身份访问一次,看可见范围是否符合设定。

  • 在节点里核对已选知识库集合与它们的向量模型是否一致,并打开搜索参数面板逐项核对取值。
  • 用一条没有匹配材料的问句试跑,看 responseData 中引用数组为空而输出链路继续,并展开 quoteList 对照来源文档。

References