在 Uedu 上运行课程 — Uedu handbook

这是一份操作手册：你要点击什么、按什么顺序点，以及你刚刚点击的东西实际上做什么。它假定你已经决定试用该平台，并且希望学期顺利进行，而不是被推销任何东西。如果你还没有决定，概览页会更简短。

1. 开始之前

你需要什么

一个浏览器。 不需要你或你的学生安装任何东西。近期版本的 Chrome、Edge、Firefox 或 Safari。
一个机构邮箱地址。 你可以用任何方式登录，但申领或创建课程需要通过学术域名验证（ .edu、.edu.tw、.ac.jp 及类似域名）。个人地址，例如 Gmail，不接受用于这一步。
手机上的验证器应用。教师账户必须使用双重身份验证——见下文。
大约两个小时用于首次课程设置：大约一小时编写助手说明，一小时上传材料。

创建账户

前往 uedu.tw/signin，并使用 Google、Apple、 GitHub、通行密钥，或电子邮件和密码登录。如果你的机构有自己的入口（yourschool.uedu.tw），就改用那个——它是同一个平台，只是带有你们机构的品牌标识，而无论哪种方式，所有账户和课程的工作方式都完全相同。

教师必须启用双重身份验证，这不是可选项

每个拥有教师、教学助理或管理员权限的账户都必须启用 2FA，在设置完成之前，其他功能都会保持受限。原因很明确：教师账户可以阅读学生对话。请在课程申领获批的同一次操作中完成设置，并将恢复代码存放在不是同一部手机的地方。

界面语言和时区

界面提供 16 种语言；切换器在页眉中，设置会跟随你的账户。学生会独立于你自行选择语言。
无论界面语言是什么，学生都可以用自己写作的任何语言与助手对话。
时间以 UTC 存储，并按每个查看者的本地时区显示。你设置的 23:59 截止时间会正确显示给另一国家的学生——你不需要计算时差，也不应该尝试这样做。

2. 获取课程

课程是所有内容依附的单位：助理、材料、课程作业、分析。获取课程有两种方式，两种方式都以一次简短的人工审核结束，以确认你就是你所说的教师。

路径 A — 认领已有课程

如果你所在机构的目录已经导入，你的课程很可能已经在系统中，你只需认领，而不是创建。

从侧边栏进入：Teaching toolkit → Course setup → Claim a course。
按机构、学期以及课程名称或代码搜索，然后认领匹配的条目。
验证身份：输入你的机构邮箱，接收一个六位数验证码，再输入它。验证码有效期为 15 分钟，且两次发送之间有五分钟冷却时间。
提交：你的姓名、你的单位，以及可选的支持该认领的文件（教学证书、聘任函、你的课程表截图——PDF、DOC、DOCX、JPG 或 PNG，最大 5 MB）。可选，但它会加快审核。
等待批准邮件。你可以在 My claim requests 下查看进度。

路径 B — 创建新课程

如果目录中没有你的课程——对于尚未向我们发送课程目录的机构来说，这通常就是情况——那就创建它。验证步骤相同，审核也相同。

必填：课程名称、机构、学期。其他内容之后都可以编辑。
将你的课程大纲粘贴到说明字段中。 如果你这样做，系统会据此起草一组初始的助理指令，这比空白框好得多。这是表单中价值最高的可选字段。

一旦批准

课程默认创建为私有，并带有一个六位加入码。在你把该代码发出去之前，任何人都看不到。批准邮件包含学生加入链接。

3. 编写助理

助理的指令——它的系统提示——是决定学生是否觉得它有用的唯一设置。它可以是任何语言的自由文本，不是代码，并且可以在学期中的任何时候编辑。

位置

教学工具包 → 教师控制台 → 你的课程 → 教师仪表板 → 课程管理 → 课程设置。

应写入什么

按这个顺序的四个要素，涵盖了大多数重要内容：

角色。“你是政治理论导论这门一年级本科课程的教学助理。”
课程事实。层级、主要文本、目前已经讲到哪里，以及助理本来可能会猜错的任何内容。
如何回答。回答深度、是否给出带步骤的示例、何时提出澄清性问题、如果你希望固定用某种语言回复，则写明。
边界。它应该拒绝什么或转介什么——“不要替学生写论文”，“关于截止日期等行政问题，请告诉他们来问我”。

你是“政治理论导论”这门一年级本科课程的教学助理，课程以英语授课。课程文本：柏拉图的《理想国》（第 I–IV 卷）、霍布斯的《利维坦》（第 13–18 章）、罗尔斯的《正义论》（第 1 章）。如何回答： - 先用通俗语言解释，再使用文本中的词汇。 - 当学生陈述一个立场时，在表示同意之前，先问它最有力的反对意见会是什么。 - 当你依据文本回答时，引用该文本，并注明卷和章。边界： - 不要起草或重写学生的论文。改为评论结构和论证。 - 如果被问到评分、截止日期或我的政策，请说你不知道，并告诉学生直接问我。 - 如果问题超出课程范围，简短回答，并说明它超出我们的范围。

默认是“好好回答”，而不是“苏格拉底式提问”

课程助理默认直接回答。这是有意为之：凌晨 1 点卡住的学生需要的是答案，而不是课程助理持续拐弯抹角地提问，这样会显得像在回避。苏格拉底式提问可作为明确模式使用（第 6 章），而独立学习伙伴 Aida 的设计本身就是苏格拉底式的。应选择你想要的行为，而不是继承某一种。

常见错误

太长。两千字的指令会比三百字精心挑选的指令产生更差的行为。先少写，然后在实际对话中看到你不喜欢的内容时再添加规则。
相互矛盾的规则。“永远不要给答案”加上“要有帮助且完整”会导致不可预测的结果。决定哪条优先，并明确说出来。
应放在材料中的事实。不要把你的阅读清单内容直接粘贴进提示词。上传阅读材料（第 4 章）——这样它才能引用它们。
只写一次。在第二周阅读一部分真实对话并进行修改。这是能得到的最快改进，而且几乎没人会这么做。

4. 添加你自己的材料

上传的材料会把一个通用模型变成课程助理。当学生的问题涉及你上传的内容时，系统会检索并使用相关段落，回复中会引用文件和页码，方便学生对照原始来源。

如何操作

教师控制面板 → AI 知识库 → 上传。PDF、DOCX 和 PPTX 是常见格式。
处理在后台运行；大文件通常可在几分钟内可用，而不是立即可用。
上传学生实际会用到的阅读材料——讲义幻灯片、你有分发权的章节、你自己的笔记、以往的完整示例。

有两件事会悄无声息地失效

没有文本层的扫描版 PDF。 从检索的角度看，拍摄的书章节内容只是图像。如果你能在 PDF 阅读器中选中文本，它就能工作；如果不能，请先运行 OCR。
你可能无权分发的材料。 上传就意味着向你的班级分发。版权责任由你承担，和在你所在机构自己的 LMS 上完全一样。

它在后续环节能实现什么

在对话中给出有依据、带引用的回答。
根据你的实际内容，而不是模型的一般知识，起草测验和练习单。
课程知识图谱会从材料中提取概念及其关系，然后追踪每个学生已经证明理解了哪些概念。没有上传材料，就无法生成它。

精确的检索参数——分块大小、嵌入模型、top-k——已在检索方法说明（中文）中为方法部分记录。

5．选择模型

大多数课程都不会接触这一页，而且也没有问题。只有在你有具体理由时，才阅读本章。

选项	需要 API 密钥吗？	何时使用
平台默认（免费层）	否	所有情况，除非你另有理由。会在每门课程中自动启用；如果你不做任何更改，学生得到的就是它。
高级 OpenAI 模型	是——你课程自己的 OpenAI 密钥	那些问题确实需要更强推理的课程：基于证明的数学、复杂代码审查、深入分析工作。
Anthropic 或 xAI 模型	是——该提供方的密钥	当你明确希望使用不同提供方时，包括作为关于模型差异的教学点。

该设置位于教师仪表板中的 Models and API keys 下。密钥按课程设置，某个密钥上的使用费用由提供方计入该账户。只有在有效密钥到位后，学生才可以选择高级模型；如果没有，课程就只运行免费的默认模型。

后台分析从不在你的密钥上运行

认知层级分类、检索索引以及其他分析工作，始终运行在平台容量上，即使是在提供了自己密钥的课程中也是如此。你的密钥只为学生对话所消耗的部分付费。

6. 苏格拉底式与辩论模式

两种可选模式，按课程启用，并围绕您定义的主题组织。两者都是课程功能——学生为自己创建的个人助手中不可用。

模式	助手的行为	适合用于
苏格拉底式对话	围绕您设定的主题，以提问而不是回答来引导，并持续追问理由。	概念形成工作、伦理、解释，以及任何学生自己的表述本身就是重点的内容。
辩论	为某一立场进行辩论，使学生必须回应一个真实的对话者，而不是面对一张白纸。	论证练习、研讨课准备、检验一个班级过于轻易就同意的立场。

如何有效使用

给它们安排一个时段，不要覆盖整个课程。 一次构思良好的苏格拉底式环节，只要学生知道它会出现，就比整个学期都开启该模式更有效。
把主题写成一个包含真实分歧的问题。“公民不服从在一个运作良好的民主中是否总是正当的？”会产生对话；“讨论公民不服从”只会产生摘要。
告诉学生该模式在做什么。 如果学生不知道这是有意为之，一个突然拒绝直接回答的助手看起来就是故障。
不要把它用于事实检索。 在您需要某个定义来完成题组时，还被反复追问这个定义，只会令人恼火，而不是有教育意义。

如果您希望获得前后对照的衡量，而不是印象，苏格拉底式环节前后测评是可用的；该方法记录在苏格拉底式前后测说明（中文）中。

7. 让学生加入

课程在创建时为私有。有四种加入方式，而且可以同时使用不止一种。

途径	运作方式	最适合
加入码	六个字符。学生输入后即可立即加入，无需审批步骤。	常规情况。第一周放在幻灯片上。
已登记名单	你粘贴学生学号名单；名单中的学生打开课程链接时会自动加入。	你已经有官方名册的大班课程。
请求并批准	没有代码的学生请求访问；你或助教批准或拒绝。你们双方都会收到电子邮件通知。	迟到的加入者、旁听生、来自其他专业的学生。
公开课程	任何拥有链接的人都可以在没有代码和审批的情况下加入。	开放式工作坊和演示。不适用于普通课堂。

实用说明

在课堂上完成加入。把代码投到屏幕上，花五分钟就能让几乎所有人加入。把这件事布置成作业，会让四分之一的班级在几周内都无法加入。
同一链接还有二维码，这是在阶梯教室里最快的加入方式。
重新生成代码会立即使旧代码失效。已经在课程中的学生不受影响；尚未加入的学生需要新代码。如果代码泄露到班级之外，就重新生成，不要随意这么做。
对同一账户的重复错误代码尝试会被限速，因此泄露的部分代码无法通过暴力破解。
代码只对教师和助教可见——课程中的学生无法从界面中读出并转发。
你可以随时将课程在私有和公开之间切换。

8．学期中的课程作业

下面的工具都可选。一个完全合适的课程只使用助手，除此之外不需要任何东西。一次只添加一项；第一周加五项，是到第四周把它们全都弃用的最可靠方式。

工具	作用	你应当知道的事项
测验	按类型和难度从你的材料中起草题目；你进行编辑并发布。	在你发布之前，任何内容都不会到达学生。把草稿看作一位能力不错的助手做的初稿，而不是一份完成的评估。
练习单	根据材料或课堂录音转写生成的结构化练习单。选择题会自动标记；开放式回答会预先标记，供你确认。	预先标记只是建议。你需要确认或更改每一道开放式回答的分数。
讨论论坛	课程讨论板，带有可选的评分方案，按语义质量和同伴回应加权，而不是按发帖数。	如果你给参与度评分，请用这个而不是统计发帖数——见第 10 章。
调查	平台内调查，带有计划好的开启和关闭时间。	优先使用这个，而不是外部表单：回应会保留在与课程其余部分相同的治理和同意安排之内。
作业和成绩册	提交、评分，以及供其他工具汇入的成绩册。	截止时间按你的本地时间输入，并显示在每个学生的。
课堂录制	课堂期间的音频、屏幕或摄像头录制，之后生成转写。	除非你将其开启，否则与学生共享是关闭的。告诉你的班级你正在录制——这是你所在机构的规定，不是我们的，而且它适用。
实时课堂工具	投票、问题墙、词云、倒计时。	在教室里有用，在教室外就很快被忘记。在围绕它们规划课程之前，先在一节课上试用一个。
公告和电子邮件	带附件的课程公告，以及发送给全班的电子邮件。	公告是可靠的渠道；学生并不可靠地阅读其他任何内容。
Aida	一个独立的学习伙伴，贯穿学生的整个学习项目，并且刻意采用苏格拉底式方式。	它属于学生，不属于你。你不会配置它，也看不到它，向学生说明这一点是值得做的。

9. 阅读分析结果

这是平台中其他地方不存在的部分，也是最容易被过度解读的部分。这句话的两半都很重要。

认知层级分析

每条学生消息都会自动、异步地按修订后的布鲁姆分类法——记忆、理解、应用、分析、评价、创造——进行分类，无需你采取任何操作。你可以看到班级分布、单个学生的画像，以及整个学期内班级平均水平如何变化。

看趋势，不要看绝对水平。绝对分布主要反映你的学科和你的评估设计。在你做出某些改变之后发生变化的分布才有信息价值。
预期会有很多“理解”。在我们看到的每一门课程中，向课程助教提问的样子就是这样。这不是对你的学生的发现。
方法及其局限：认知层级方法说明（中文）。如果你要发表，请先阅读研究手册第 9 章。

知识图谱

从你上传的材料中提取出的概念和关系，并叠加每个学生已展示的覆盖情况。它的实际用途是在复习周之前发现差距：你的图谱上几乎没有学生对话触及的概念。需要已上传的材料（第 4 章）。

学习档案

按学生查看跨对话、评估和参与情况的视图。学生可以导出自己的档案。

分析结果不能告诉你的内容

消息数量不等于参与度。一名只问了三个高质量问题的学生，可能比问了四十个问题的学生学得更多。
分类是模型输出。它在总体上是一致且有用的；它不是关于某条单独消息的事实真相，也绝不应成为对单个学生作出决定的唯一依据。
没有对话并不意味着没有学习。有些学生不使用助理。这是允许的。

10. 评估：唯一规则

你同时掌握成绩和数据。平台在这里只施加一项禁止，其余部分留给你的专业判断。

禁止事项：研究绝不与成绩挂钩

研究参与——签署研究知情同意书、允许数据用于研究——与课程成绩完全分开。拒绝的学生，或在学期中途退出的学生，仍然参加，仍然使用助手，也仍然按原样评分；只有其数据被排除在外。把签署同意书作为给分条件，或者要求参与才能上这门课，都是严重的研究伦理违规，任何平台功能或措辞都不得暗示相反含义。在教师与学生之间的权力不对称下，附带成绩的“自愿”不是真正自愿。

是否将 AI 使用计入评分，由你决定

要求学生使用助手并将其计入成绩，这与把出勤或研讨课贡献计入成绩属于同类决定：它属于你的教学自主权，平台既不禁止也不要求。我们的作用是向你提供数据和质量信号；你计什么、如何计，由你决定。

设计建议：质量信号胜过原始计数

消息数量和字数很容易被人为抬高，而建立在这些指标上的方案会教学生去抬高它们。在可以的地方，请对平台已经完成质量调整的内容进行评分：

论坛评分——将加权分数与同伴反应、语义质量评估和原创性检查结合起来，自动扣除填充内容。
苏格拉底式对话质量——按贡献的实质而不是数量来评定。
认知层级分布——比任何数量指标都更接近智识投入，不过请参见第 9 章中的注意事项。

两个实务提醒

提前告知。 如果 AI 使用计入成绩，请在第一周就把方案写入课程大纲。这是常规的评估透明度做法，也能避免大多数争议。
评分会改变数据。 如果你以后想就这门课程发表研究，受成绩激励而产生的行为与自发使用并不是同一种现象。在方法部分说明这一点，或者将其控制住。

11. 教学助理

教学助理共同负责课程的运行。这里分为两个层级，区别完全在于数据。

角色	可做事项	要求
教学助理	运行课程作业工具、批准加入请求、管理成员、批改作业。	2FA，与每个教职工账户相同。
高级教学助理	以上全部内容，外加导出课程数据。	2FA，并且在任何导出成为可能之前签署保密承诺书。

仅将高级层级授予确实需要处理学生数据的人——通常是研究项目中的研究助理，而不是批改员。
访问权限按课程分配。某一门课程上的教学助理看不到其他课程的任何内容。
在学期结束时移除这些人。没有任何功能会替你完成这件事。

12. 出问题时

症状	通常因为	解决办法
学生说代码无法使用	你把代码发出去后又重新生成了，或者他们输入了一个外形相似的字符。	在课程管理中检查当前代码并重新分享。代码字符表刻意省略了人们容易混淆的字符——`0`、`1`、`I`、`L` 和 `O` 永远不会出现在代码中，所以如果学生以为自己看到了 O，他们看到的是 D 或 Q。
助手忽略了你的指令	提示词太长，或者包含两条互相矛盾的规则。	把它删减一半并移除矛盾。用出现异常的原始问题进行测试。
回复从不引用你的材料	没有上传内容、仍在处理中，或者 PDF 没有文本层。	检查知识库列表；对扫描文件运行 OCR。
知识图谱无法生成	没有上传材料。	先上传材料——它是根据你的内容生成的，不是根据课程标题生成的。
分析为空	目前对话还不够，或者班级还没有开始使用助手。	等待。认知水平分析是异步的，在分布有意义之前需要足够的数据量。
验证邮件始终收不到	垃圾邮件过滤，或者机构邮件网关。	先检查垃圾邮件，然后在冷却时间结束后重新发送。如果仍然失败，给我们发邮件——我们可以看到它是否已经发送。
学生使用你自己的 API key 时遇到错误	该 key 无效、已过期，或者配额已用尽。	在 Models and API keys 下替换它。默认的免费模型在整个过程中对学生保持可用，因此在你处理时课程不会被阻塞。
你的 2FA 设备丢失了	这种事会发生。	使用恢复代码。如果你没有，请从你已验证的机构地址给我们发邮件。

本表未列出的任何问题：[email protected]。请附上课程名称以及你预期会发生什么。没有工单系统，也没有保证的响应时间——准确的描述比紧急的描述更能更快得到答复。

13. 第一周检查清单

账户已创建并启用 2FA，恢复代码存放在其他地方。
课程已认领或创建，已获得批准。
助理说明已写好——角色、课程事实、如何回答、边界。
核心阅读材料已上传，并且你已自问一个测试问题，以确认助理会引用这些材料。
你的 AI 政策已写入课程大纲，包括是否计入评分。
加入代码放在幻灯片上，并预留五分钟课堂时间供学生加入。
在你的日历中为第二周记一条备注：阅读二十段真实对话并修订说明。

下一步

打算从课程中发布内容？在学期开始前先阅读研究手册——收集超出日常平台使用范围的任何内容都需要提前安排，而这正是无法事后补救的唯一事项。需要先说服同事或院系？推广手册就是为这类对话而写的。

Previous handbook

Bringing Uedu to your institution

Next handbook

Running a study on Uedu

Something in this handbook wrong, out of date, or missing? Write to [email protected] and say which chapter.

All handbooks · AI teaching overview · Publications · Research governance · uedu.tw

Uedu is developed by Chia-Kai Chang, Assistant Professor at the Center for General Education, National Central University, Taiwan, and is adopted by institutions beyond it. This handbook is available in English · 繁體中文 · 简体中文 · 日本語 · 한국어 · Tiếng Việt · Bahasa Indonesia · Bahasa Melayu · ไทย · Türkçe · Deutsch · Français · Español · Português · Italiano · Ελληνικά. The English version is the reference text. The platform interface itself is available in 16 languages.