> 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/05.md).
# 2026 年 5 月
MaiAgent 平台 2026 年 5 月更新說明
## v2026.05.29
***
### 🔐 安全與治理增強
* **MaiAgent 角色工具與技能權限強化**：強化角色的工具與技能權限控管機制，確保成員在對話中僅能使用已授權給其角色的工具和技能。組織管理員可更放心地透過角色設定管理成員的存取權限。
### 🛠️ 錯誤修復
* **已修復 WhatsApp 電話號碼註冊流程異常**：透過 WhatsApp 渠道註冊電話號碼時出現異常，導致無法正常完成註冊。修復後 WhatsApp 電話號碼註冊流程恢復正常。
* **已修復畫布流程轉接節點資料傳遞問題**：使用畫布流程設計中的轉接功能時，轉接節點未正確傳遞資料，導致流程無法正常執行。修復後轉接節點可正確傳遞所有必要資料，流程轉接功能恢復正常。
## v2026.05.28
***
### ✨ 新功能發布
* **Credits 概覽頁面新增餘額提醒與發放資訊**：Credits 概覽頁面整合全新資訊卡片，一次顯示帳戶餘額、餘額提醒設定狀態、上次與下次 Credits 發放的時間與金額。無需進入其他頁面即可掌握 Credits 完整動態，低餘額時亦有色彩警示。
* **AI 助理串流中斷自動重試**：新增 AI 助理層級的串流中斷自動重試設定。當 AI 回應在串流過程中發生中斷時，系統自動重新取得回應，使用者端可見已產出的工具呼叫結果保留、文字部分自動替換為重試結果，無需手動重發訊息。可在 AI 助理基本設定中開啟或關閉。
### 🚀 核心效能優化
* **測試資料集評估中斷自動復原**：系統更新部署時，進行中的測試資料集評估不再永久卡在「執行中」狀態。系統自動將已完成的測試案例結果收尾並標示為「部分完成」，使用者可查看已完成的結果。另新增每小時自動清理機制，防止任何殘留的卡死評估。
### 😊 用戶體驗與介面優化
* **AI 助理自訂回應長度上限自動適配**：設定 AI 助理的自訂回應長度上限時，切換到自訂模式會自動以所選模型的最大值初始化，不再顯示空白。切換模型時，數值自動調整至新模型的有效範圍，避免設定超出模型限制而導致錯誤。
### 🛠️ 錯誤修復
* **已修復 Web Chat 對話中 Flex 訊息卡片無法顯示的問題**：使用 Web Chat 時，AI 助理回覆的 Flex 訊息卡片（如按鈕選單、圖文組合）在串流過程中被丟棄，導致訊息泡泡無法呈現 Flex 內容。修復後 Flex 訊息在串流中正確保留並完整顯示。
* **已修復 Web Chat 深色模式下對話區域出現異常紋路的問題**：Web Chat 開啟深色模式時，對話區域背景出現整片重複的向下箭頭紋路。修復後深色模式下對話區域恢復正常顯示。
* **已修復對話頁面輸入框背景消失的問題**：對話頁面的訊息輸入框因樣式設定問題而失去背景色和邊框，變成透明狀態。修復後輸入框恢復正常的白色背景和灰色邊框。
* **已修復 Agent UI Flex 訊息預覽中按鈕間距異常的問題**：Agent UI 的 Flex 訊息預覽中，按鈕區域的第一個按鈕直接貼在上方圖片或文字底部，缺少間距。修復後按鈕與上方內容保持 12px 的標準間距。
* **已修復 MCP 工具輸入不支援的連線方式時產生系統錯誤的問題**：新增 MCP 工具時，若輸入不支援的連線方式（如本機命令），過去會產生系統內部錯誤。修復後在儲存時即顯示明確的錯誤提示，說明僅支援 HTTP/HTTPS 連線方式。
* **已修復 AI 助理使用 Anthropic 模型時工具呼叫紀錄偵測失敗的問題**：AI 助理使用 Anthropic 模型進行工具呼叫時，部分工具呼叫紀錄無法被正確偵測，可能導致對話歷史中工具呼叫結果遺失。升級 SDK 並修正偵測邏輯後，工具呼叫紀錄完整保留。
* **已修復結構化輸出中包含可為空物件欄位時的請求錯誤**：AI 助理使用結構化輸出功能時，若自訂的 JSON Schema 包含可為空的物件欄位，產生的格式不相容會導致 OpenAI API 拒絕請求（400 錯誤）。修復後自動修正格式，確保所有欄位定義符合 API 要求。
## v2026.05.27
***
### ✨ 新功能發布
* **Agent UI 功能正式開放**：Agent UI 已從測試階段轉為正式功能，所有具備存取權限的使用者皆可直接使用 Agent UI 選單、FlexMessage 編輯器及 AI 助理設定中的 Agent UI 分頁，無需額外啟用。
* **Bedrock 串流自動重試設定**：使用 AWS Bedrock 模型時，若串流傳輸過程中發生中斷，系統可自動重試以確保回應完整性。管理員可在各對話平台設定中開啟此功能，聊天介面會標示重試訊息，點數明細也會標記因重試產生的額外費用。
* **公告系統新增多語系連結欄位**：系統公告現已支援多語系連結欄位，可為不同語言版本的公告分別設定對應的連結。
### 🚀 核心效能優化
* **知識庫網頁爬蟲升級至新版引擎**：知識庫的網頁爬蟲底層升級，提升網頁內容擷取的準確度與完整性。
### 😊 用戶體驗與介面優化
* **對話權限不足時顯示明確提示**：當使用者缺少對話權限（例如 Agent 市集未開通）嘗試使用 Web Chat 時，系統不再顯示通用的「建立對話失敗」訊息，改為明確提示「沒有對話權限，請聯絡管理員開啟」，幫助使用者了解問題並尋求協助。
* **點數不足時 AI 工具操作提示改善**：統一所有 AI 工具（包含 SQL 查詢、程式碼執行、MCP 連接器、API 工具、圖片生成、影片生成、網頁搜尋）在點數不足時的回應方式。改善前，部分工具會直接中斷 AI 助理的回應流程；改善後，AI 助理會主動告知使用者點數不足並建議加值，對話不會無故中斷。
* **影片生成狀態追蹤改善**：影片生成功能新增結構化狀態追蹤，使用者可更清楚了解影片生成的處理進度。
### 🛠️ 錯誤修復
* **已修復公告管理批次核准操作失敗的問題**：管理後台中批次核准自動翻譯公告時，操作不再因資料庫查詢衝突而失敗。此問題導致管理員每次嘗試批次核准都會出錯。
* **已修復 Web Chat 位置感知回應功能未正確運作的問題**：Web Chat 的位置感知回應功能因設定讀取路徑錯誤，導致即使已在對話平台設定中啟用，功能仍無法正常運作。修復後位置感知回應可正確依據使用者位置提供在地化回應。
## v2026.05.26
***
### ✨ 新功能發布
* **WhatsApp Business 共存模式**：WhatsApp Business Account (WABA) 設定新增共存模式支援，可同時連接多個 WABA 帳號，不再需要為不同帳號重複設定。適合透過多個 WhatsApp 號碼服務不同客群的企業。
### 🚀 核心效能優化
* **AI 模型串流回應穩定性提升**：使用 AI 助理時，若模型串流回應在 45 秒內未開始傳送任何內容，系統會自動偵測並重新發送請求，避免使用者長時間等待卻收不到回覆。此功能可由管理員針對個別對話平台逐步啟用。
### 😊 用戶體驗與介面優化
* **信用額度明細新增 Code Interpreter 工具顯示**：信用額度交易記錄和定價頁面中，Code Interpreter 工具現在顯示正確的中文名稱和計費單位，不再顯示系統內部代碼。支援繁體中文、簡體中文、英文、日文和韓文五種語系。
* **角色設定新增 Agent 市集權限說明**：在角色設定頁面中，「Agent 市集」權限下方新增說明文字，清楚說明此權限控制成員是否能在 Agent 市集的 AI 助理中開啟對話，幫助管理員更準確地設定角色權限。
* **Credits 總覽頁面調整**：移除 Credits 總覽餘額卡片上的「加購 Credits」按鈕，避免使用者點擊後導向目前已隱藏的計費頁面。
### 🛠️ 錯誤修復
* **已修復知識庫檔案批次上傳失敗問題**：當知識庫中不同檔案的自訂屬性使用了不同的資料格式（例如同一個欄位先寫入數字、後寫入文字），會導致整批檔案索引失敗。修復後系統會自動將所有自訂屬性統一為文字格式，避免格式衝突造成的上傳失敗。
* **已修復部分 MCP 工具無法使用的問題**：連接部分第三方 MCP 工具時，因工具定義格式不完全符合標準規範，系統無法正確解析參數結構，導致工具無法呼叫。修復後系統能自動處理常見的非標準格式，提升與各種 MCP 工具的相容性。
* **已修復瀏覽器工具的背景清理錯誤**：AI 助理使用瀏覽器工具後，背景清理程序偶爾會出現執行錯誤，可能導致瀏覽器資源未被正確釋放。修復後清理程序穩定運行，瀏覽器資源能正常回收。
## v2026.05.25
***
### ✨ 新功能發布
* **MCP 連接器 OAuth 自動探測**：連接第三方 MCP 服務時，系統會自動探測伺服器的 OAuth 驗證資訊（遵循 RFC 9728 標準）。使用者只需提供 MCP 伺服器 URL，即可自動完成 OAuth 驗證設定，不再需要管理員手動填入技術參數。
* **Copilot 側欄新增標籤管理與 AI 分析功能**：Copilot 嵌入頁面的側欄新增對話標籤、聯絡人標籤管理功能和 AI 分析按鈕。客服人員無需切換到對話平台主頁面，即可直接在 Copilot 中管理標籤並觸發 AI 分析。同時修復了透過連結直接進入時資料無法即時更新的問題。
* **WhatsApp 商業帳號共存設定**：WhatsApp 商業帳號（WABA）設定頁面新增共存功能設定，方便使用者管理多個 WhatsApp 帳號的共存運作。
### 😊 用戶體驗與介面優化
* **列表頁標籤可點擊跳轉**：各列表頁面（AI 助理、知識庫、資料庫、工具、對話平台等）的標籤現在可以直接點擊跳轉到對應的詳細頁面，不再需要手動複製名稱搜尋。超出顯示範圍的標籤以彈出視窗呈現，標題標示為「關聯 AI 助理」方便識別，同樣支援點擊跳轉。同時修復了知識庫、測試資料集、自動化測試頁面搜尋框按清除按鈕後列表不會重新載入的問題。
### 🛠️ 錯誤修復
* **已修復 Web Chat 開場白無法顯示 Markdown 格式的問題**：設定了包含標題、粗體、列表等 Markdown 語法的 Web Chat 開場白，現在可以正確呈現格式化內容，與其他訊息的顯示方式一致。
* **已修復 MCP 工具含非文字參數時無法正確執行的問題**：使用 MCP 工具（例如系統操作小助手）修改包含布林值或數值的設定時，參數不再被錯誤轉換為文字，操作可正常完成。此問題曾導致工具反覆重試直到上限仍然失敗。
* **已修復 AI 助理互動式回覆被誤判為錯誤的問題**：AI 助理透過互動式 UI 元素（如選項按鈕、圖片等）回覆時，不再被系統誤判為回覆失敗。互動式回覆現在可以正確顯示，訊息內容不再被錯誤提示取代。
## v2026.05.22
***
### 🛠️ 錯誤修復
* **已修復 AI 助理在長對話中回應偏離主題的問題**：使用啟用記憶功能的 AI 助理進行長時間對話時，當早期對話紀錄被系統歸檔，AI 助理可能誤判當前使用者輸入，導致回應與使用者的實際問題無關。修正後，AI 助理能正確識別對話歷史結構，準確理解當前使用者輸入並給予相關回應。
* **已修復知識庫附件插入失敗的問題**：透過附件方式將內容新增至知識庫時發生錯誤，無法正常匯入資料。修正後，使用者可正常透過附件將內容匯入知識庫。
## v2026.05.21
***
### 🛠️ 錯誤修復
* **已修復管理後台頁面閒置後即時訊息傳送失敗**：使用管理後台 Web Chat 時，若頁面閒置一段時間後再傳送訊息，會因為即時通訊連線的認證過期而失敗。修正後，重新連線時會自動使用最新的認證資訊，閒置後恢復操作不再中斷。
* **已修復知識庫上傳少量資料 Excel/ODS 檔案被拒絕**：上傳只有 1-2 個儲存格有資料的 Excel、XLS、XLSX 或 ODS 檔案到知識庫時，系統會將唯一資料誤判為欄位標題，導致檔案被當作空檔案拒絕。修正後，系統能正確辨識並處理少量資料的試算表檔案。
* **已修復 iOS 手機上傳圖片後 AI 對話失敗**：透過 iOS Safari 拍照或貼上圖片進行 AI 對話時，瀏覽器回報的圖片格式標籤可能與實際格式不一致（例如 JPEG 圖片被標記為 PNG），導致 AI 模型拒絕處理。修正後，系統直接從圖片檔案內容偵測實際格式，不再依賴瀏覽器提供的格式資訊。
* **已修復 Gemini 模型串流回應偶爾中斷**：使用 Gemini 模型的 AI 助理在串流回應過程中，遇到安全性過濾或長度限制時偶爾會出現錯誤中斷。升級整合元件後，串流處理更加穩健，相關中斷情況已解決。
## v2026.05.20
***
### ✨ 新功能發布
* **管理後台新增對話訊息 API 請求追蹤**：在管理後台的對話記錄中，現在可以直接查看每則訊息觸發的所有下游 API 請求（語言模型呼叫、向量搜尋、重排序等），並以顏色標記區分不同請求類型（語言模型藍色、向量搜尋綠色、重排序橘色），方便管理員快速定位問題。
### 🚀 核心效能優化
* **資料庫查詢功能連接大型外部資料庫時啟動加速**：使用資料庫查詢功能連接含數千張資料表的外部資料庫時，不再需要預先掃描所有資料表結構，啟動時間從隨資料表數量增長（數千張表可能需數十秒）降為即時完成。
### 🛠️ 錯誤修復
* **已修復 AI 助理檔案查詢工具顯示重複結果**：使用 AI 助理的檔案查詢工具搜尋試算表檔案（xlsx、csv 等）時，同一份檔案不再出現多筆重複結果。先前系統會將上傳的試算表自動轉換為內部處理格式，導致搜尋結果中同一份檔案最多出現三筆。修正後只顯示使用者實際上傳的原始檔案。
## v2026.05.19
***
### ✨ 新功能發布
* **使用者選擇的技能與工具強制觸發**：使用者在 Web Chat 對話中選擇的技能或工具，現在會被確實觸發。過去選擇後 AI 可能不使用指定的工具，現在系統會確保 AI 在第一輪回應中優先使用使用者指定的技能或工具。
* **新增即時語音對話模型**：語音助理新增兩款即時語音模型選項：OpenAI gpt-realtime-1.5 和 Google Gemini Live 2.5 Flash 原生音訊。同時修正 OpenAI 語音選項清單，移除不支援的語音並新增 verse 和 cedar 兩種新語音。
### 😊 用戶體驗與介面優化
* **管理後台方案資訊頁籤改善**：組織管理頁面的方案資訊頁籤新增「新增方案」和「新增儲值」快速操作按鈕，營運人員不再需要跨多個頁面操作。方案歷史表格新增計費模式欄位，表格排版更加清晰，並完善五種語系的翻譯支援。
* **MaiAgent 角色資料庫權限設定改善**：角色設定中的資料庫權限選擇器已改善，切換分頁時已選取的項目會正確保留，不再因切換頁面而遺失選取狀態。
### 🛠️ 錯誤修復
* **已修復 Web Chat 長文字訊息溢出版面問題**：在行動裝置上使用 Web Chat 時，傳送超長且無自然斷點的文字（例如不含分隔符號的連續字串），訊息氣泡會超出螢幕寬度。修復後訊息會正確自動換行，不再溢出版面。
* **已修復跨對話上傳相同附件的錯誤**：在不同對話中上傳相同的檔案時，系統會顯示「此檔案已上傳」的錯誤。修復後系統會正確處理跨對話的相同附件，不再報錯。
## v2026.05.18
***
### ✨ 新功能發布
* **語音 AI 助理文字回覆開關**：語音 AI 助理新增「語音回覆」開關。關閉語音合成後，AI 助理的回覆會以文字訊息呈現在對話介面中，適合不需要語音輸出的使用場景。
* **點數消耗紀錄跳轉 AgentOps 詳情**：在組織設定的點數消耗紀錄中，對話類型的消耗紀錄 ID 改為可點擊連結，直接開啟 AgentOps 對話詳情視窗，方便追蹤個別對話的點數使用明細。同時移除容易造成混淆的「說明」欄位。
### 🚀 核心效能優化
* **對話平台分頁計數載入加速**：對話平台的分頁計數（我的 / 未指派 / 全部）載入速度大幅提升。中型組織（約 9,000 筆對話）從 304 毫秒降至 8.7 毫秒（提升 35 倍），大型組織（約 198,000 筆對話）從 600 毫秒以上降至 153 毫秒（提升約 4 倍）。
### 😊 用戶體驗與介面優化
* **問答訊息獨立卡片呈現**：使用者透過表單提交的問答內容，在對話介面中改以獨立卡片樣式呈現。問題以粗體顯示、答案以副標排列，視覺上與一般對話訊息明確區分，方便快速辨識表單回覆內容。
* **Pre-Chat 表單自訂標題與多語系切換**：Web Chat 的 Pre-Chat 表單支援管理員自訂標題和副標題（含多語系），新增語言切換器讓訪客在填寫前切換介面語言。表單卡片視覺樣式也經過簡化，下拉選單在未選擇時改以灰色呈現，避免訪客誤認為已選取。
* **Code Interpreter 輸出面板可靠性提升**：Code Interpreter 的輸出面板改為使用結構化訊號驅動，無論 AI 助理以絕對路徑或相對路徑寫入檔案，輸出面板都能自動偵測並顯示產出的檔案。歷史對話重新載入時也能正確顯示先前產出的檔案。
### 🛠️ 錯誤修復
* **已修復頻道設定頁 Webhook URL 複製按鈕排版問題**：LINE、Telegram、Slack、Teams 四個頻道設定頁面中，webhook URL 的複製按鈕被擠到輸入框下方的排版問題已修復，複製按鈕恢復與輸入框同一行顯示。
* **已修復功能選單 Hover 觸發大量重複請求的問題**：滑鼠快速掃過功能選單時，不再觸發大量重複的 API 請求。加入防抖處理後，操作更加流暢，也減少不必要的伺服器負載。
* **已修復 API 存取型 AI 助理用量統計顯示偏低的問題**：透過 Completions API 存取的 AI 助理，用量統計面板的輸入 token 數據未正確記錄，實際用量約為顯示值的 11 倍。修復後統計數據正確反映實際用量。此問題不影響計費金額，僅影響用量統計面板的顯示。
* **已修復成員點數額度過期名單更新過慢的問題**：成員點數額度過期後，額度分配頁面的「已過期」名單最長需要 1 小時才能更新。修復後更新頻率提高至每分鐘檢查一次，過期成員在 1 分鐘內就會正確轉移到「已過期」名單中。
* **已修復語音通話結束時的系統錯誤**：語音通話結束時，殘餘的音訊資料在連線已關閉後仍嘗試傳送而產生系統錯誤的問題已修復。此修復消除了每週約 50 筆的相關錯誤記錄，提升語音通話的穩定性。
* **已修復會議錄音刪除後的系統錯誤**：使用者在會議錄音完成前刪除錄音記錄時，系統不再因找不到該記錄而產生錯誤。已刪除或不存在的錄音記錄會被正確處理，不影響其他功能運作。
* **已修復組織停用時知識庫資料清理失敗的問題**：停用組織時，知識庫相關的引用來源和標籤等關聯資料因清理順序不正確而導致作業中途失敗的問題已修復。所有關聯資料現在能按正確順序完整清除。
## v2026.05.15
***
### 🚀 核心效能優化
* **服務連線穩定性提升**：修正伺服器與負載平衡器之間的連線逾時設定不一致問題，消除使用者偶爾遭遇的 502 連線錯誤，提升整體服務可用性。
### 😊 用戶體驗與介面優化
* **成員分配介面已選數量顯示修復**：MaiAgent 角色的「分配成員」介面中，左右兩側的「已選 N 項」計數器已恢復正常運作，不再永遠顯示為 0。
*
* **程式碼解譯器輸出面板自動刷新**：AI 助理使用程式碼解譯器產生檔案後，右側輸出面板會自動顯示新產生的檔案，不再需要手動點擊刷新。
### 🛠️ 錯誤修復
* **已修復 AI 助理瀏覽器工具的座標解析錯誤**：AI 助理使用瀏覽器工具點擊頁面元素時，偶爾因座標格式不正確而中斷操作。修復後系統能自動修正格式問題，讓 AI 助理繼續完成操作。
*
* **已修復 AI 助理工具 SSL 連線相容性問題**：針對使用舊版 SSL 憑證（如 TWCA Root 1998）的第三方服務，管理員可在工具設定中啟用相容模式，讓 AI 助理能順利連接這些端點。其他安全檢查（憑證鏈、主機名稱、有效期限）仍保持啟用。
*
* **已修復對話歷程記錄的資料儲存問題**：升級資料庫驅動後，對話歷程記錄的資料被重複編碼，導致資料庫內儲存格式不正確。修復後新的對話記錄將以正確格式儲存，既有受影響的資料也會透過修復程式還原。
## v2026.05.14
***
### ✨ 新功能發布
* **SCIM 身份同步管理介面**：企業管理員現在可以在組織設定中選擇 SCIM 作為身份同步方式（除既有 LDAP 外）。支援 SCIM endpoint 連線設定、Token 管理（含 180 天過期警告與一次性顯示）、群組映射（支援 CSV 匯入匯出與自動建立角色）以及同步紀錄查閱。
* **Web Chat 對話前資料收集表單**：管理員可在 Web Chat 對話平台設定中配置對話前表單，支援文字、電子郵件、電話、下拉選單 4 種欄位類型，最多 10 個欄位。表單支援 13 種語系的多語言標籤與提示文字、拖拉排序調整順序，以及自動將訪客填寫的資料對應到聯絡人欄位。
* **Genesys Cloud Open Messaging 整合**：管理員可在對話平台 Webhook 設定中配置 Genesys Cloud 連線，系統自動管理 OAuth Token 更新。支援「測試連線」驗證憑證、憑證失效時的 Banner 提醒，以及同一對話平台多個 Webhook 共用憑證。
* **Slack 和 Telegram「AI 處理中」提示訊息**：將「AI 處理中」提示訊息功能從 Teams 擴展至 Slack 和 Telegram 平台。管理員可在對話平台設定中啟用此功能、自訂提示文字、設定初始延遲與重複間隔，AI 回覆後佔位訊息自動清除。
* **Agent 附件智慧判讀開關**：管理員可在 Web Chat 對話平台的 AI 感知設定中啟用「Agent 附件智慧判讀」功能。啟用後 AI 助理會根據對話情境自行決定是否讀取附件內容，而非一律進行知識庫處理。預設為關閉，需手動啟用。
* **Copilot AI 建議版本切換**：客服人員重新產生 AI 建議後，可透過左右切換按鈕瀏覽所有歷史版本，選擇最適合的版本送出或編輯。AI 產生新版本期間，切換器自動鎖定至最新版。同時修正重新產生按鈕在特定時機可重複點擊的問題。
### 🚀 核心效能優化
* **知識庫檢索去除重複內容**：優化知識庫多路檢索合併機制，自動去除重複的文件片段，僅保留相關度最高的結果。有效減少 AI 處理的重複內容、降低 Token 消耗並提升回答品質。
### 😊 用戶體驗與介面優化
* **Credit 額度批次分發流程優化**：批次分發 Credit 額度給角色時，新增角色搜尋功能與無限捲動載入，改為單次提交批次分發（而非逐一請求），並即時顯示分發結果統計（成功 / 略過 / 失敗筆數）。
* **API 文件對話平台欄位說明改善**：透過 API 或 MCP 整合時，開發者可在 API 文件中直接看到 Web Chat 開場白、問候語等各頻道設定欄位的完整說明，不再需要查閱原始碼。
### 🛠️ 錯誤修復
* **已修復 MaiGPT 技能選擇在送出訊息後被清空**：使用 MaiGPT 時選擇技能或工具後送出訊息，選擇狀態不再被清除。技能和工具選擇會在同一對話中持續保留，切換到不同對話時才自動清空。
* **已修復外部資料庫列表欄位跑版**：外部資料庫 Tab 列表的名稱欄位現在能正確顯示資料庫名稱與類型標籤，不再出現版面跑位。
* **已修復 Webhook 設定頁面 Web Chat ID 複製按鈕換行**：對話平台 Webhook 設定中，Web Chat ID 的複製按鈕現在與輸入框正確並排顯示，不再換行到下方。
## v2026.05.13
***
### ✨ 新功能發布
* **Web Chat 對話前表單**：啟用後，網站訪客在開始對話前需先填寫管理員設定的欄位（姓名、Email、電話或自訂下拉選單），系統自動建立或比對聯絡人資料，提升訪客管理效率。支援 13 種語系介面，已填寫過的訪客下次造訪時自動跳過表單。
* **MaiGPT 技能選單與快速操作**：MaiGPT 對話頁新增統一「+」選單，整合檔案上傳、技能、工具、連接器和深度研究五項功能。使用者可從選單中選取技能（分為系統內建與組織自訂），選中的技能以藍色標籤顯示於輸入框旁，訊息送出後自動清除（單次生效）。
* **AI 助理語音回覆開關**：管理員可在 AI 助理設定中控制語音助理是否以語音方式回覆。關閉後語音助理仍可接收語音輸入，但改以文字方式回應，適合需要語音輸入但偏好文字回覆的場景。
* **智慧附件處理判斷**：對話平台新增智慧附件處理機制，系統根據附件類型和大小自動判斷是否需要索引至知識庫。圖片、影片、貼圖自動跳過；文字檔案依大小判斷。AI 助理可在對話中主動讀取或索引被跳過的附件。預設啟用，可在對話平台設定中關閉。
### 😊 用戶體驗與介面優化
* **AI 建議一鍵操作**：Copilot 的 AI 建議回覆新增三個快捷操作按鈕：直接送出、編輯後送出、重新產生建議。客服人員不再需要手動複製貼上建議內容，可一鍵採用或編輯後再送出，建議產生失敗時也可一鍵重新產生。
### 🛠️ 錯誤修復
* **已修復群組權限分配的跨頁選取問題**：在指派資料庫、對話平台、知識庫等資源給 MaiAgent 角色時，跨多頁累積選取項目後按搬移按鈕，先前只有當前頁的選取會被保留。修復後所有頁面的選取項目都能正確搬移。
## v2026.05.12
***
### ✨ 新功能發布
* **自訂 Agent 工作流逾時訊息**：使用 Agent 工作流的 AI 助理，當工作流執行超過設定時間時，管理者現在可以自訂顯示給使用者的逾時訊息（最多 500 字），取代原本固定的系統預設文字。同時逾時下限從 60 秒降至 30 秒，適合短流程的 AI 助理更快回應逾時狀態。
* **動態 CORS 白名單管理**：過去每次新增客戶的 Web Chat 嵌入網域需要修改程式碼並部署（耗時 1-2 個工作天）。現在管理員可直接在後台新增和管理允許的來源網域，變更即時生效，支援完整 URL 或正則表達式，大幅縮短客戶 Web Chat 上線時間。
### 🛠️ 錯誤修復
* **已修復知識庫 AI 搜尋摘要未納入 Metadata 的問題**：使用知識庫 AI 搜尋的摘要功能時，即使已將 Metadata 設定為「啟用搜尋」，AI 摘要仍未參考這些標註資料。修復後 AI 摘要會正確讀取所有啟用搜尋的 Metadata，讓搜尋結果更完整精確。
* **已修復對話平台工具「精簡模式」顯示無效的問題**：在對話平台設定中將工具呼叫的顯示模式設為「精簡」時，工具呼叫結果仍以完整面板顯示，與「完整模式」無區別。修復後精簡模式正確以單行格式呈現（工具圖示 + 名稱 + 狀態），與 Web Chat 的行為一致。
* **已修復外部資料庫列表欄位錯位的問題**：外部資料庫列表中「資料庫名稱」欄位渲染失敗，導致該列之後所有欄位（已選擇表格、關聯 AI 助理、建立者等）向左偏移一格。修復後所有欄位正確對齊，資料庫名稱欄位完整顯示圖示、名稱和類型。
* **已修復輸出面板無法重新整理的問題**：輸出面板的重新整理功能無法正常運作，資料不會更新。修復後面板資料可正常刷新。
## v2026.05.11
***
### ✨ 新功能發布
* **工具調用 API 請求詳情查看**：工具調用紀錄的詳細頁面新增「請求資訊」區塊，顯示 AI 助理實際發送的 HTTP 請求 URL、方法、標頭和內容。管理員可直接確認範本變數（如聯絡人 ID）是否被正確替換，不必請後端團隊查閱日誌。敏感標頭值（如 API 金鑰、授權資訊）會自動遮蔽顯示。
* **知識庫搜尋測試結果顯示中繼資料**：知識庫搜尋測試頁面的搜尋結果新增中繼資料標籤顯示。每筆搜尋結果旁會以 key:value 格式呈現該知識片段的自訂中繼資料，超過 6 個標籤時可展開查看完整列表，方便管理員快速辨識搜尋結果的來源與屬性。
* **支援 Mistral 3.5 推理模式**：AI 助理新增 Mistral 3.5 推理（thinking）模式支援。使用者選用 Mistral 3.5 模型時，AI 助理可利用其推理能力逐步思考後再回答，提升複雜問題的回答品質。
### 🛠️ 錯誤修復
* **已修復 Bedrock 模型多輪對話忘記上下文**：使用 AWS Bedrock 模型的 AI 助理在多輪對話中會忘記先前的回覆內容，導致重複回答或無法延續對話。修復後 AI 助理能正確記住完整對話歷史，多輪對話體驗恢復正常。
* **已修復 AWS Bedrock Claude Opus 4.7 推理模式不正確**：使用 AWS Bedrock Claude Opus 4.7 模型時，推理（thinking）功能因 API 格式不相容而無法正常運作。修復後平台能自動偵測模型版本並使用對應的推理 API 格式，確保推理摘要正確產生。
* **已修復刪除當前對話後畫面停滯**：在 Agent 市集和 MaiGPT 中刪除正在進行的對話後，畫面仍顯示已刪除對話的舊訊息，需手動點擊才能建立新對話。修復後刪除當前對話會自動建立並跳轉至新對話。
* **已修復跨頁選取 AI 助理技能後選項消失**：設定 AI 助理技能時，在技能選擇器中跨頁瀏覽或使用搜尋功能後，先前已勾選的技能會被取消。修復後選取的技能在分頁和搜尋操作之間持續保留。
* **已修復知識庫中繼資料鍵值驗證問題**：在知識庫中建立重複名稱的中繼資料鍵值時，系統回傳 500 伺服器錯誤而非明確提示。修復後會顯示清楚的重複名稱錯誤訊息，且系統管理的鍵值受到保護無法被意外修改。
* **已修復串流回覆結束後打字指示器閃爍**：使用 Web Chat 時，AI 助理串流回覆完成後「正在輸入」指示器會額外閃爍一次。修復後串流回覆的打字指示器行為正常，對話體驗更加順暢。
* **已修復 Word 文件上傳至知識庫時解析失敗**：在特定部署環境下上傳 Word 文件（.docx/.doc）至知識庫時，因暫存檔案寫入權限問題導致解析失敗。修復後在各種部署環境下都能正常處理 Word 文件。
* **已修復 Mermaid 圖表匯出 PDF 時未完整渲染**：匯出包含 Mermaid 圖表的畫布為 PDF 時，圖表尚未完成渲染就開始匯出，導致 PDF 中圖表缺失或顯示不完整。修復後匯出會等待所有圖表完成渲染後再進行。
## v2026.05.07
***
### ✨ 新功能發布
* **成員 Credit 額度管理**：管理者現在可以為組織內的個別成員設定 Credit 使用額度。在 Credits 頁面的「額度分配」分頁中，可進行單一成員分發、依角色批次分發、編輯額度與有效期等操作，並透過統計卡片即時掌握分配狀況。成員可在個人 Profile 頁面查看自己的額度使用進度。當 Credit 不足時，系統會區分「個人額度用盡」與「組織餘額不足」顯示不同的提示訊息。
* **對話詳情頁聯絡人與對話標籤分離**：對話詳情面板的標籤系統升級為雙區塊設計——「聯絡人標籤」跟著聯絡人跨對話共用，「對話標籤」可由 AI 自動貼標或人工編輯。新增對話標籤選取器支援搜尋與批次操作，各對話平台設定頁也新增「管理標籤」快捷入口，可一鍵跳轉到對話標籤管理分頁。
### 🚀 核心效能優化
* **PDF 翻譯服務穩定性提升**：PDF 翻譯所需的字型與模型資源現在於系統部署時預先載入，避免因執行環境限制導致翻譯服務無法啟動。修復後 PDF 翻譯功能在所有部署環境下皆可正常運作。
### 😊 用戶體驗與介面優化
* **白牌版本品牌文字自動替換**：白牌版本的管理後台現在會自動將介面中的品牌名稱替換為客戶自訂名稱。替換範圍涵蓋 AI 助理監控、對話列表、資料庫選擇器、角色權限樹、第三方登入等主要介面，確保品牌體驗一致。
* **LINE 對話平台「AI 助理思考中動畫」文案優化**：LINE 對話平台設定中的「啟用載入動畫」選項重新命名為「AI 助理思考中動畫」，更清楚地描述此功能是 AI 處理回覆時的視覺回饋。所有語言版本同步更新。
* **管理後台側邊欄 Logo 置中顯示**：管理後台側邊欄頂部的 Logo 從靠左對齊調整為水平置中，不論側邊欄展開或收合狀態皆保持置中顯示，視覺更加協調。
* **PDF 翻譯排版警告監控優化**：PDF 翻譯過程中的排版警告處理機制優化，多個警告現在會合併為單一通知，大幅減少監控系統噪音。翻譯紀錄新增警告欄位，方便在管理後台查看個別翻譯遇到的排版問題。
### 🛠️ 錯誤修復
* **已修復 AI 助理使用「詢問使用者問題」工具後產生多餘回應的問題**：AI 助理使用互動式問答工具向使用者提問後，會額外產生一則不相關的回應訊息並寫入對話記錄。修復後 AI 助理在提出問題後會正確等待使用者回答，不再自動產生額外回應。
* **已修復 Deep Research 超過步數上限時顯示不明錯誤的問題**：Deep Research 功能在研究步數超過上限時會顯示通用錯誤訊息，使用者無法理解發生什麼事，且研究狀態無法重置。修復後會顯示友善的提示訊息，並自動清除研究狀態讓使用者可重新開始。
* **已修復聯絡人列表操作按鈕誤觸勾選的問題**：在聯絡人列表中點擊編輯或刪除按鈕時，會同時勾選該列的 checkbox 並觸發批次操作列。修復後操作按鈕僅執行對應動作，不影響列選取狀態。
* **已修復 Agent 市集刪除對話後無法新建對話的問題**：在 Agent 市集刪除當前對話後，點擊「新建問答」按鈕沒有反應。修復後刪除對話後可正常建立新對話並切換頁面。
## v2026.05.06
***
本次更新為 Microsoft Teams 對話平台新增等待提示訊息功能，讓使用者在 AI 處理期間獲得即時回饋。同時修正多項影響計費歸屬和系統穩定性的重要問題，並優化工具分類命名以更準確反映組織管理架構。
### ✨ 新功能發布
* **Teams 對話平台等待提示訊息**：使用 Teams 傳訊給 AI 助理時，若 AI 處理時間較長，系統會自動顯示「處理中」提示訊息並定時更新經過時間，AI 回覆後提示自動清除。管理員可在 Teams 對話平台設定頁的「功能設定」分頁中，自訂提示訊息文字、初始延遲時間和更新間隔。
### 😊 用戶體驗與介面優化
* **AI 助理工具分類名稱更新**：AI 助理編輯頁的工具選擇器中，「內建工具」更名為「系統內建工具」，「使用者自訂工具」更名為「組織自訂工具」，更準確反映工具由平台提供或組織管理員建立的實際管理方式。
### 🛠️ 錯誤修復
* **已修復對話平台設定頁的存取錯誤**：使用 LINE、Teams、Messenger 等對話平台時，部分使用者存取對話平台設定頁面會遇到伺服器錯誤，導致頁面無法正常載入。修正後對話平台相關頁面均可正常存取。
* **已修復 AI 助理範本回覆模式的錯誤**：AI 助理設定為範本回覆模式但未附加知識庫時，使用者傳送訊息會導致伺服器錯誤，無法收到回覆。修正後系統會正常處理此情況，不再出現錯誤。
## v2026.05.05
***
### ✨ 新功能發布
* **PDF 翻譯新增緬甸語支援**：知識庫的 PDF 翻譯功能現在支援緬甸語（မြန်မာ），可將緬甸語 PDF 翻譯為其他語言，或將其他語言翻譯為緬甸語。語言選單同步調整排序，亞洲語系優先排列，方便快速選取。
### 🚀 核心效能優化
* **大型資料庫 Text-to-SQL 初始化加速**：連接擁有數千張資料表的大型資料庫進行 Text-to-SQL 查詢時，初始化時間從數分鐘降至即時完成。系統改為按需載入資料表結構，不再於連線時掃描所有資料表，大幅縮短等待時間。
### 🛠️ 錯誤修復
* **已修復會議記錄權限在非中文介面顯示為中文的問題**：使用英文、日文或韓文介面時，會議記錄相關權限的名稱和說明不再顯示為中文。同時修正已啟用會議記錄功能的組織，可在角色設定頁面中正確看到並指派會議記錄權限。
* **已修復排程 AI 助理在長時間運作後偶爾回應失敗的問題**：排程觸發的 AI 助理在累積多輪對話後，不再因對話歷史格式問題導致回應中斷。系統會自動修正對話歷史中的格式異常，確保排程任務持續穩定運作。
* **已修復深度研究網路搜尋在即時對話中偶爾失敗的問題**：在即時對話中使用深度研究功能時，網路搜尋不再出現意外中斷，搜尋結果可正常回傳並整合至研究報告中。
* **已修復語音助理 API 設定格式錯誤時的回應**：透過 API 設定語音助理時，若傳送的設定格式不正確，系統會回傳明確的錯誤訊息，不再出現伺服器錯誤。
## v2026.05.04
***
### ✨ 新功能發布
* **聯絡人 API 憑證管理**：過去 API 工具只能在工具層級設定統一的認證資訊，無法區分不同聯絡人的存取權限。現在可在聯絡人詳情頁的「API 憑證」分頁中，為每位聯絡人獨立設定不同 API 工具的 Headers 認證資訊，適合需要多租戶個別化存取控制的場景。
* **問答卡片視覺呈現**：使用者回答問卷後，Q\&A 內容過去以純文字顯示在聊天氣泡中，與一般對話沒有區分。現在問答結果自動以獨立卡片樣式呈現（白底、藍色邊框），每組問答清晰分隔，讓回答紀錄一目瞭然。
* **多品牌白標部署支援**：支援透過環境變數配置品牌名稱、客服信箱和 Ask AI 的 AI 助理，所有介面文字自動套用品牌設定。白標部署客戶無需修改原始碼即可顯示正確的品牌資訊。
### 🚀 核心效能優化
* **LDAP 同步效能優化**：使用 LDAP 身份同步的企業客戶，在大型組織同步時的資料庫查詢次數大幅減少。預先計算成員權限資料避免逐一查詢，同步速度顯著提升。
### 😊 用戶體驗與介面優化
* **AI 助理提問時的骨架載入動畫**：當 AI 助理使用「詢問使用者」工具時，在問題準備期間會顯示閃爍的骨架載入動畫（包含問題列和選項佔位符），取代原本的空白等待狀態。問題準備完成後自動替換為正式的問題卡片，讓使用者清楚知道 AI 正在準備提問。Web Chat 和管理後台均已支援。
* **深度研究任務追蹤改善**：深度研究功能的 AI 研究助理現在會使用待辦清單規劃研究任務，並即時追蹤每個步驟的完成狀態。研究過程更有組織性，減少重複或遺漏的研究步驟。
* **無權限頁面組織切換功能**：當使用者的預設組織失去存取權限時，無權限頁面不再只有「登出」這個選項。頁面會顯示目前所在的組織名稱，並列出使用者擁有權限的其他組織，點擊即可直接切換，無需登出再登入。
### 🛠️ 錯誤修復
* **已修復 Code Interpreter 透過 bash 產生檔案時輸出面板未自動開啟的問題**：當 AI 使用 bash 指令產生檔案（如用 Python 程式庫建立 Excel 或 PDF），輸出面板不會自動展開，使用者無法看到下載介面。修正後系統會偵測 bash 執行結果中的檔案寫入紀錄，自動開啟輸出面板。Web Chat 和管理後台均已修正。
---
# 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/05.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.