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 助手里用自然语言说需求,比如:
帮我出 10 道计算机网络的选择题,难度中等,放进测试题库Agent 会自己规划步骤:查题库 → 生成题目 → 给你预览 → 等你确认 → 入库。
缺参数时它会问你,而不是瞎猜:
已识别到:主题=计算机网络、数量=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 出得不好,也不会污染正式题库。
常见问题
为什么点了没反应?
按顺序排查:
- Agent 服务起了吗 —— 访问
http://<agent>:9221/health,看status是不是UP - 模型配了吗 —— 同上,看
model段;或在后台「AI 模型配置」里加一条 - 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 能力总览 |
| 我是开发,要接 AI | Agent 接口清单 |