這是操作手冊:您要點什麼、以什麼順序點、以及您剛剛點下的東西實際上做了什麼。它假設您已決定試用此平台,並希望這學期順利進行,而不是被推銷任何東西。如果您尚未決定, 總覽頁面會是較短的閱讀。
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 — 認領既有課程
如果您機構的課程目錄已匯入,您的課程很可能已在系統中,您只需認領,而不是建立。
- 從側邊欄:教學工具箱 → 課程設定 → 認領課程。
- 依機構、學期與課程名稱或代碼搜尋,然後認領相符的項目。
- 驗證您的身分:輸入您的機構電子郵件,接收六位數驗證碼,再輸入該驗證碼。 該驗證碼有效時間為 15 分鐘,且兩次發送之間有五分鐘冷卻時間。
- 提交:您的姓名、您的單位,以及可選的支持此認領的文件(授課 證明、聘書、課表截圖——PDF、DOC、DOCX、JPG 或 PNG, 最大 5 MB)。可選,但可加速審查。
- 等待核准電子郵件。您可以在 我的認領申請下方查看進度。
路徑 B — 建立新課程
如果課程目錄中沒有您的課程——對於尚未提供資料給我們的機構來說,這是正常情況——請建立它。驗證步驟相同,審查也相同。
- 必填:課程名稱、機構、學期。其餘內容之後都可以編輯。
- 將您的課綱貼到描述欄位。如果您這麼做,系統 會根據內容起草一組初始的助理指示,這比空白欄位好得多。這是表單上價值最高的可選欄位。
課程預設建立為私密,並附有六位字元的加入代碼。 在您將該代碼提供給任何人之前,任何人都看不到內容。核准電子郵件包含 學生加入連結。
3. 撰寫助教
助教的指示——也就是它的 system prompt——是唯一決定學生是否覺得有用的設定。它可以是任何語言的自由文字,不是程式碼,且可在學期中的任何時候編輯。
位置
Teaching toolkit → Teacher console → 您的課程 → Teacher dashboard → Course management → Course settings。
要放什麼
以下四個元素,依這個順序,已涵蓋大多數重要內容:
- 角色。「您是 Introduction to Political Theory 的教學助教,這是一門大學一年級課程。」
- 課程事實。程度、主要文本、目前已涵蓋的內容,以及任何助教否則可能會猜錯的資訊。
- 如何回答。 深度、範例演算、何時要提出釐清問題、如果您希望固定用哪種語言回覆。
- 界線。 它應該拒絕或轉介什麼——「不要替學生寫 essay」,「關於截止期限的行政問題,請告訴他們直接問我」。
課程助教預設會直接回答。這是刻意如此:卡在凌晨 1 點的學生需要的是答案,而不是課程助教持續以間接提問迴避問題。Socratic questioning 可作為明確模式使用(第 6 章),而獨立學習夥伴 Aida 的設計本來就是 Socratic。請選擇您想要的行為,而不是沿用某一種預設。
常見錯誤
- 太長。 兩千字的指示會比三百字經過精心挑選的指示產生更差的行為。先少寫一些,等您在實際對話中看到不喜歡的地方,再補上規則。
- 相互矛盾的規則。「永遠不要給答案」加上「要有幫助且完整」會以不可預測的方式解決。請先決定哪條規則優先,並明說。
- 屬於教材的事實。 不要把閱讀清單內容貼進 prompt。請上傳閱讀資料(第 4 章)——然後它才能引用它們。
- 只寫一次。 在第二週閱讀一部分真實對話並修訂。這是最有效、也幾乎沒有人會做的改進方式。
4. 加入您自己的教材
上傳的教材是將一般模型轉變為課程助理的關鍵。當學生的問題與您上傳的內容有關時,系統會擷取並使用相關段落,回覆也會引述檔案與頁碼,讓學生能與原始來源核對。
如何操作
- 教師儀表板 → AI knowledge base → 上傳。PDF、DOCX 和 PPTX 是 常見格式。
- 處理會在背景執行;大型檔案通常可在幾分鐘內可用,而不是 立即。
- 上傳學生實際使用的閱讀材料——講義投影片、您有權分發的章節、您自己的筆記、過去的解題範例。
- 沒有文字層的掃描 PDF。 就檢索而言,拍攝的書籍章節只是一張影像。如果您能在 PDF 檢視器中選取文字,就能運作;如果不能,請先執行 OCR。
- 您不得分發的教材。 上傳就是將教材分發給您的班級。著作權責任由您自行承擔,和您在貴校自己的 LMS 上完全相同。
它在下游能啟用什麼
- 在對話中提供有依據、可引用的回答。
- 根據您實際的內容,而不是模型的一般知識,草擬測驗與作業單。
- 課程知識圖譜,會從教材中擷取概念及其關係,接著追蹤每位學生已展現理解的概念。沒有上傳教材,就無法產生。
精確的檢索參數——chunk size、embedding model、top-k——已在 檢索方法說明(中文)中為方法章節記載。
5.選擇模型
多數課程從不碰這個頁面,也沒問題。只有在您有特定理由時,才閱讀本章。
| 選項 | 需要 API 金鑰嗎? | 何時使用 |
|---|---|---|
| 平台預設(免費方案) | 否 | 所有情況,除非您有其他理由。會自動在每門課程啟用;如果您不做任何變更,學生拿到的就是這個。 |
| 進階 OpenAI 模型 | 是 — 您課程自己的 OpenAI 金鑰 | 題目確實需要更重推理的課程:基於證明的數學、複雜的程式碼審查、深度分析工作。 |
| Anthropic 或 xAI 模型 | 是 — 該供應商的金鑰 | 當您特別想要不同的供應商時,包括作為模型差異的教學重點。 |
這個設定位於教師控制台中的 Models and API keys。金鑰是以課程為單位,該金鑰上的使用費由供應商向該帳戶收取。只有在有效金鑰到位後,學生才可以選擇進階模型;沒有金鑰時,課程就直接使用免費預設值運作。
認知層級分類、檢索索引,以及其他分析工作,一律在平台容量上執行,即使是在提供自有金鑰的課程中也是如此。您的金鑰只支付學生對話所消耗的部分。
6. Socratic 與辯論模式
兩種可選模式,可依課程啟用,並圍繞您定義的主題組織。兩者都是課程功能——學生為自己建立的個人助理中不提供這些功能。
| 模式 | 助理的做法 | 適用情境 |
|---|---|---|
| Socratic dialogue | 以提問而非回答開始,針對您設定的主題,並持續追問理由。 | 概念形成工作、倫理、詮釋,以及任何重點在於學生自身表述的內容。 |
| Debate | 主張某個立場,讓學生必須回應一位真實的對話者,而不是空白頁。 | 論證練習、研討課前準備、檢視一個班上過於輕易同意的立場。 |
如何善用
- 給它們一個時段,不要用在整門課。 一次設計良好的 Socratic session,而且學生知道它會來,勝過整個學期都開著這個模式。
- 把主題寫成一個包含真實分歧的問題。「在一個正常運作的民主制度中,公民抗命是否曾經正當?」會產生對話;「討論公民抗命」只會產生摘要。
- 告訴學生這個模式在做什麼。 一個突然拒絕直接回答的助理,除非學生知道這是刻意設計,否則看起來就像故障。
- 不要把它用在查找事實。 為了完成一份習題集而必須回答定義,這種經驗令人惱火,不具教育性。
若您想要前後對照的衡量,而不是單純的印象,Socratic session 周邊的前測與後測評量可供使用;方法記載於 the Socratic pre/post note(Chinese)。
7. 讓學生加入
課程在建立時是私密的。共有四種加入方式,而且您可以同時使用不只一種。
| 路徑 | 運作方式 | 最適合 |
|---|---|---|
| 加入代碼 | 六個字元。學生輸入後會立即加入,沒有審核步驟。 | 一般情況。請在第一週放在投影片上。 |
| 已註冊名單 | 您貼上學生學號名冊;名單中的學生開啟課程連結時會自動加入。 | 您已經有正式名冊的大型課程。 |
| 申請與核准 | 沒有代碼的學生會申請存取;您或助教核准或拒絕。雙方都會收到電子郵件通知。 | 晚加入者、旁聽生、來自其他學程的學生。 |
| 公開課程 | 任何持有連結的人都可以加入,沒有代碼也不需要核准。 | 開放式工作坊與示範。不適用於一般課程。 |
實務注意事項
- 請在課堂上完成加入。 螢幕上顯示代碼五分鐘,幾乎所有人都能加入。若把它當作作業,就會讓四分之一的班級在好幾週內都缺席。
- 同一個連結也有 QR code,這是講堂中最快的加入路徑。
- 重新產生代碼會立即使舊代碼失效。 已經在課程中的學生不受影響;尚未加入的學生需要新的代碼。如果代碼外流到課堂之外,才重新產生,不要隨便做。
- 重複的錯誤代碼嘗試會依帳號進行速率限制,因此外洩的部分代碼無法被暴力破解。
- 代碼只有教師和助教看得到——課程中的學生無法從介面讀出代碼並轉傳。
- 您可以在任何時候將課程在私密與公開之間切換。
8. 學期中的課程作業
下列工具皆為選用。只使用助理、其餘什麼都不做,也完全可以完成一門課程。 一次新增一項;第一週就加五項,是到了第四週把它們全部棄用的最可靠方式。
| 工具 | 功能 | 您應該知道的事 |
|---|---|---|
| 測驗 | 依據您的教材,按題型與難度草擬題目;您再編輯並發布。 | 在您發布之前,不會有任何內容送達學生。請將草稿視為一位能力良好的助理所做的初稿,而不是完成的評量。 |
| 學習單 | 由教材或課堂錄音逐字稿產生的結構化學習單。 選擇題會自動標記;開放式作答會先行標記,供您確認。 | 先行標記只是建議。每一個開放式作答分數都由您確認或修改。 |
| 討論區 | 課程討論板,可選擇計分機制,依語意品質與同儕回應加權,而非依發文數量。 | 如果您要評分參與度,請使用這個,而不要計算貼文數量——請參見第 10 章。 |
| 問卷 | 平台內問卷,具排定的開放與關閉時間。 | 請優先使用這個,而不是外部表單:回覆會留在與課程其餘部分相同的治理與同意安排之內。 |
| 作業與成績簿 | 提交、批改,以及供其他工具匯入的成績簿。 | 截止時間會以您的本地時間輸入,並顯示在每位學生的。 |
| 課堂錄影 | 課堂期間的音訊、畫面或網路攝影機錄製,並在之後產生逐字稿。 | 分享給學生的功能是關閉的,除非您將其開啟。請告知您的班級您正在錄製——這是您所屬機構的規定,不是我們的規定,而且適用。 |
| 即時教室工具 | 投票、提問牆、文字雲、倒數計時。 | 在教室內有用,離開教室就不太有用。先試一堂課,再考慮以它們來規劃整門課程。 |
| 公告與電子郵件 | 附有附件的課程公告,以及發送給全班的電子郵件。 | 公告是可靠的管道;學生並不可靠地閱讀其他任何內容。 |
| Aida | 一個獨立的學習夥伴,跨越學生的整個學程運作,並且刻意採用 Socratic。 | 它屬於學生,不屬於您。您不會設定它,也看不到它;向學生說明這一點很有必要。 |
9. 讀取分析資訊
這是平台中其他地方沒有的部分,也是最容易過度解讀的部分。這句話的兩個半句都很重要。
認知層級分析
每一則學生訊息都會依據修訂後的 Bloom taxonomy — Remember、Understand、Apply、Analyse、Evaluate、Create — 自動且非同步地分類,您不需要進行任何操作。您可以看到班級分布、個別學生概況,以及整個學期中班級平均如何變化。
- 看趨勢,不要看層級。 絕對分布大致反映您的學科領域與評量設計。當您變更某些內容後,分布出現變化才有資訊意義。
- 預期會有很多 Understand。 在我們看過的每一門課程裡,詢問課程助理的樣子就是這樣。這不是對您學生的發現。
- 方法及其限制:認知層級方法說明(中文)。如果您要發表,請先閱讀 研究手冊第 9 章。
知識圖譜
從您上傳的材料中擷取的概念與關係,並疊加每位學生所展示的涵蓋範圍。其實務用途是在複習週前找出缺口:在您的圖譜上幾乎沒有人在對話中觸及的概念。需要上傳材料(第 4 章)。
學習歷程檔案
依照每位學生的對話、評量與參與情況呈現的檢視。學生可以自行匯出。
- 訊息數量不等於參與度。 一位只問了三個很好的問題的學生,可能比問了四十個問題的學生學得更多。
- 分類是模型輸出。 它在整體上是一致且有用的;但它不是關於單一訊息的事實真相,而且絕不應作為對單一學生做決策的唯一依據。
- 沒有對話不代表沒有學習。 有些學生不使用助理。這是允許的。
10. 評量:唯一規則
您同時掌握成績與資料。在這裡,平台只施加一項禁令,其餘部分交由您的專業判斷。
研究參與——簽署研究同意書、允許資料被用於研究——與課程成績完全分開。拒絕參與,或在學期中途退出的學生,仍然照常上課、仍然使用助理,而且仍然照先前一樣評分;只有其資料會被排除在外。以簽署同意書作為給分依據,或要求參與作為修課條件,都是嚴重的研究倫理違規,而且任何平台功能或措辭都不得暗示相反意思。在教師與學生之間的權力不對等下,附帶成績的「自願」不是自願。
AI 使用的評分由您決定
要求學生使用助理並將其計入成績,與將出席或研討會貢獻納入評分,是同一類決策:它屬於您的教學自主權,而平台既不禁止也不要求。我們的角色是提供資料與品質訊號;您要計入什麼,以及如何計入,取決於您。
訊息數與字數很容易被灌水,而建立在這些數字上的方案,會教學生去灌水。若可行,請評分平台已經完成品質校正的項目:
- Forum 評分——結合加權分數、同儕回饋、語意品質評估與原創性檢查,會自動扣除填充內容。
- Socratic 對話品質——根據內容實質而非數量來評定。
- 認知層次分布——比任何量化指標更接近智識參與,不過請參見第 9 章中的注意事項。
兩點實務提醒
- 請提前公告。 如果 AI 使用會計入成績,請在第 1 週把評分方式寫進課綱。這是一般的評量透明度作法,也可避免大多數爭議。
- 評分會改變資料。 如果您之後想就這門課發表,受到成績誘因驅動而產生的行為,與自發使用並不是同一種現象。請在方法中說明,或將其納入控制。
11. 教學助理
教學助理共同負責課程的運作。共有兩個層級,差異完全在於資料。
| 角色 | 可做事項 | 要求 |
|---|---|---|
| 教學助理 | 執行課程作業工具、核准加入申請、管理成員、評分作業。 | 2FA,和所有教職員帳號一樣。 |
| 資深教學助理 | 以上全部,另外還可匯出課程資料。 | 2FA,並且必須先簽署保密承諾,之後才可進行任何匯出。 |
- 只有在確實需要處理學生資料的人,才授予資深層級——通常是研究中的研究助理,而不是評分人員。
- 存取權限是按課程分開的。某一門課程的教學助理,看不到其他課程的任何內容。
- 學期結束時,請移除相關人員。系統不會替您自動處理。
12. 當事情出錯時
| 症狀 | 通常因為 | 修正方式 |
|---|---|---|
| 學生說代碼無法使用 | 您發出去之後代碼已重新產生,或是他們輸入了外觀相似的字元。 | 在課程管理中檢查目前的代碼,然後重新分享。代碼字母表刻意省略人們容易混淆的字元——0、1、
I、L 和 O 絕不會出現在代碼中,所以以為自己看到 O 的學生,其實看到的是 D 或 Q。 |
| 助理忽略您的指示 | 提示詞太長,或包含兩條彼此矛盾的規則。 | 把它減半,並移除矛盾之處。用出現異常的精確問題進行測試。 |
| 回覆從未引用您的資料 | 沒有上傳、仍在處理中,或 PDF 沒有文字層。 | 檢查知識庫清單;對掃描檔案執行 OCR。 |
| 知識圖譜無法產生 | 未上傳資料。 | 先上傳資料——它是根據您的內容產生的,不是根據課程標題產生的。 |
| 分析是空白的 | 目前對話還不夠多,或班級尚未開始使用助理。 | 請等待。認知層級分析是非同步的,在分布有意義之前需要足夠的量。 |
| 驗證電子郵件始終未送達 | 垃圾郵件過濾,或是機構郵件閘道。 | 先檢查垃圾郵件,再在冷卻時間過後重新寄送。如果仍然失敗,請寄信給我們——我們可以看到它是否已送出。 |
| 學生使用您自己的 API key 時出現錯誤 | 該 key 無效、已過期,或額度已用完。 | 請在 Models 和 API keys 中更換。免費的預設模型在整個過程中都會提供給學生使用,因此在您處理時,課程不會被阻擋。 |
| 您遺失了 2FA 裝置 | 這種事會發生。 | 請使用復原碼。如果您沒有,請從您已驗證的機構電子郵件地址寄信給我們。 |
這個表格未列出的任何問題:[email protected]。 請包含課程名稱以及您預期會發生的情況。沒有工單系統,也沒有保證的回應時間——準確的描述比緊急的說法更容易得到較快的回覆。
13. 第一週檢查清單
- 帳號已建立並已啟用 2FA,復原代碼已存放在其他地方。
- 課程已認領或建立,並已收到核准。
- 助理指示已撰寫——角色、課程事實、如何回答、界線。
- 核心閱讀資料已上傳,並自行提出一個測試問題,以確認助理會引用這些資料。
- 您的 AI 政策已寫入課程大綱,包括是否將使用情況納入評分。
- 加入代碼已放在投影片上,並保留五分鐘課堂時間供學生加入。
- 您的行事曆中已為第二週加上一則備註:閱讀二十段真實對話,並修訂指示。
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.