高校AI平台如何连接教务系统？

定义：连接教务到底在连接什么

在高校语境里，AI平台连接教务系统，是指在统一身份和授权之下，让问答、办事助手或智能体按约定读取教务主数据中的最小必要字段，并在需要办理时把人送回教务原系统或指定人工岗。它连接的是对象、字段、频率、责任科室和流程边界，而不是“拿到一个库账号就算集成完成”。更完整的对照摘要见高校AI智库 · 教务对接专题。

教务主数据通常覆盖培养方案、开课、课表、选课、成绩、学籍、毕业资格审核所需的过程状态。这些对象的更新节奏和风险并不相同。培养方案按学期或培养周期发布；课表在排课窗口频繁变化；成绩在录入、复核、发布三个阶段含义不同；学籍异动一旦写错，会连带资助、住宿、毕业和学历注册。把它们接进同一条“智能体工具”而不加分类，等于把排课查询和成绩更正当成同一种能力。

因此，对接对象至少要同时说清五件事：数据对象是什么、字段字典如何定义、同步或查询频率是多少、责任科室是谁、该对象允许只读还是必须走原系统写入。少任何一件，后续的中间库、提示词和智能体工作流都会在学期高峰互相打架。校级平台如何分层承载这些接口，见高校人工智能平台建设指南；智能体如何在授权范围内调用工具，见高校智能体怎么建设。

它不是什么

• 它不是把教务全部表结构同步进向量库，再让模型自由拼接学生记录。
• 它不是院系各自用只读账号导出成绩册，再贴进未评估的外部对话工具。
• 它不是接口通了就宣布集成完成，却说不清字段延迟、空值和权限失败时怎么办。
• 它不是平台缓存与教务页面不一致时，由模型“综合判断”一个看起来完整的答案。

与“连接教务”并列的常见误解还有两类。一类把知识库里的培养方案摘录当成现行方案，学期调整后仍继续引用旧文件。一类把办事助手里的“帮我提交异动”理解成自动写库，实际上只应生成材料清单并跳转原系统。两种误解都会在开学、选课和毕业季集中暴露。安全与字段出域的底线，应同时对照安全与合规边界。

为什么必须先做读写分离

学校推进教务类智能问答时，真正卡住上线的往往不是“接口有没有文档”，而是四类同时出现的治理问题。

第一，对象和责任科室没有列表。信息化拿到若干视图或中间表，却说不清培养方案由谁发布、课表何时冻结、成绩何时对学生可见、学籍异动由哪个科室终审。没有这张清单，智能体只能按字段名猜测，答对了无法复用，答错了无人签字。

第二，查询和写入被绑在同一条通道上。课表查询需要稳定、可缓存、可按角色过滤；成绩更正需要审批、附件、双人复核和正式落库。如果建设方案只写“接入教务接口”，却不写哪些接口只读、哪些动作必须回到原页面，上线后就会出现“一句话改成绩”的错误预期。

第三，主数据冲突没有规则。平台为了降低时延会做中间库或本地缓存，知识库还会摘录培养方案文本。一旦排课调整、成绩撤回发布或方案微调，副本与教务页面就会分叉。没有“以教务为准、副本只作提示、冲突即停答”的规则，模型会用过期课表或未发布成绩填满对话。

第四，异常路径没有回切。选课高峰、成绩发布窗口和毕业审核期，教务接口更容易超时、返回空值或触发限流。如果助手在失败时改用“经验回答”，学生会把编造结果当成官方通知。联调必须覆盖异常、超时、空值、权限失败，并准备切回教务页面或人工窗口的话术和入口。

因此，对接决策应先回答：这个对象能否只读、字段对谁可见、延迟能否接受、写操作落在哪一个原系统步骤。四个问题清楚后，再决定正式接口、中间库还是人工转办，而不是先给智能体开通库权限再补制度。方法应纳入校级身份、网关和日志，而不是每个院系单独要账号，参见校级智能体与数据治理平台。

实践中还常见三类偏差，值得在立项会上提前排除。一是把“数据中台已有教务主题”写成可以任意生成学生成绩单，忽略发布状态和本人授权。二是厂商用生产只读账号做全表扫描，再在演示环境里展示跨班排名。三是查询接口和写接口共用一个应用密钥，密钥泄露后无法只回收写入能力。纠正这些偏差不需要先换教务厂商，需要先补对象清单、读写分流和最小权限。

五步对接：从对象清单到回切演练

第一步：列出数据对象、字段、更新频率和责任科室

建议至少覆盖培养方案、开课信息、课表、选课结果、成绩、学籍状态、毕业审核进度七类对象，并分别写下：主键、业务含义、对学生/教师/教务管理员的可见条件、更新窗口、权威页面、责任科室和联系人。频率不要只写“实时”。课表在排课期可能按小时变化，冻结后按天核对即可；成绩在未发布前对智能体应视为不可见，而不是“库里有就查得出”。

盘点输出应是一张学校能签字的对象表，而不是厂商接口清单的复印件。接口名可以后补，对象对错必须先由教务处确认。没有责任科室的对象，不得进入首期智能体工具。

第二步：优先正式接口或中间库，主数据仍以教务为准

有正式只读接口时，平台经网关按身份调用，记录请求号、时间、操作者和返回码。没有接口、只有库表同步时，应建设中间库：由教务或信息化按约定任务抽取，应用账号只能读中间库，不能持有生产库写权限。无论哪种形态，教务系统仍是主数据。中间库、缓存和知识摘录都要标注数据时间和同步频率，冲突时停止用副本作最终答复。

第三步：给智能体只开放最小字段，并按角色过滤

学号、姓名、行政班可以在“本人查询课表”时出现；身份证号、家庭信息、精确排名、未发布成绩、他人学业记录默认不进入模型上下文。教师查看课程名单，不等于可以询问全年级成绩分布并生成可下载名册。管理员联调账号必须与演示账号、学生账号分开，避免把超管可见字段写进通用提示词。

第四步：把查询与异动、成绩更正分成两类流程

查询类流程：校验身份 → 调只读接口或中间库 → 过滤字段 → 引用数据时间和来源 → 回答或拒答。办理类流程：识别意图 → 说明不能代办 → 列出材料与教务入口 → 转原系统或人工岗 → 可选回写“已提交/办理中”等状态查询。两类流程不要共用一个“执行SQL”工具。智能体可以检查材料是否齐全，但不能把自然语言当成审批意见。

第五步：联调异常、超时、空值和权限失败，并准备回切

测试集至少包含：本人有课表、本人无课、跨学期方案、成绩未发布、学籍异动办理中、接口超时、返回空对象、角色越权、令牌过期。每一种失败都要有可见提示和回切动作：打开教务网、转科室窗口或登记人工回访。回切方案还应写明：何时停用智能体教务技能、如何把流量切回公告和原页面、谁有权宣布恢复。没有回切说明的对接，只是扩大故障半径。

比较：直接改库与读写分离

下表用于立项和联调讨论，不构成唯一合法或唯一技术路线。具体学校还需对照网络安全、教育数据分类分级、教务管理规定和校内审批制度。

选择读写分离，不是否定自动化，而是把自动化限制在可撤回、可对账的一侧。查询可以自动，办理必须可追踪。一所学校可以先开通本人课表和培养方案查询，再把异动申请做成跳转，最后才评估是否通过教务提供的正式办理接口回传状态。顺序不能反过来。

建设步骤：输入、角色、动作与输出

下列步骤按时间顺序排列。每一步都写出输入、责任角色、动作和输出，便于写入项目计划和验收清单。角色名称可按学校处室调整，但不能出现“只有厂商、没有教务主责”。

1. 冻结场景与禁止事项

动作：从候选事项中选出可评价的查询试点，例如本人课表、现行培养方案、开课检索；把选课替代提交、成绩异议自动裁定、学籍直接变更列入禁止清单。输出：场景说明书、禁止事项和“暂缓对接”对象表。

2. 完成对象、字段与科室盘点

动作：按对象填写字段、更新频率、责任科室、可见角色和能否进入模型上下文。输出：对象清单、字段字典草稿和科室确认记录。没有科室签字的字段，不得进入联调。

3. 落地只读通道与主数据规则

动作：为每个对象选择正式只读接口或中间库抽取；写明主数据以教务为准、副本延迟如何提示、冲突如何停答。输出：接口清单、同步频率、主数据冲突处理规则和拓扑说明。

4. 配置两类流程与最小权限

动作：查询流程只调只读工具；异动与成绩更正只允许生成清单并跳转原系统或人工岗。按角色过滤字段，禁止把超管结果写入通用提示词。输出：读写分离流程图、权限矩阵和提示词/拒答规则。

5. 联调、失败回放与试运行切换

动作：在约定角色和时刻对照教务页面复测；记录超时、空值、权限失败和恢复时间；演练停用技能并回切。输出：测试账号清单、用例与失败回放、试运行结论和是否扩大查询范围的决定。

如果某一步缺少输出物，不要进入下一范围。尤其是没有字段字典就开放成绩查询、没有冲突规则就做全校课表缓存、没有回切演练就宣布“教务已接入”，都会在选课或毕业季暴露。

主数据、字段与同步：副本不能裁决教务

主数据规则的目的，是防止平台在“答得很快”的同时成为第二套教务账。任何把中间库、向量摘录或模型记忆写成最终依据的做法，都会在调课、撤分、方案微调后伤害师生信任。正确顺序是：教务页面和正式接口为权威，平台副本标注时间，冲突时停答并回切。

常见对象如何写进字典

培养方案。权威在教务处发布的现行方案版本。字段通常包括专业代码、年级、课程模块、学分要求和生效学期。更新频率按发布和修订窗口，而不是每次对话实时生成。智能体引用时必须带版本或生效年级；未发布修订稿不得对学生可见。

开课与课表。权威在排课结果和教室占用。字段包括课程号、教学班、时间地点、教师公开显示名、周次。排课期同步可以较密，冻结后按日核对。对教师显示的教学班名单，不得自动扩展为可下载的学生联系方式。

选课结果。对学生本人可查已选教学班和冲突提示；代他人查询、批量导出、模拟改选并写回，均超出只读范围。若学校希望助手“提醒漏选”，也只能基于已发布规则和本人已选结果，不能替学生提交志愿。

成绩。必须区分录入中、复核中、已发布。未发布成绩对智能体视为不存在。已发布成绩仅限本人或授权教务角色，且默认不提供精确排名、不及格名单的跨班汇总。成绩更正属于办理类流程，只能转原系统或人工岗。

学籍与毕业审核。状态查询可以告知“在籍/异动办理中/待审材料”，但原因说明、处理结论和电子注册相关字段应尽量让学生回到教务或学籍窗口。智能体不得修改学籍状态，也不得根据聊天内容“判断”能否毕业。

冲突处理应写成可执行规则

• 同一对象在教务页面与平台副本不一致时，答复必须以教务为准，或提示“请以教务网当前显示为准”。
• 副本超过约定同步阈值，查询类技能应降级，而不是继续用旧课表填满时间地点。
• 知识库中的方案摘录与教务方案接口冲突时，下线摘录或改引用接口，不得让模型折中措辞。
• 成绩、学籍出现冲突，默认转人工，不在对话里给出可被截图传播的最终结论。
• 每次冲突记录对象、时间戳、接口返回、页面截图编号和责任科室，形成失败回放，而不是口头说“刷新一下就好”。

交付物与验收

核心交付物

• 接口清单、字段字典和同步频率：每个对象写清来源、只读或转办、延迟和责任科室。
• 读写分离流程图：查询链路与异动、成绩更正链路分开，标出身份校验、字段过滤和人工节点。
• 测试账号、用例和失败回放记录：覆盖本人、教师、越权、空值、超时和未发布成绩。
• 主数据冲突处理规则：副本与教务不一致时的停答、提示、下线和科室升级步骤。

交付还应附带网关策略、日志字段说明、回切公告和账号回收表。没有失败回放的联调报告，不能视为通过。演示成功不能覆盖越权用例失败。

验收应覆盖的条目

• 查询一致：用双方确认账号对照教务，课表、方案、开课和已发布成绩的可见字段一致。
• 字段不越权：他人成绩、未发布成绩、身份证号、跨班名册不会被拼进回答或日志展示。
• 写入不直连：选课提交、成绩更正、学籍异动必须回到原系统或人工岗，平台无生产写权限。
• 中断不编造：接口超时、空值和权限失败出现降级提示，并给出教务入口，不补全分数和课表空档。
• 冲突可处理：人为制造副本延迟后，系统按规则停答或提示以教务为准，并能在回放记录中检索。
• 文档可移交：对象表、字典、流程图、用例和回切说明可由学校人员独立执行或监交。

验收必须使用教务处确认的测试数据和业务流程，而不是厂商演示脚本。未通过项应列出缺陷、责任方和复测时间。技术参数建议按“对象—角色—条件—期望—证据”书写，例如：学生账号在成绩未发布时查询应得到拒答或“暂未发布”；教务接口中断时助手不得输出具体节次。不要写无法验证的“全面打通教务”或唯一库账号方案。