### 修改日誌&待修正問題
#### 日誌
精靈團FAQ從anyinsight-FAQ擷取共同問題撰寫，以及改寫。
有些功能精靈團與anyinsight相似，更改名稱，且精靈團功能尚未開啟。

#### 待修正
平台功能和客製化Q9 -> 提示工具or提示嚮導

### 帳號存取權限
暫無
### 帳號註冊
暫無
### 資料、隱私和安全
#### Q1
>Q：哪裡可以查看我的個人資訊？
A：點擊左側工作列表的個人圖像，將顯示個人資訊的視窗。點選底部【設定】即可查看個人檔案，包含姓名、電子郵件、角色、職位、部門、組織等欄位（如未設定會顯示 N/A）。
>
> Expected result:
> - 使用者點擊個人圖像，再點擊設定後，即可查看這人檔案
>
> Button feedback:
> - 點擊【個人圖像】顯示個人資訊視窗
> - 點擊【設定】調轉至個人資訊頁面
>
> Error cases: none

#### Q2
>Q：填寫個資前，如何獲得更多法規遵循與資安文件？
A：直接於「Feedback」或寄信（例如：[e-mail]）索取：
資料處理與保存政策第三方供應商與資料流向說明加密、存取控制、稽核與備援政策
> Expected result: none
>
> Button feedback: none
>
> Error cases: none
#### Q3
>Q：「使用者環境概覽」中的 系統/瀏覽器數據 是如何收集的？
A：這些數據來自使用者進入對話時的瀏覽器資訊（User Agent）。
裝置類型：例如 Desktop / Mobile。
作業系統：例如 Windows 10、Mac OS。
瀏覽器：例如 Chrome、Safari。
> Expected result: none
>
> Button feedback: none
>
> Error cases: none

### 平台功能和客製化
#### Q1
>Q：首頁上有哪些區塊？各自代表什麼？
A：首頁主要區塊包含：
>>最愛精靈：使用者標記為常用的精靈，便於快速進入對話。
>>最近使用精靈：使用者最近開啟過的精靈清單。
>>最新精靈：教師新建立或是近期發佈的精靈。
>>教學精靈：依照分類的功能型精靈，協助使用者透過AI執行任務。
>
>Expected result:
> - 使用者進入首頁，可以看見最愛精靈、最近使用精靈、最新精靈，以及教學精靈的分類
>
>Button feedback: none
>Error cases:
> - 使用者在首頁沒看見最愛精靈的列表 | fix:在首頁點擊精靈進入對話頁面，點擊名稱右側黃色星星即可加入至最愛精靈

#### Q2
>Q：如何與精靈開始一段新的對話？
A： 在首頁選擇一個精靈，點擊進入對話視窗並在輸入框輸入問題。 按 Enter 送出；若需換行，請用 Shift+Enter。
>
>Expected result:
> - 使用者進入首頁，可以看見精靈列表，點擊精靈開啟對話、
>
>Button feedback:
> - 點擊精靈跳轉至該精靈的Agent對話頁面
>
>Error cases: none
#### Q3
>Q：對話模式有哪些？
A：於輸入框下方「選擇對話模式」下拉可見：
單一模式：由單一 LLM 回答。
MAIA–同步模式：同題同時詢問兩個 LLM，分別呈現答案，利於比較。
MAIA–整合模式：彙整多個 LLM 的要點，輸出一個綜合解。
MAIA–評論模式：多個 LLM 先討論再給結論（適合需要多觀點辯證時）。
>
>Expected result:
> - 使用者可在首頁對話框中調整MAIA模式
>
>Button feedback:
> - 游標移動到「選擇對話模式」將展開模型選擇清單，包含單一模式、同步模式、整合模式，以及評論模式。
>
>Error cases:
> - MAIA無法選擇其他對話模式 | fix: 暫不開放
#### Q4
>Q：什麼時候使用不同的對話模式？
>A：速度與穩定 → 單一模式。
比較多家模型風格或正確性 → MAIA–同步模式。
模型對話彙整後的結論 → MAIA–整合模式。
模型對話觀點碰撞／辯證 → MAIA–評論模式。
>
>Expected result: none
>
>Button feedback: none
>
>Error cases: none
>
#### Q5
>Q：如何將精靈加入「最愛」？
A：點擊精靈至精靈對話頁面，右側「加入最愛」（以★呈現）；成功後會出現在「最愛代理」區塊。

>Expected result:
> - 使用者可在加入最愛，後續使用擊可在最愛精靈中找到已被加入的精靈
>
>Button feedback:
> - 點擊精靈將跳轉到精靈對話頁面
> - 點擊「最愛」後，空心☆將變換成實心★
>
>Error cases:
> - 加入最愛的精靈並沒有在首頁看見 | fix: 建議用戶重新整理網頁，或是等待一段時間。
>
#### Q6
>Q：如何將精靈移除「最愛」？
A：於同一位置取消標記，或在「最愛代理」清單中對該代理執行「移除最愛」。
>
>Expected result:
> - 使用者可在加入最愛，後續使用擊可在最愛精靈中找到已被加入的精靈
>
>Button feedback:
> - 點擊精靈將跳轉到精靈對話頁面
> - 點擊「最愛」後，實心★將變換成空心☆
>
>Error cases:
> - 移除最愛的精靈仍在首頁看見 | fix: 建議用戶重新整理網頁，或是等待一段時間。
#### Q7
>Q：如何切換淺色／系統/ 深色模式？
A：點選首頁左側工作列底部，外觀切換可選擇淺色／系統/深色模式。
點選後即時套用。若未生效，可重整頁面。
>
>Expected result:
> - 點擊切換按鈕可以更換介面外觀
>
>Button feedback:
> - 點擊工作列底部的圖示切換，即可改變介面外觀。
>
>Error cases:
> - 點選後未即時套用 | fix: 重新整理網頁。
#### Q8
>Q：如何登出帳號？
A：點選首頁左側個人圖示，顯示使用者資料，底部即可點選【登出】。
>
>Expected result:
> - 點擊個人圖示，顯示個人資料後即可找到登出按鈕
>
>Button feedback:
> - 點擊個人圖示，將顯示使用者資料視窗(方案、角色、權限...)即可找到登出按鈕
>
>Error cases: none

#### Q9
>Q：什麼是「提示嚮導」以及如何使用？
A：提示嚮導依照使用者需求，生成提示句引導對話。
在對話輸入框中「提示嚮導」圖示，點擊即可建立提示嚮導。
>Expected result:
> - 點擊【提示嚮導】，輸入嚮導建立元素 : 角色、目標、期望輸出、限制。輸入完成
>
>Button feedback:
> - 點擊【提示嚮導】，顯示建立提示嚮導視窗。視窗包含：角色、目標、期望輸出、限制。
> - 點擊提示嚮導視窗按鈕【生成提示】即可建立嚮導，即可在提示嚮導視窗中產生提示。若未完成提示嚮導輸入，則無法點擊此按鈕。
> - 提示嚮導視窗中，點擊生成提示按鈕中按鈕【重新生成】即可重新生成新的提示。
> - 提示嚮導視窗中，點擊生成提示按鈕中按鈕【套用】完成提示嚮導。回到模型對話輸入框中，即可看見生成提示。
> - 提示嚮導視窗中，點擊生成提示按鈕中按鈕【返回】回到建立嚮導視窗。.
> - 提示嚮導視窗中，生成的提示可滾輪滑動查看。
>
>Error cases:
> - 無法在提示嚮導視窗按鈕【生成提示】建立嚮導。 | fix: 檢查是否完成色、目標、期望輸出、限制。

#### Q10
>Q：如何切換介面語言？
A：點擊工作列底部語言(地球圖示)。從清單選擇語言（繁體中文、English、注音文）介面即時切換。
註：介面語言與模型回答語言不同；若要讓模型回中文，請在問題中指明語言或選擇擅長中文
的模型。
>Expected result:
> - 點擊【語言(地球圖示)】展開選單:繁體中文、英文、注音文。
> - 切換語言即可改變使用者介面語言
>
>Button feedback:
> - 按鈕【語言(地球圖示)】可以展開語言選擇清單
>
>Error cases:
> - 切換語言但是界面語言尚未切換 | fix: 重新整理頁面。

#### Q11
>Q：如何在對話輸入框輸入多段落訊息？
A：鍵盤按住Shift+Enter進行換行。完成後按 Enter 送出。
>Expected result:
> 按住Shift+Enter在對話輸入框輸入多段落訊息。
>
>Button feedback: none
>
>Error cases: none

#### Q12
>Q：如何使模型回覆更精確？
A：在對話輸入框中清楚描述
> - 任務目標
> - 輸出格式
> - 語言與限制條件。
>
>Expected result:　none
>
>Button feedback: none
>
>Error cases: none

### 技術支援和故障排除

#### Q1
>Q：CSV 模板需要哪些欄位？常見填寫錯誤是什麼？
A：必填欄位：用戶名、電子郵件。
常見錯誤：
Email 格式不正確 → 被系統拒收。
多餘空白或全形標點 → 解析失敗。
超過 49 筆 → 僅前 49 筆會被匯入。
>
>Expected result:　none
>
>Button feedback: none
>
>Error cases: none

#### Q2
>Q：CSV 匯入失敗怎麼辦？
A：
檢查超過 49 筆資料上限。以及欄位是否齊全、Email 格式正確、無多餘空白或特殊字元。逐步縮小範圍：先只留 2–3 筆測試，成功後再分批增加。
>
>Expected result:　none
>
>Button feedback: none
>
>Error cases: none

### 建立精靈與精靈控制器

#### Q1
> Q : 老師如何建立一個新的精靈?
> A : 左側工作列表中，點選「精靈工作室」→「建立精靈」。
> 進入「建立精靈」，填寫 :
>>1.精靈名稱
2.上傳自定義頭像，或使用系統預設
3.輸入精靈的簡短描述，說明精靈的功能
4.於〈基礎模型〉選擇要使用的模型（例如：GPT‑4o、Claude 3.5 Sonnet、Gemini 2.5 Pro）
5.於〈指令〉放入系統規則／角色／語氣／禁忌（例如：回答前先確認需求、不得捏造資料）
6.調整〈創造力〉滑桿
7.於〈對話引導〉寫第一句開場或步驟提示。
8.在〈知識〉點【上傳檔案】，加入 FAQ 或文件（支援 pdf、txt、csv、docx、xlsx、html；每檔
≤10MB；最多 20 檔）。
9.設定〈存取等級〉為「教學精靈／教師團隊精靈／教師個人精靈」以控制哪些用戶能看見與使用
10.於〈您的預設〉存成可重複套用的預設
11.按【儲存並發布】使設定生效
>
> Expected result:
> - 工作列表中，「精靈工作室」下拉清單可見到「建立精靈」
> - 進入「建立精靈」頁面
> - 精靈名稱輸入欄、頭貼設置、描述輸入欄...可進行操作
> - 填寫完所有精靈內容後，發佈按鈕將顯示為可點擊
>
>Button feedback:
> - 進入建立精靈頁面
> - 建置精靈頁面中，精靈名稱能夠輸入
> - 建置精靈頁面中，點擊【上傳自定義頭貼】將出現上傳圖示，點擊圖示後可開啟檔按選擇器
> - 建置精靈頁面中，描述欄位能夠輸入
> - 建置精靈頁面中，基礎模型下拉選單可選擇可用語言模型
> - 建置精靈頁面中，創造力滑桿可左右操作
> - 建置精靈頁面中，為對話引導區塊可輸入
> - 建置精靈頁面中，點擊【上傳檔案】可開啟檔按選擇器
> - 建置精靈頁面中，並且可選擇檔案為 :　顯示/不顯示/下載。
> - 建置精靈頁面中，存取等擊區塊可以點選：教學精靈/教師團隊精靈/教師個人精靈
> - 建置精靈頁面中，輸入完必填項目後即可點擊【儲存預設】，並顯示預設名稱視窗，點擊【儲存為新預設】
> - 點擊發佈按鈕即可在頁面中看見已建立的精靈
>
>Error cases:
> - 建置精靈已達最大數量 | fix: 請洽系統管理者
> - 無法建置精靈，錯誤顯示「精靈名稱不得超過 50字」|fix: 名稱小於50字
> - 無法建置精靈，錯誤顯示「描述為必填」| fix: 為精靈增添描述
> - 點擊【上傳自定義頭貼】出現錯誤訊息 : 「檔案大小超過限制」|fix: 更換檔案大小的圖像(PNG/JPG)

#### Q2
>Q：「指令」欄位該如何填寫？
>A：指令是系統層規則，決定代理的角色、語氣與限制，優先度高於使用者輸入。建議結構：
>- 角色與任務
>- 回答原則：簡潔、友善、分段或條列；必要時提供逐步操作；不確定時明確說明。
>- 禁忌：不得捏造功能；超出平台畫面範圍的內容需標註「以實際頁面為準」。
>- 格式：
「先給摘要→再給步驟→最後給注意事項」，或「先判斷身分→再提供對應流程」。
>
> Expected result:
> - 建置精靈頁面可見「指令」欄位
> - 填寫「指令」後發佈可變更精靈的屬性
>
>Button feedback: none
>
>Error cases:
> - 無法發佈精靈 | fix:指令為建置精靈必填項目

#### Q3
>Q：〈創造力〉滑桿的效果以及要怎麼調？
>A：選擇適合的語言模型後，移動滑桿向「保守」：語氣更精確、較少發散，適合 FAQ 與政策回覆。
移動滑桿向「創新」：更敢發想與延伸，適合研究或行銷語句。
建議：客服知識型代理預設偏「保守」，需要柔性話術時再提高。
>
>Expected result:
>- 建置精靈頁面可以看到創造力滑桿
>- 滑桿可以進行左右調整
>
>Button feedback:
>- 按住滑桿往左可將精靈回應趨向保守；按住滑桿往右可將精靈回應趨向創造力
>
>Error cases:
>- 滑桿操作失敗，無法正常運作 | fix:聯絡管理員
#### Q4
>Q：如何上傳知識檔案？
A：在首頁左側工作欄中，「精靈工作室」下拉選單中的「建置精靈」頁面中，「知識」選項中點擊【上傳檔案】即可進行檔案上傳。
規格：支援 pdf、txt、csv、docx、xlsx、html；每檔 ≤10MB；最多 20 檔。
> Expected result:
> - 在建置精靈頁面中能看到「知識」區塊
> - 檔案上傳按鈕顯示
>
> Button feedback:
> - 點擊【上傳檔案】按鈕即可開啟檔案選擇器
>
> Error cases:
> - 檔案無法上傳 | fix: 不支援該檔案、檔案容量超過10MB、檔案超過20筆
#### Q5
>Q：精靈知識支援哪些檔案，以及限制？
A：精靈知識支援：pdf、txt、csv、docx、xlsx、html；每個檔案大小 ≤10MB；每個代理最多上傳 20 個檔案。
> Expected result:
> - 在建置精靈頁面中能看到「知識」區塊
> - 檔案上傳按鈕顯示
>
> Button feedback:
> - 點擊【上傳檔案】按鈕即可開啟檔案選擇器
>
> Error cases:
> - 檔案無法上傳 | fix: 不支援該檔案、檔案容量超過10MB、檔案超過20筆
#### Q6
Q：精靈知識可以上傳圖片作為知識嗎？
A： 畫面支援清單未包含圖片類型。建議將圖片轉成PDF後上傳。

> Expected result: none
> Button feedback: none
> Error cases:
> - 檔案無法上傳，不支援該檔案。| fix: 將圖片轉成PDF後上傳。
#### Q7
>Q：如何使用〈您的預設〉？
A：可將目前的模型、指令、創造力等設定存成預設，以便快速建立其他代理。
新增：點擊【儲存預設】→【儲存為新預設】命名後儲存。
套用：建立新代理時從下拉選單選取既有預設。
刪除：點擊選預設旁的垃圾桶圖示。
> Expected result:
> - 儲存預設後，可在精靈控制器中查看，並且能夠新增/套用/刪除。
>
>Button feedback:
> - 點擊【儲存預設】顯示視窗【儲存為新預設】輸入名稱
>
> Error cases:
> - 無法點擊【儲存預設】| fix: 確認建置精靈必填項目是否已完成。
> - 無法【儲存為預設】，錯誤訊息:「預設名稱已存在」| fix: 更換不同預設名稱
#### Q8
>Q：如何發布或取消發佈精靈？
A：
>發佈精靈 : 在首頁左側工作列表中「精靈工作室」選單中點選「建立精靈」，進入建置精靈頁面。
取消發佈精靈：在首頁工作列表中「精靈工作室」點選「精靈控制器」，即可在搜尋引擎中搜尋已建置的精靈。即可在精靈「啟用狀態開關」中切換。
> Expected result:
> - 精靈啟用狀態可控制精靈的可見性
>
>Button feedback:
> - 點擊「啟用狀態開關」，點擊關閉將無法在首頁(或是存取等級)中使用精靈
>
> Error cases:
> - 精靈無法在「啟用狀態開關」中切換 | fix: 此用者非管理者，無法控制精靈啟用狀態

#### Q9
>Q：如何使用「精靈控制器」？
A：首頁左側「精靈工作室」選單中點選「精靈控制器」。
進入「精靈控制器」以搜尋與篩選快速查找精靈（依類別、類型、建立者、啟用狀態）。
檢視清單欄位可見：精靈名稱、創建時間、描述、類型、創建者、啟用狀態。點擊【編輯】按鈕可進入該精靈的編輯頁面。
> Expected result:
> - 精靈啟用狀態可控制精靈的可見性
>
>Button feedback:
> - 點擊「精靈工作室」可在下拉選單中找到「精靈控制器」
> - 點擊「精靈控制器」可進入操作精靈列表
> - 在「精靈控制器」中，點擊【編輯】跳轉至該精靈編輯頁面
>
> Error cases:
> - 精靈無法在「啟用狀態開關」中切換 | fix: 此用者非管理者，無法控制精靈啟用狀態

#### Q10
>Q：如何使用〈互動區〉測試精靈？
>A：在精靈編輯頁面，完成精靈設定後，右側即時互動區即可直接對話。並能夠預先測試精靈是否符合預期功能。
> Expected result:
> - 完成精靈設定後，能夠在互動區開始與精靈對話，以及上傳檔案
>
>Button feedback:
> - 點擊「互動區」的對話框，即可開始對話
> - 點擊「互動區」的「檔案上傳」即可開啟檔案選擇器，上傳檔案至互動區
>
> Error cases:
> - 互動區沒有反應，無法點擊 | fix: 檢查是否完成建置精靈必填項目

#### Q11
>Q：如何切換介面語言？
>A：首頁左下角工作列底下，點擊地球圖示，即可從清單選擇語言（繁體中文、English、Français、Español…）。
若在與精靈對話中，即時切換介面語言，將導致模型回答語言不同；若要讓模型回繁體中文，請在問題中加入「以繁體中文回答」的指令。

### 平台管理員
#### Q1
>Q:如何建立用戶群組?
>A:進入首頁在左側工作表中的點選「平台管理員」>「成員管理」>「成員管理」 >「建立用戶群組」即可建立。
#### Q2
>Q:如何邀請老師加入管理員?
#### Q3
>Q:如何編輯用戶資料?
>A:進入首頁在左側工作表中的點選「平台管理員」>「成員管理」>「用戶」即可建立查找用戶，右側點擊【編輯】即可編輯用戶資料。
#### Q4
>Q:如何新增學生進入教室?
>A:進入首頁在左側工作表中的點選「平台管理員」>「教室管理」>「學生名冊」>「新增學生」即可新增學生名稱和座號，或使用CSV檔案匯入。
#### Q5
>Q:老師如何建立課堂?
>A:進入首頁在左側工作表中的點選「平台管理員」>「課堂管理」>「練建立課堂」即可輸入課堂名稱以及課程時間，產生學生登入QRcode。
#### Q6
>Q:如何查看對話紀錄?
#### Q7
>Q:如何下載對話紀錄?
#### Q8
>Q:如何批量刪除學生
#### Q9
>Q:如何停用用戶帳號
#### Q10
>Q:如何重設使用者密碼?

### 學生上課
>Q