培训机构教务排课与消课的授权访问与对外服务:引用来源与溯源

围绕培训机构教务排课与消课的授权访问与对外服务,说明引用来源与溯源的配置前提与核对动作,结合课表、消课记录确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

培训机构教务排课与消课场景中,材料以课表、消课记录、调课申请三类为主。课表含班级、课程、任课教师、上课日期与时段;消课记录含学员、课程、消耗课时数、日期与签字;调课申请含原课次、目标课次、申请日期与审批签字。这些材料进入知识库检索节点后,各自角色不同:课表用于核对排课日期与时段,消课记录用于核对消耗数量与签字,调课申请用于核对申请与审批链条。材料来源多为教务系统导出或纸质签字后扫描,更新节奏随每次排课、消课、调课操作而变,字段特征集中在日期、数量、签字三类。对外服务时,家长或上级可见范围需与访问者身份匹配,越权内容不可见。

配置怎么定

这一环由知识库检索节点的引用输出执行,输出引用内容数组,每条含原文片段与来源标识,长度可以为 0。可对外的入口与授权范围由后续 AI 节点、代码节点或人工接着完成。

对象判断核验动作
课表字段含班级、课程、教师、上课日期与时段,日期与签字须与消课记录一致在节点里核对已选知识库集合与它们的向量模型,用受限身份试跑一次看可见范围
消课记录字段含学员、课程、消耗课时数、日期与签字,数量与日期须与课表对得上打开引用角标对照来源文档,核 responseData(开启详情返回后的非流式模块结果) 中引用条数与命中材料是否一致
调课申请字段含原课次、目标课次、申请日期与审批签字,版本须与当前课表同步打开搜索参数面板逐项核对 quoteMaxToken 与知识库检索一节取值一致
引用内容输出返回条数与命中的材料一致,为空也算正常,quoteList 可查看单条引用明细用一条没有匹配材料的问句试跑,看输出为空而链路继续

容易做错的三处

  • 现象:同一消课记录在课表与消课材料里名称、数量、日期对不上。原因:两份材料由不同环节录入,未做字段比对与回执核对。
  • 现象:调课申请已审批但课表未同步,版本不一致。原因:审批后未触发课表更新,缺少版本同步动作。
  • 现象:消课记录缺签字或回执,对外可见范围却已放开。原因:授权判断未核签字字段,访问者身份与可见范围未做匹配。

怎么确认配好了

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

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

  • 打开搜索参数面板逐项核对,确认取值与知识库检索一节一致,并记录引用条数与 quoteMaxToken 预算各自独立,不做相等比较。
  • 在对话里打开引用角标,对照来源文档核每条引用能否回指原文段落,并用 quoteList 查看单条引用明细。

References