Skip to content

AI 功能总览 ​

这一页是给用砚考办考试的人写的:教师、教务、出题人。 不讲架构,只讲「AI 能帮你省哪些事」。

先确认 AI 是开着的

AI 是可选能力,需要先部署 ruoyi-exam-agent(Python 服务)。 如果界面上看不到 AI 入口,说明服务没起或没配模型, 让管理员看 AI 服务部署与配置。

AI 能帮你做的 12 件事 ​

我想……功能在哪用详细说明
快速出一批题智能出题题库页AI 出题
让选择题的干扰项更有迷惑性干扰项生成试题编辑AI 出题
把一道题变出几个等价版本试题改写试题编辑AI 出题
给存量题补知识点标签知识点打标题库批量操作AI 出题
自动写题目解析解析生成试题编辑AI 出题
检查题目是否有歧义试题质检出题后AI 出题
给简答题先打个分AI 预评阅卷页AI 阅卷
让 AI 复核对不对评分自检阅卷页AI 阅卷
看看 AI 打分是不是偏松评分校准阅卷页AI 阅卷
找出雷同卷雷同检测阅卷页AI 阅卷
知道学生哪里没学会错题归因学情页AI 学情
给学生推该练的题个性化推题学情页AI 学情

还有两个面向试卷与监考的:

我想……功能详细说明
检查卷子出得合不合理试卷审查(覆盖度、难度分布、预计用时)AI 出题
考前预估平均分难度预估AI 出题
快速看懂一堆监考事件监考行为分析在线监考

两种用法 ​

一、点按钮(功能入口) ​

在题库页、阅卷页等位置有明确的 AI 按钮。 点一下,填几个参数,拿到结果。适合明确知道自己要什么。

二、直接说话(AI 助手) ​

在 AI 助手里用自然语言说需求,比如:

text
帮我出 10 道计算机网络的选择题,难度中等,放进测试题库

Agent 会自己规划步骤:查题库 → 生成题目 → 给你预览 → 等你确认 → 入库。

缺参数时它会问你,而不是瞎猜:

text
已识别到:主题=计算机网络、数量=10 道
还缺:题型、题库
[题型 ▾] [题库 ▾]
[继续] [取消]

要改数据时它会先给你看要改什么,你点头才执行。

对话式入口更适合「我知道要什么,但不确定点哪儿」的场景。 详见 对话式 Agent。

AI 不会替你做的四件事 ​

这是设计上的刻意取舍,不是功能没做完。

1. 不会直接定分 ​

AI 给的是建议分。得分旁边会显示置信度:

置信度含义建议
≥ 0.9要点清晰,很有把握可直接采纳
0.6 ~ 0.9基本可判,可能有表述歧义扫一眼
< 0.6判断不了必须自己判,AI 分仅供参考

系统会标出哪些需要人工(needHuman),阅卷时不要跳过这些。

最危险的失败是「静默给 0 分」

如果模型调用失败,砚考会报错,而不是返回 0 分。 因为老师看到 0 分会以为学生真的答错了——这比报错危险得多。

2. 不会直接发考试 ​

发布考试、提交最终分数这类动作,AI 必须拿到你的明确确认才会做。 在对话里它会弹确认卡并明写「写操作会真实改动系统数据」。

3. 不会自己判定作弊 ​

监考分析只会把事件时序整理成证据链给你看, 它的结论永远标记为「需人工确认」。

「该考生在第 12 分钟切屏 3 次,累计离屏 47 秒, 期间摄像头未检测到人脸。」

——是不是作弊,由你说了算。

4. 不会越过你的权限 ​

AI 代你调接口时,用的是你自己的登录身份。 你没权限的操作,AI 也做不了——网关会返回 403。

学生的 AI 助手里看不到「给全班打分」这类能力, 不是靠 AI 自觉,而是压根不告诉它有这些工具。

生成的内容去哪了 ​

内容落库状态需要确认吗
AI 生成的试题草稿需要你确认后才启用
AI 建议分写在 ai_score 字段,不覆盖人工分需要你确认
质检未通过的题单独列出,不入库—

AI 生成的题默认落草稿态,这是安全设计: 哪怕 AI 出得不好,也不会污染正式题库。

常见问题 ​

为什么点了没反应? ​

按顺序排查:

  1. Agent 服务起了吗 —— 访问 http://<agent>:9221/health,看 status 是不是 UP
  2. 模型配了吗 —— 同上,看 model 段;或在后台「AI 模型配置」里加一条
  3. Java 侧找得到 Agent 吗 —— 调 /ai/enabled,注意这个结果缓存 10 秒

为什么出得慢? ​

生成 10 道题要 8~15 秒是正常的(取决于模型)。 批量阅卷是并发的,默认并发 4。

如果特别慢,可能是主模型卡住了在切备用模型—— 查 /api/ai/model/health 的 circuit。

为什么同一道题两次评分不一样? ​

大模型有随机性。评分类提示词的温度设得很低(0.1), 但不能保证完全一致。

这也是为什么评分结果必须经你确认。

能不能换模型? ​

能。底层走 OpenAI 兼容协议,DeepSeek、通义、OpenAI、 本地 Ollama 都能接。在后台「AI 模型配置」里加, 或配环境变量。详见 模型网关。

AI 会不会看到别的租户的数据? ​

不会。所有 AI 调用都带租户 ID,模型配置也按租户隔离。

继续阅读 ​

我想深入了解去哪
怎么用 AI 出题、质检AI 出题与质检
怎么用 AI 阅卷AI 阅卷
怎么用 AI 做学情分析AI 学情与推题
AI 是怎么实现的AI 能力总览
我是开发,要接 AIAgent 接口清单

砚考 · 让每一次考试都经得起检验