> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/release-note/archives/04.md).
# 2026 年 4 月
MaiAgent 平台 2026 年 4 月更新說明
## v2026.04.29
***
本次更新新增知識庫爬蟲頁面匯入的重複網址處理策略，讓使用者可靈活選擇略過、覆蓋或允許重複。同時修正多項影響 AI 助理穩定性的問題，包括瀏覽器工具操作失敗和特定第三方連接器導致對話中斷的情況。
### ✨ 新功能發布
* **知識庫爬蟲頁面匯入衝突策略**：將爬取的網頁批次匯入知識庫時，現在可選擇重複網址的處理方式——略過已存在的、覆蓋舊內容、或允許重複保留。匯入前也可預先檢查網址是否已爬取過，避免不必要的重複作業。適合需要定期更新網頁內容至知識庫的團隊。
### 🛠️ 錯誤修復
* **已修復特定第三方連接器導致 AI 助理對話完全失敗**：使用 Composio 連接器（如 Google Sheets）搭配 AWS Bedrock 模型時，因連接器工具名稱超出平台限制，會導致該 AI 助理的所有對話 100% 失敗。修復後系統會自動處理工具名稱長度，連接器功能恢復正常。
* **已修復 AI 助理瀏覽器工具偶發操作失敗**：AI 助理在使用瀏覽器工具執行點擊或捲動操作時，偶爾會因參數格式問題導致操作失敗並中斷任務。修復後瀏覽器工具的操作穩定性已恢復正常。
* **已修復知識庫文件預覽「查看原文」按鈕被遮擋**：在知識庫文件的文字節點預覽彈窗中，「查看原文」按鈕與右上角的全螢幕和關閉按鈕位置重疊，導致無法正確點擊。修復後各按鈕已正確排列，不再互相遮擋。
## v2026.04.28
***
### ✨ 新功能發布
* **Gemini 3.1 Flash 圖片生成工具**：MaiGPT 的 AI 助理新增快速圖片生成選項。相較於原有的 Gemini 3 Pro Image 工具，Flash 版本生成速度更快，適合需要即時產圖的對話場景。支援低、標準、高三種品質等級供 AI 自動選擇。
### 😊 用戶體驗與介面優化
* **AI 助理監控指標簡化**：監控表格中原本散布超過 20 個的品質評分與處理時間欄位，現在整合為「品質評分」和「處理時間」兩個主要欄位。點擊即可展開檢視完整子指標與中文說明，大幅降低閱讀門檻。不常使用的進階欄位改為預設隱藏，使用者仍可從表格設定中開啟。
* **AI 助理知識庫運用改善**：已連結知識庫的 AI 助理現在更能主動利用知識庫內容來回答問題，減少使用者需要明確要求「查詢知識庫」才能獲得相關答案的情況。
### 🛠️ 錯誤修復
* **已修復 Canvas 生成中無法查看原始碼的問題**：Canvas 在生成內容的過程中，點擊「查看原始碼」按鈕後現在可以即時看到串流中的原始程式碼。此前切換到原始碼模式時，仍會被「編譯中」的載入動畫遮擋。
* **已修復聯絡人詳情面板的排版問題**：對話平台中聯絡人「詳情」面板的多處視覺瑕疵已修正，包括按鈕區域出現灰色方塊、元件間距不一致、文字對比度不足等問題。
* **已修復 iPhone Safari 底部輸入列被遮擋的問題**：使用 iPhone Safari 瀏覽 AI 助理市集（MaiGPT）時，底部的訊息輸入區域不再被瀏覽器工具列遮擋，可正常輸入和送出訊息。
* **已修復嵌入式聊天視窗按鈕被遮擋的問題**：在網站嵌入的 MaiAgent 聊天視窗，縮小瀏覽器視窗後重新開啟時，對話框不再蓋住右下角的啟動按鈕。對話框會自動調整大小以避開按鈕，放大視窗後恢復原始大小。
* **已修復管理後台多項穩定性問題**：修復管理後台多個頁面的間歇性錯誤：成員邀請列表載入時表格尚未就緒的錯誤、知識庫檔案上傳後離開頁面觸發的異常、以及用量統計清除日期範圍時的閃退問題。
* **已修復品質評分「忠實性」翻譯錯誤**：AI 助理監控中的 Faithfulness 評分標籤，繁體中文與簡體中文已從誤譯的「誠實性評分」修正為業界標準用語「忠實性評分」，與 RAGAS 官方中文文件一致。
## v2026.04.27
***
### ✨ 新功能發布
* **AI Copilot 客服建議系統**：客服人員在對話過程中可即時獲得 AI 產生的回覆建議，直接採用或作為參考來撰寫回覆。支援在各對話平台（Web Chat、LINE、Messenger、WhatsApp、Slack、Telegram 等）的設定頁中開啟或關閉 Copilot 功能。
* **對話 Credit 消耗摘要側邊欄**：在對話詳情側邊欄直接查看該對話的 Credit 消耗總計、分類明細（向量化、LLM 輸入/輸出、工具等）、統計數據（輪數、平均值、中位數），並可匯出 CSV 報表。
* **GPT Image 2 圖片生成支援**：圖片生成工具新增 OpenAI GPT Image 2 模型，支援最高 4K（3840×2160）解析度、透明背景和多輪參考圖片。MaiGPT 內部助理自動搭載此工具。
* **MaiGPT 內部助理支援時間問答**：MaiGPT 內部助理現在可回答「今天幾號」「現在幾點」等時間相關問題。新建的 MaiGPT 對話平台預設啟用，既有的也會自動更新啟用。
* **對話嵌入頁面登入狀態自動延續**：嵌入式對話頁面新增 Token 自動重新整理機制，長時間使用時不會因登入過期而中斷對話，使用者無需重新登入。
### 😊 用戶體驗與介面優化
* **AI 助理排程設定介面改善**：AI 助理排程表單新增視覺化的排程時間建構器，可直接選擇執行頻率和時間，取代手動輸入格式的方式。
* **對話平台列表篩選標籤樣式優化**：對話列表的「我的 / 未指派 / 全部」篩選標籤從底線樣式改為膠囊分段控制元件，標籤寬度依內容自適應，不再出現文字被截斷的情況。
* **問卷多題切換答案保留**：填寫多題問卷時，切回上一題後之前填寫的自訂輸入值不再遺失。同時統一選項的選取與聚焦視覺樣式，更容易區分當前聚焦和已選取的狀態。
* **對話平台側邊欄搜尋列對齊與捲軸優化**：統一對話平台和對話列表的搜尋列間距對齊，並將捲軸改為僅在滑鼠移入時顯示的輕量樣式，不再佔據固定空間。
* **Credit 管理後台防誤操作保護**：Credit 交易記錄和充值記錄改為唯讀，防止業務人員誤修改或刪除導致帳務不一致。計費參數的快速編輯功能已移除，需進入詳細頁面編輯以避免誤觸。
### 🛠️ 錯誤修復
* **已修復 Canvas 生成中無法查看原始碼**：Canvas 在串流生成過程中，點擊「查看原始碼」按鈕現在可正常顯示即時串流的原始程式碼，不再被「編譯中」載入遮罩覆蓋。
* **已修復行動裝置輸入區被瀏覽器工具列遮擋**：在 iOS Safari 等行動裝置瀏覽器上，底部輸入列不再被瀏覽器動態工具列遮擋，使用者可正常輸入和傳送訊息。
* **已修復聯絡人標籤編輯未同步至所有對話**：在對話詳情面板編輯聯絡人標籤後，同一聯絡人的所有對話列表項目現在會同步更新標籤，不再只更新當前對話。
* **已修復角色權限管理頁面排序跳動**：在角色權限管理頁面中，修改個別權限後重新載入列表，項目不再跳到不同分頁。所有權限關聯資源統一以建立時間倒序排列。
* **已修復對話平台設定頁面無法開啟**：LINE、Telegram、TeamBot（Azure Bot）、Slack 四個對話平台的設定頁面恢復正常，不再出現開啟時畫面空白的問題。
* **已修復 Agent 市集使用者對話頁面權限錯誤**：Agent 市集和 MaiGPT 使用者進入對話頁面時，不再因權限不足而靜默出錯。系統會自動使用正確的權限範圍發送請求。
* **已修復 OCR 文件辨識模型損壞的處理**：OCR 文字辨識模型檔案損壞時不再導致功能完全無法使用，系統會提供清楚的錯誤提示。模型檔案改為預先下載，避免執行時從外部下載失敗。
## v2026.04.23
***
### ✨ 新功能發布
* **對話詳情面板直接編輯聯絡人標籤**：客服人員可直接在右側對話詳情面板新增或移除聯絡人標籤，無需再開啟「轉接/指派」彈窗。標籤選擇器支援搜尋功能，空狀態時提供「管理標籤」快捷導航。
* **AI 助理對話內訊息搜尋**：AI 助理新增對話訊息搜尋能力，可在對話中搜尋歷史訊息並取得前後文。適合需要 AI 助理參考過往對話內容來回答問題的場景。
* **瀏覽器工具**：AI 助理新增網頁瀏覽能力，可直接存取網頁內容取得即時資訊。使用者可在工具設定中為 AI 助理啟用此功能。
### 😊 用戶體驗與介面優化
* **對話列表篩選分頁視覺改善**：對話平台「所有對話」列表的「我的/未指派/全部」篩選分頁從底線樣式改為膠囊式分段控制，消除與頁面色調的衝突。分頁寬度依內容自適應，「未指派」等較長文字不再被截斷，未讀數量標記也整合進分頁按鈕內。
### 🛠️ 錯誤修復
* **已修復對話平台設定無效角色時的系統錯誤**：管理者在對話平台設定中指定不存在或非本組織的角色時，系統不再回傳無法理解的錯誤訊息，改為明確提示哪些角色無效。
* **已修復知識庫文件解析失敗時無提示的問題**：上傳文件至知識庫時，若解析過程發生錯誤（如 API 金鑰失效、不支援的檔案格式），系統不再靜默顯示成功卻未建立任何索引，改為明確顯示失敗原因。
* **已修復 Bedrock 模型結構化輸出失敗**：使用 AWS Bedrock 模型的 AI 助理在啟用結構化輸出時不再出現「最後一則訊息必須為使用者訊息」的錯誤。修復後 Bedrock、OpenAI、Azure 等所有模型供應商均可正常使用結構化輸出。
* **已改善知識庫嵌入服務的穩定性**：知識庫向量嵌入服務在遇到暫時性網路錯誤（如 502、503、504 等）時會自動重試，減少因短暫網路波動導致的知識庫索引失敗。
## v2026.04.22
***
### ✨ 新功能發布
* **問答互動鍵盤導航與排序題型**：Web Chat 問答互動區新增完整鍵盤操作支援，包含方向鍵切換選項、Enter 選取送出、Space 多選切換、Esc 略過等快捷鍵。新增排序題型，支援滑鼠拖曳與 Shift+方向鍵鍵盤排序。單選題改為 Enter 直接選取，不再需要額外點擊送出按鈕。
* **WhatsApp Token 失效自動通知**：系統會自動偵測 WhatsApp 連線 Token 是否失效，並在 Token 失效時建立組織公告通知管理者及時處理，避免因 Token 過期導致 WhatsApp 頻道無法正常收發訊息。
### 😊 用戶體驗與介面優化
* **AgentOps 評估記錄處理時序分析**：AgentOps 評估記錄新增「前置處理時間」指標，可查看系統初始化、請求驗證與 Agent 工作流程準備所花費的時間，讓管理者能更精確地分析回應延遲來源。
### 🛠️ 錯誤修復
* **已修復自建 AI 模型的文件 OCR 解析失敗**：使用 vLLM 或 ollama 等自建 AI 模型進行文件 OCR 解析時，API 網址會被錯誤組裝為重複路徑，導致 404 錯誤而解析失敗。修復後所有 AI 模型供應商的網址組裝均正確。
* **已修復知識庫標籤更新時的逾時錯誤**：知識庫更新標籤時，在特定情境下會出現逾時處理錯誤。修復後同時新增同步更新方法，提升標籤更新的穩定性。
* **已修復長對話分析任務因逾時而失敗**：增加對話分析任務的執行逾時時間上限，修復了較長或較複雜的對話在分析過程中因逾時而失敗的問題。
* **已修復 PDF 翻譯在特定環境下無法執行**：修復 PDF 翻譯功能的內部處理元件與背景任務框架的相容性問題，確保 PDF 翻譯在所有部署環境中都能正常運作。
* **已修復 IQ Service 搜尋結果顯示不正確**：修正 IQ Service 整合搜尋結果的知識標題（改為擷取文件實際標題）、目錄名稱（改為知識庫名稱）和編號欄位，確保搜尋結果能正確呈現。
* **已修復 Line 頻道在異常請求下的伺服器錯誤**：Line Webhook 在收到缺少簽章標頭的異常請求時，原本會回傳 500 伺服器錯誤並觸發監控警報。修復後改為回傳正確的 400 錯誤碼。
## v2026.04.20
***
### ✨ 新功能發布
* **AI 助理瀏覽器工具**：AI 助理新增網頁瀏覽能力，可即時查詢網頁內容來輔助回答問題。適合需要讓 AI 助理取得最新網路資訊的使用場景。
* **Web Chat 對話事件橫幅**：Web Chat 聊天介面新增對話事件即時通知，使用者可在聊天時間軸中看到轉接、排隊、指派等對話狀態變化，不再需要猜測對話目前處於什麼階段。
* **Web Chat 語音通話體驗改善**：語音通話新增撥號音效回饋與後台快速入口。撥號連線時會播放標準撥號聲，讓使用者明確感知正在撥號中。後台的 Web Chat 公開網址設定區新增「語音模式」按鈕，啟用語音助理後可一鍵開啟語音對話頁面。
### 🚀 核心效能優化
* **知識庫圖片處理加速**：上傳含有大尺寸圖片的文件至知識庫時，系統會自動調整圖片大小再進行索引建立，降低處理時間並減少資源消耗。
### 😊 用戶體驗與介面優化
* **Web Chat 輸出檔案面板改為側邊分頁**：AI 助理透過程式碼解譯器產生檔案時，輸出面板會自動在側邊開啟。檔案數量會即時更新在分頁標籤上，可在畫布與輸出分頁間自由切換，統一管理所有輸出檔案。
* **知識庫「AI 搜尋」體驗全面優化**：知識庫搜尋頁面更名為「AI 搜尋」，搜尋結果改為可摺疊列表，摺疊時顯示前 80 字預覽，方便快速瀏覽多筆結果。每筆結果新增「預覽」按鈕，可直接開啟原始文件預覽。所有引用來源區域統一新增「查看原文」入口，一鍵開啟文件預覽視窗。
* **互動式問答鍵盤操作支援**：互動式問答面板新增完整鍵盤操作：方向鍵切換選項、Enter 確認選擇、Space 在多選題切換勾選、Esc 關閉面板。選項聚焦時會自動捲動到可見範圍，滑鼠和鍵盤操作可混合使用。
### 🛠️ 錯誤修復
* **已修復列表分頁設定不保留的問題**：在 MaiAgent 角色、技能、聯絡人等列表頁選擇每頁顯示筆數後，跳轉至詳情頁再返回時不再重置為預設值。爬蟲結果匯入彈窗也新增支援自訂每頁筆數。
* **已修復 MaiGPT 聊天中程式碼區塊顯示異常**：聊天訊息中，程式碼區塊和行內程式碼內的陣列索引（如 `arr[0]`）會被誤判為引用連結，造成程式碼顯示異常。修復後轉換引用前會先保護程式碼區段，並檢查引用來源是否存在，確保程式碼正常顯示。 \[0]\`）不再被誤轉為引用超連結。同時修正無引用來源時也會觸發轉換的問題。
* **已修復 Admin 介面按鈕圓角不一致**：後台管理介面的按鈕群組恢復正確的圓角顯示，AI 助理設定頁的快速插入提示詞區域也修正了溢出和字體大小問題。
* **已修復 MaiGPT 標題過長時按鈕被推出畫面**：MaiGPT 頁面的對話標題過長時自動截斷，游標停留可查看完整標題。右側的知識庫選擇、分享、收合等按鈕不再被推出畫面，始終可見可點擊。
* **已修復深度研究功能工具呼叫異常**：使用深度研究功能時，工具呼叫的請求處理恢復正常運作。
* **已修復 Gemini 模型配合 JSON 格式輸出的相容性問題**：使用 Gemini 模型的 AI 助理，在設定 JSON 格式輸出後，傳送僅含圖片（無文字）的訊息不再觸發錯誤。其他模型（Claude、OpenAI）行為不受影響。
## v2026.04.17
***
### ✨ 新功能發布
* **表格分頁自訂每頁筆數**：所有管理後台表格的分頁器現在支援手動輸入每頁顯示筆數（上限 500），不再只能從固定選項（10/50/80/100）中選擇。自訂的數值會自動儲存，下次使用時直接套用，也可隨時從下拉選單中刪除已儲存的自訂選項。
### 🔐 安全與治理增強
* **登出時自動撤銷認證權杖**：登出時系統會自動將認證權杖送回後端進行撤銷，確保登出後權杖立即失效。防止已登出的認證資訊被重複使用，提升帳號安全性。
### 🛠️ 錯誤修復
* **已修復 MCP 連接器設定表單被瀏覽器自動填入的問題**：新增私有 MCP 伺服器時，「伺服器 URL」欄位會被瀏覽器誤判為登入表單並自動填入已儲存的電子郵件，導致 URL 格式驗證失敗。修正後所有表單欄位不再觸發瀏覽器自動填入。
* **已修復 AI 助理工具搜尋載入失敗的問題**：AI 助理在搜尋和載入外部工具時，部分情況下會出現載入失敗。修正後工具搜尋和載入功能恢復正常運作。
## v2026.04.16
***
### ✨ 新功能發布
* **知識庫搜尋 AI 摘要**：知識庫搜尋測試頁面新增 AI 摘要功能。搜尋後自動在結果上方生成一段摘要，類似 Google AI Overview。搜尋結果立即顯示，AI 摘要以串流方式漸進載入，不影響搜尋速度。支援繁中、簡中、英文、日文、韓文等多語系回應。
* **Web Chat FlexMessage 訊息動作支援**：Web Chat 現在支援 FlexMessage 的訊息動作按鈕。在 LINE 中，FlexMessage 按鈕可直接傳送訊息給 AI 助理；但在 Web Chat 中，原本只會跳出瀏覽器提示框。更新後，點擊 FlexMessage 訊息按鈕會直接傳送訊息給 AI 助理並取得回覆，與 LINE 體驗一致。
* **對話平台派工系統**：對話平台新增派工系統，支援 AI 自動將對話分配給適當的團隊成員。當 AI 助理判斷需要人工介入時，可自動將對話轉接給指定的團隊成員，提升客戶服務效率和回應速度。
### 😊 用戶體驗與介面優化
* **公告彈窗視覺重新設計**：重新設計系統公告彈窗的視覺呈現。新版公告依據嚴重程度顯示不同色彩和圖示，標題和日期改為左對齊排版，並修復純文字換行無法正確顯示的問題。
* **Web Chat 對話開場問題顯示數量可自訂**：Web Chat 的對話開場問題範例原本固定顯示隨機 2 個，現在管理員可自訂顯示數量，範圍從 1 到 10 個。預設值維持 2 個，與現有行為相容。
### 🛠️ 錯誤修復
* **已修復知識庫文件含特殊字元導致處理失敗**：部分 PDF 和 Word 文件解析後含有特殊控制字元，導致上傳至知識庫時處理失敗。修復後系統會自動清理文件中的無效控制字元，確保各類文件均可正常處理。
* **已修復 Web Chat 附件傳送缺少檔名導致失敗**：透過 Web Chat 傳送附件訊息時，若附件資料缺少檔名欄位會導致傳送失敗。修復後系統會自動從檔案路徑提取檔名，確保附件訊息正常傳送。
* **已修復 Telegram 訊息傳送遇到暫時性錯誤時失敗**：Telegram 頻道傳送訊息遇到暫時性網路錯誤時，訊息會直接傳送失敗。新增自動重試機制，遇到暫時性錯誤時會以遞增間隔自動重試，提升訊息送達率。
* **已修復 LINE 回覆過期導致訊息無法送達**：LINE 頻道的回覆 token 過期時，訊息無法送達使用者。修復後系統會自動偵測回覆 token 過期狀態，改用主動推送方式傳送訊息，確保訊息送達。
## v2026.04.15
***
### ✨ 新功能發布
* **全螢幕語音通話頁面**：原有的語音通話僅以底部彈窗呈現，互動體驗受限。新增獨立全螢幕通話頁面，包含沉浸式背景、大頭像顯示、語言切換和通話控制按鈕，提供更直覺的語音互動體驗。適合需要長時間語音對話的使用場景。
* **對話事件時間軸與標籤系統**：對話詳情頁新增完整的事件時間軸，可視化呈現轉接、分配、狀態變更等事件歷程。同時以自訂標籤系統取代原有的優先級機制，各對話平台可獨立設定專屬標籤，滿足多樣化的分類需求。
* **知識庫常見問答批次匯入匯出**：管理大量常見問答時，逐筆新增效率低下。新增批次上傳和匯出功能，可透過檔案一次處理多筆常見問答資料，適合需要大規模管理問答內容的團隊。
* **對話 Canvas 地圖顯示**：AI 助理對話中新增 Google Maps 地圖類型的 Canvas，可渲染互動式地圖標記、路線和資訊彈窗。適合旅遊規劃、物流追蹤、店舖導航等需要地理資訊呈現的場景。
* **對話分析功能**：對話平台新增對話分析能力，可自動分析對話內容並產生洞察報告，幫助管理者掌握對話品質和服務趨勢。
### 🚀 核心效能優化
* **Web Chat 頁面重建加速**：當 Web Chat 數量超過數萬筆時，原有的頁面重建任務會因逐一處理而逾時中斷。改為分批並行處理（每批 100 筆），確保大量 Web Chat 的頁面更新能順利完成，不再因逾時而失敗。
### 😊 用戶體驗與介面優化
* **知識庫文件編輯後自動同步原始檔案**：編輯純文字檔案（txt、md、csv 等）的知識庫內容後，系統自動將修改後的內容合併並同步回原始檔案。非純文字檔案（PDF、DOCX 等）不受影響。若同步失敗僅顯示提醒，不影響知識庫內容的儲存。
* **AI 助理角色指令 Token 估算顯示**：在 AI 助理設定頁面的「角色指令」輸入區域下方，即時顯示估算的 Token 數量（格式為「約 XX tokens」），幫助使用者了解指令的 Token 消耗。
* **Web Chat 開場白與對話開始問題的隨機顯示提示**：在 Web Chat 設定頁面的「開場白」和「對話開始問題」標題旁新增提示說明，清楚告知隨機顯示規則：開場白每次隨機顯示 1 則，對話開始問題每次隨機顯示 2 則。
* **重置對話按鈕位置調整**：「重置所有對話」按鈕從對話平台列表頁的操作圖示旁，移至各對話平台編輯頁的「啟用重置命令」區塊內。此為低頻且不可逆操作，增加一層操作摩擦可降低誤觸風險。
### 🛠️ 錯誤修復
* **已修復 AI 助理引用編號與來源不對應的問題**：修復 AI 助理回覆中引用編號（如：\[1]、\[2]）點開後顯示錯誤文件的問題。現在引用編號會正確對應到 AI 實際參考的知識庫文件，並避免同一份文件重複出現在引用列表中。 \[1]、\[2]）可能指向錯誤的引用來源文件。修正後引用編號與引用來源正確對應，且同一引用來源不再重複出現。
* **已修復知識庫文件檢視器提示橫幅被捲動隱藏的問題**：在知識庫文件檢視器中，提示橫幅原本會隨頁面一起捲動而消失。修正後橫幅固定在檢視器頂部，不受頁面捲動和縮放影響，始終保持可見。
* **已修復 SQL 知識庫資料表建立時任務重試失敗的問題**：上傳 SQL 檔案建立資料表時，若任務需要重試（如任務重新派送），可能因找不到佔位記錄而報錯。修正後當資料表已成功建立時直接回傳結果，處理狀態不一致的情況也會給出明確的錯誤訊息。
* **已修復 AI 評估指標因解析異常導致整個評估失敗的問題**：執行 AI 評估時，若某一項評估指標的語言模型回傳了非預期格式，會導致整個評估任務中斷。修正後單一指標的解析失敗不會影響其他指標的評估，評估結果更加完整可靠。
## v2026.04.13
***
### ✨ 新功能發布
* **聯絡人標籤管理**：過去無法對聯絡人進行分類，大量客戶時難以快速篩選特定群組。新增完整的標籤管理功能，支援建立自訂標籤、在聯絡人列表中批次新增或移除標籤、透過標籤篩選聯絡人，以及在對話頁客戶資訊面板中直接查看標籤。
* **語音助理中斷控制設定**：使用語音助理時，過去無法配置是否允許使用者打斷 AI 的語音回應。新增中斷控制設定，可開啟或關閉「允許打斷」功能，並可設定觸發打斷所需的最短語音持續時間和最少字數門檻，適合需要精細調整語音互動體驗的團隊。
* **Code Interpreter 輸出檔案面板與環境升級**：使用 Code Interpreter 功能時，AI 產生的檔案過去無法在前端查看或下載。現在管理後台和 Web Chat 都新增了輸出檔案面板，可直接瀏覽和下載 AI 產生的檔案。同時執行環境預裝常用資料分析、文件處理套件及中文字型，並支援讀取對話中上傳的附件。
* **用量統計 Credits 指標與計費類別**：使用 Credit 計費方案的組織過去無法在用量統計中查看點數消耗的細項分佈。新增 Credits 指標選項，提供 7 個標準圖表、計費類別三層鑽取（分類圓餅圖 → 項目排名柱狀圖 → 成員細項展開），方便掌握點數消耗結構。
* **AI 助理主動提問功能**：AI 助理過去只能被動回答問題，無法在不確定使用者意圖時主動詢問。新增主動提問功能，AI 助理可在對話中自動產生帶有選項的結構化問題，協助引導使用者釐清需求，提升對話精準度。
* **日文與韓文語系支援**：平台過去僅支援繁體中文、簡體中文和英文。新增完整的日文（日本語）和韓文（한국어）語系支援，涵蓋所有 5,000 餘個翻譯項目，並支援瀏覽器語言自動偵測切換，日韓使用者可直接使用母語操作管理後台。
### 😊 用戶體驗與介面優化
* **Canvas 編譯狀態提示統一**：Canvas 功能在串流生成期間，非 React 類型（Mermaid、Markdown、HTML）過去直接顯示原始碼，缺少一致的載入提示。現在所有 Canvas 類型在編譯期間統一顯示旋轉圖示和「編譯中」文字，完成後自動切換為渲染結果。
* **API 金鑰管理介面改善**：API 金鑰列表頁面移除多餘的表格格線使版面更清爽、撤銷操作改用更直覺的刪除圖示、已撤銷或過期的金鑰現在顯示停用狀態按鈕而非直接隱藏，方便辨識金鑰狀態。
### 🔐 安全與治理增強
* **系統日誌敏感資訊保護**：加強系統日誌記錄的安全性，更新日誌記錄方式以避免敏感憑證資訊被意外記錄，確保使用者的認證資料在系統日誌中得到適當保護。
### 🛠️ 錯誤修復
* **已修復 Web Chat 首次發送訊息時的畫面閃動**：使用者在 Web Chat 發送第一條訊息時，歡迎訊息動畫與快速提問消失動畫重疊，造成畫面明顯閃動跳動。修正後對話開始時畫面過渡平滑，不再出現視覺干擾。
* **已修復會議記錄頁面在小螢幕裝置上無法捲動**：使用 MacBook Air 等小螢幕裝置查看會議記錄詳細頁面時，頁面內容被裁切無法向下捲動。修正後頁面可正常捲動，確保所有裝置都能完整閱讀會議記錄。
* **已修復 SQL 資料庫連線測試的錯誤提示**：在 SQL 資料庫連線設定中輸入格式錯誤的連線網址（如含有佔位文字）時，系統回傳不明確的伺服器錯誤。修正後會顯示清楚的驗證錯誤訊息，方便使用者修正連線設定。
* **已修復 AI 助理排程任務偶發執行失敗**：使用 AI 助理排程功能時，任務偶爾因資料庫連線過期而執行失敗。修正後系統會在每次排程執行前確保使用有效的資料庫連線，排程任務運行更加穩定。
## v2026.04.10
***
### ✨ 新功能發布
* **對話平台標籤分類與事件追蹤系統**：原本對話平台僅提供四級數字優先順序（0-3），無法靈活分類。現在每個對話平台可自訂專屬標籤，自由標記和篩選對話。同時新增完整的對話事件追蹤，記錄每次指派、轉接、排隊、人員接手等操作歷程，並透過即時通訊推播事件通知。AI 助理轉接時也會自動依據可用標籤分類對話。
* **MCP 連接器內部網路存取設定**：使用地端部署（On-Premise）MCP 服務的企業用戶，可透過設定允許的內部網路範圍（CIDR），讓 MCP 連接器安全地存取內部服務，同時維持對外部網路的安全防護。
### 🚀 核心效能優化
* **知識庫搜尋連線穩定性提升**：改善搜尋服務的連線管理機制，能自動偵測因執行緒切換而失效的過期連線，並即時重新建立。在高負載環境下，知識庫搜尋服務的穩定性顯著提升。
### 😊 用戶體驗與介面優化
* **排程執行紀錄保存改善**：排程執行的審計記錄現在會直接保存每次 AI 助理的回覆內容。即使對話訊息被後續流程處理，仍可從排程執行紀錄中完整查閱歷史回覆，方便追溯排程任務的執行結果。
### 🛠️ 錯誤修復
* **已修復 AI 助理因工具名稱衝突導致對話失敗**：同時啟用程式碼解釋器和自訂工具（或 MCP 工具）時，若工具名稱重複（如同名的命令列工具），AI 模型會回傳錯誤導致對話無法進行。修復後系統自動處理工具名稱衝突，確保對話正常運作。
* **已修復知識庫檔案上傳時安全驗證失敗**：上傳檔案至知識庫時，部分呼叫方式傳送特殊格式的檔案資料，導致安全驗證服務無法正確處理而回傳伺服器錯誤。修復後安全驗證能正確識別並處理這類檔案。
* **已修復排程專屬對話被誤刪**：系統自動清理空對話時，未檢查排程功能的專屬對話關聯，可能導致排程仍在使用的對話被錯誤刪除。修復後排程專屬對話不再受清理流程影響。
* **已修復 AI 思考模式設定異常**：AI 助理的思考模式設定在特定情況下可能因格式不正確而導致服務異常。修復後在多個服務層級新增格式驗證，確保思考模式穩定運作。
## v2026.04.09
***
### ✨ 新功能發布
* **組織 API 金鑰管理**：組織管理員現在可以在設定頁面中集中管理 API 金鑰，包括建立新金鑰（可指定成員和到期日）、查看所有金鑰狀態，以及撤銷不再需要的金鑰。建立時會顯示完整金鑰值供複製，之後僅顯示前綴以確保安全。
* **Credit 用量統計分析**：新增完整的 Credit 用量統計儀表板，組織管理員可以查看 Credit 花費的時間趨勢，並依 AI 助理、成員、MaiAgent 角色、對話平台、聯絡人、語音助理等多個維度分析用量。計費類別支援三層鑽取，從總覽到明細一目了然。
* **聯絡人標籤篩選對話**：對話列表新增依聯絡人標籤篩選功能，支援同時選擇多個標籤進行篩選。客服人員可以快速找到特定分類（如 VIP、特定產品線）的對話，提升對話分流和處理效率。
### 😊 用戶體驗與介面優化
* **邀請管理頁面分頁優化**：個人資料頁的邀請管理從單一長表格拆分為「邀請碼」、「邀請連結」和「邀請信」三個獨立頁籤。每個頁籤都有專屬的搜尋欄位和篩選條件，邀請連結支援一鍵複製，邀請信支援狀態篩選和重新發送。
* **知識庫批次匯入數量上限提升**：網頁爬取結果的批次匯入上限從每次 50 筆提升至 200 筆。需要大量匯入網頁資料到知識庫的使用者，操作次數可減少約 75%。
### 🛠️ 錯誤修復
* **已修復部分語言模型無法回應的問題**：部分不支援串流回應的語言模型（如透過 AWS Bedrock 提供的 DeepSeek R1）在對話時會出現無回應或錯誤。現在系統會自動偵測模型的串流支援能力，對不支援的模型改用完整回應模式，確保對話正常進行。
* **已修復 AI 對話串流中斷時無限等待的問題**：使用 AWS Bedrock 模型進行對話時，若串流回應中途中斷，系統會無限期等待下一個回應片段。修復後新增 90 秒逾時機制，串流中斷時會在合理時間內回報錯誤，避免使用者長時間等待無回應。同時修正了串流中途發生錯誤時未正確捕捉的問題，確保錯誤能被正確記錄和分類。
## v2026.04.08
***
### ✨ 新功能發布
* **AI 助理語音對話中斷控制**：使用語音助理時，現在可以設定是否允許使用者在 AI 回覆中途進行打斷，並可調整中斷觸發的最短持續時間與最少字數門檻，讓語音對話互動更自然流暢。
* **第三方對話平台重置所有對話**：管理第三方平台（LINE、Messenger、Instagram、Telegram、Teams、WhatsApp、Email、Slack）對話頻道的管理員，現在可一鍵重置頻道內所有歷史對話，操作前需二次確認，執行後顯示已重置的對話筆數。
* **MaiGPT 語言模型選擇記憶功能**：過去在 MaiGPT 切換語言模型後，建立新對話時總是回到預設模型。現在系統會自動記住使用者偏好的語言模型，新建對話時自動套用上次選擇，不需每次手動切換。
* **組織啟用記錄與事件匯出功能**：管理後台新增組織啟用記錄頁面，管理員可查看組織啟用歷程並匯出操作事件紀錄，方便追蹤成員活動和進行稽核，支援繁體中文、簡體中文和英文介面。
* **網頁嵌入版程式碼執行面板支援**：使用網頁嵌入版（Web Chat）的使用者，現在可以正確看到程式碼執行結果的輸出面板。此前因 API 未提供相關設定資訊，前端無法正確判斷是否顯示此面板。
### 😊 用戶體驗與介面優化
* **停止生成按鈕視覺優化**：對話過程中的停止生成按鈕從黑底白方塊改為白底深灰框設計，視覺更輕盈柔和。同時在深色模式下也有對應的配色調整，整體風格更加一致。
* **排程任務對話平台選擇與間隔設定優化**：排程任務設定中的「收件匣」更名為「對話平台」，並以圖示標籤顯示各平台類型（如 LINE、Web、Admin）。排程間隔設定從單一秒數輸入，改為天、時、分、秒四格同時輸入，操作更直觀方便。
* **外部資料庫表格描述分頁顯示**：外部資料庫設定頁面的表格描述列表新增分頁功能。此前超過 20 個表格時，列表無法顯示完整資料，現在可透過分頁瀏覽所有表格描述。
* **組織概覽權限名稱翻譯補齊**：組織概覽頁面中，部分權限名稱（會議記錄權限、會議列表權限、即時轉錄權限、AI 助理市集權限）原本顯示為英文鍵值，現已補齊繁體中文、簡體中文和英文翻譯。
* **附件上傳期間禁止傳送訊息**：在對話中上傳附件時，若附件尚未完成上傳，傳送按鈕會自動停用，避免使用者在附件未就緒時發送不完整的訊息。
### 🔐 安全與治理增強
* **第三方套件遠端程式碼執行漏洞修補**：修補 jsonpickle 套件的遠端程式碼執行（RCE）安全漏洞，已升級至修復版本，確保平台資料處理的安全性。
* **安全掃描流程與範圍優化**：精簡安全掃描的檢測範圍，確保只掃描生產環境實際部署的程式碼。移除不再使用的容器設定檔案（消除 3 項高風險掃描紅字），修正靜態分析工具的誤報標記，提升安全掃描結果的準確性和可信度。
### 🛠️ 錯誤修復
* **已修復排程任務編輯表單的兩個問題**：切換排程類型（如從間隔改為一次性）時，已設定的傳遞選項不再被清空；一次性排程的執行時間格式已修正為後端正確接受的格式。
* **已修復自動重試失敗後的錯誤訊息不正確**：AI 助理在自動重試機制耗盡所有嘗試後，回傳的錯誤訊息不正確。修復後會正確顯示原始錯誤原因，方便使用者了解問題所在。
* **已修復瀏覽歷史訊息時的分頁錯誤**：瀏覽歷史訊息時，若分頁游標損壞或包含無效的時間格式，系統不再產生 500 內部錯誤，改為正常引導使用者重新載入對話。
* **已修復聯絡人自訂屬性的布林值格式問題**：聯絡人自訂屬性中使用布林值（如「是/否」標記）時，因大小寫格式不一致導致資料更新時發生錯誤。系統現在會自動正規化布林值格式，確保資料儲存和搜尋時格式一致。
* **已修復附件檔案讀取方式**：AI 助理處理使用者上傳的附件時，檔案讀取邏輯修正為正確的方式，確保附件內容能被完整讀取和處理。
* **已修復訊息中特殊字元的處理異常**：對話訊息中包含特殊字元時，可能導致訊息處理失敗。修復後系統會統一清理特殊字元，確保訊息正常傳送和顯示。
* **已修復已停用 AI 模型仍出現在選單中**：已被 Google 停用的 Flash 圖像模型已從可選清單中移除，避免使用者選擇後無法正常使用。
## v2026.04.07
***
### ✨ 新功能發布
* **Agent 排程功能**：過去需要手動觸發 AI 助理執行任務，現在可設定排程讓 AI 助理自動執行。支援三種排程模式：定時執行（Cron）、間隔執行和單次排程，可選擇對話內或獨立執行方式，並指定收件匣和訊息推送管道（對話或 Webhook）。
* **新增 GPT-5.4 mini 和 GPT-5.4 nano 模型支援**：平台新增 GPT-5.4 mini 和 GPT-5.4 nano 兩款模型，使用者可直接選用這兩款新模型。
### 🚀 核心效能優化
* **AI 模型相容性升級**：升級 AI 框架套件以支援最新的 Bedrock 模型，確保平台能使用最新的 AI 模型能力。
* **AI 模型效能監控工具**：新增 AI 模型效能指標分析工具，支援首字回應時間和每秒處理量的 P95/P99 百分位數統計，方便監控模型回應品質。
### 😊 用戶體驗與介面優化
* **工具與技能選擇器全面改版**：重新設計 AI 助理的工具和技能選擇介面。改為搜尋優先的雙欄網格佈局，新增已選項目標籤可快速總覽和移除、分組摺疊顯示含已選計數、完整描述 Popover 預覽。技能選擇器新增搜尋功能（原本沒有搜尋），大幅提升多項目選擇的效率。
* **知識庫檔案已停用解析器名稱顯示**：當知識庫檔案使用的解析器已被停用時，檔案列表的下拉選單現在會顯示解析器名稱並標示為已停用，取代先前難以辨識的 UUID 代碼，方便使用者了解檔案的解析狀態。
### 🔐 安全與治理增強
* **平台安全性套件更新**：升級多個 Python 和系統套件以修補已知安全漏洞，包括路徑遍歷、緩衝區溢位、阻斷服務等高風險問題，強化平台整體安全防護。
### 🛠️ 錯誤修復
* **已修復逐字稿語者標籤儲存錯誤**：在逐字稿檢視器中修改多個語者標籤後儲存，偶爾會出現儲存失敗的錯誤。改為一次批次送出所有標籤變更，消除大量併發請求造成的問題，儲存功能恢復穩定。
* **已修復程式碼解讀器輸出面板未顯示問題**：使用程式碼解讀器時，若未設定知識庫，輸出面板不會顯示。修復後無論是否設定知識庫，程式碼解讀器的輸出面板都能正常顯示。
## v2026.04.02
***
### ✨ 新功能發布
* **AI 對話串流回覆中斷**：使用 AI 助理對話時，可隨時點擊停止按鈕中斷正在生成的回覆。若在思考階段中斷，訊息氣泡會自動移除；若在回覆階段中斷，已生成的部分內容會保留並標示「回覆已中斷」，方便重新提問。
### 🚀 核心效能優化
* **背景任務可靠性與連線穩定度提升**：改善背景任務處理機制，啟用延遲確認功能，確保任務完成後才標記為已處理，工作節點異常中斷時任務可自動重新派發而非遺失。同時在訊息處理前主動清理過期的資料庫連線，避免因連線失效導致的處理失敗。
### 😊 用戶體驗與介面優化
* **AI 助理工具名稱重複提示改善**：設定 AI 助理時，若不小心加入了名稱相同的工具，錯誤訊息會明確列出重複的工具名稱，方便快速找到並修正問題，不再需要逐一檢查。
### 🛠️ 錯誤修復
* **已修復嵌入式 Web Chat 對話按鈕的顯示問題**：在網站嵌入 Web Chat 時，對話按鈕在載入過程中不再閃爍預設圖示。如果設定了自訂按鈕圖示，該圖示能正確從 API 載入並顯示。修復前按鈕會短暫顯示預設外觀後才切換為自訂樣式。
* **已修復知識庫文件語者標記無法編輯的問題**：透過知識庫上傳的語音轉文字文件，編輯語者標記時不再出現權限錯誤。修復前，只有直接掛在 AI 助理下的文件語者標記可編輯，知識庫路徑下的文件會返回 403 錯誤。
* **已修復對話中圖片和貼圖附件無法刪除的問題**：在對話平台中刪除圖片或貼圖附件時，不再出現「找不到資源」的錯誤。修復前，因附件與對話的關聯方式不正確，刪除操作會返回 404 錯誤。
* **已修復批次匯入成員未自動建立 API 金鑰的問題**：透過批次匯入新增的成員現在會自動建立 API 金鑰。修復前，批次匯入的成員缺少 API 金鑰，導致無法使用需要金鑰驗證的功能。
* **已修復同時上傳多個知識庫檔案時標籤建立失敗的問題**：同時上傳多個知識庫檔案時，標籤建立不再因並行處理的鍵值衝突而失敗。修復前，多個檔案同時處理可能導致標籤建立報錯。
## v2026.04.01
***
### ✨ 新功能發布
* **組織 API 金鑰管理**：組織管理員現在可以在設定頁面中集中管理 API 金鑰，包括建立新金鑰（可指定成員和到期日）、查看所有金鑰狀態，以及撤銷不再需要的金鑰。建立時會顯示完整金鑰值供複製，之後僅顯示前綴以確保安全。
* **批次語音轉文字處理**：上傳長時間音訊檔案至知識庫時，系統現在支援批次語音轉文字處理，突破原有 60 秒的單次處理限制。適合需要解析會議錄音、客服通話等長時間音訊的團隊。
* **系統郵件寄件帳號自訂**：管理員可在後台設定自訂的 SMTP 郵件帳號（支援密碼加密），讓系統通知信件從企業自有信箱發送，取代預設的公用帳號。
* **登入記錄追蹤與活動日誌匯出**：系統新增成員登入記錄追蹤，管理員可在活動日誌中查看成員登入歷程，並支援以非同步方式匯出稽核紀錄，適合需要安全合規追蹤的企業。
### 🚀 核心效能優化
* **PDF 翻譯速度提升 10 倍**：PDF 翻譯服務的每秒處理量從 1 提升至 10，翻譯大型文件時等待時間大幅縮短。
### 😊 用戶體驗與介面優化
* **即時中斷 AI 回應**：對話過程中，用戶現在可以隨時停止 AI 正在進行的推理和回應生成，不需等待完整回覆結束，提升對話互動的即時控制體驗。
* **工具 Header 支援情境變數**：設定 API 工具的 Header 時，現在可以直接插入對話情境變數（如使用者 ID、會話 ID 等），讓工具整合更靈活。
* **嵌入式聊天按鈕支援自訂圖示**：網站嵌入的聊天按鈕現在會優先使用後台設定的自訂圖示，讓嵌入式聊天窗口的外觀與品牌形象保持一致。
### 🛠️ 錯誤修復
* **已修復 Flex Message 卡片重複顯示問題**：使用 Flex Message 卡片回覆時，串流過程中偶爾會出現同一張卡片重複渲染。修復後卡片正確去重，並移至訊息氣泡外部獨立顯示，排版更清晰。
* **已修復對話標題在側邊欄換行的排版問題**：對話清單側邊欄中，較長的對話標題無法正確截斷而出現換行，導致版面跑版。修復後標題以單行顯示並在過長時自動以省略號截斷。
* **已修復 Web Chat 設定頁面即時預覽失效的問題**：Web Chat 設定頁面的即時預覽區域無法正常顯示，同時對話平台設定頁的操作欄位未正確固定在右側。修復後預覽功能恢復正常，操作列固定在正確位置。
* **已修復知識庫搜尋測試的關鍵字高亮顯示異常**：知識庫搜尋測試頁面在切換「原始文字/高亮文字」時，Markdown 渲染與關鍵字高亮產生衝突，導致格式異常。修復後關鍵字高亮在各模式下均能正確顯示。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.maiagent.ai/release-note/archives/04.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.