建立與設定資料庫
本篇將介紹如何在 MaiAgent 中建立與設定資料庫，包含上傳檔案建立資料表、連接外部資料庫、以及欄位描述設定
MaiAgent 的資料庫管理功能讓您可以在平台上集中管理 AI 助理所使用的資料庫連線。搭配 Text to SQL 功能，AI 助理就能透過自然語言直接查詢資料庫中的資料。
MaiAgent 支援兩種資料庫類型：
MaiAgent 資料庫：上傳 Excel / CSV / JSON 檔案，系統自動建立資料表。適合沒有自建資料庫的使用者
外部資料庫：連接既有的 PostgreSQL、MySQL、MSSQL 或 Oracle 資料庫
從左側導航欄進入「AI 功能」區塊，點擊「資料庫」。頁面分為兩個頁籤：MaiAgent 資料庫與外部資料庫。
點選右上角的「新增資料庫」按鈕開始建立。
資料庫管理頁面，顯示 MaiAgent 資料庫列表 選擇您要建立的資料庫類型，點擊對應的卡片：
MaiAgent：適合上傳試算表檔案，不需要連線字串
PostgreSQL / MySQL / MSSQL / Oracle：連接企業既有的外部資料庫
連線字串格式如下：
請務必確認連線字串格式正確，並包含必要的連線資訊。需要確保資料庫 URL 是可以被 MaiAgent 服務訪問的。
步驟二：外部資料庫（PostgreSQL）設定畫面 填寫連線字串後，建議點擊「測試連線」按鈕來驗證連線是否正常：
連線成功：代表 MaiAgent 可以正常存取您的資料庫
連線失敗：請檢查連線字串格式、網路連通性，以及資料庫是否允許外部連線
若您的資料庫包含大量資料表，可以在「指定資料表」欄位中輸入要開放的資料表名稱（例如 customers, orders, products），以提升查詢效率及安全性。
最後一步是設定哪些群組可以存取這個資料庫。使用左右穿梭元件，將需要授權的群組從左側移至右側即可。
確認所有設定後，點擊「建立」按鈕。建立成功後會進入資料庫設定頁面，可以進行後續操作。
上傳檔案建立資料表（MaiAgent 資料庫）
建立 MaiAgent 資料庫後，進入設定頁面切換至「表格管理」頁籤，點擊「上傳表格檔案」按鈕。
上傳後，系統會在背景自動解析檔案結構並建立資料表。每張資料表會顯示處理狀態：
若資料表建立失敗，常見原因包括：檔案格式不正確或損毀、欄位名稱包含特殊字元、欄位名稱重複、同一欄位中的資料型態不一致。
欄位描述是提升 Text to SQL 查詢準確度的關鍵設定。AI 助理會參考欄位描述來理解資料的含義，從而產生更精確的 SQL 查詢。
例如，您的資料表有一個欄位叫 status，AI 助理可能不知道它代表什麼。但如果加上描述「訂單狀態，可能的值為：pending（待處理）、completed（已完成）、cancelled（已取消）」，AI 助理就能正確理解這個欄位的含義。
MaiAgent 資料庫：在「表格管理」頁籤中，點擊資料表的「編輯」，可以編輯資料表描述與欄位描述。視窗中會顯示填寫進度（例如「3/10 個欄位已設定描述」）。
外部資料庫：在「基本資訊」頁籤下方的資料表清單中，點擊展開資料表，直接在欄位描述欄中輸入說明。
客戶等級，A 級為年消費超過 100 萬的 VIP 客戶，B 級為年消費 10-100 萬，C 級為其他
客戶所在地理區域，可能的值為：北部、中部、南部、東部、離島
在資料庫列表中，點擊操作選單的「編輯」即可進入設定頁面。
設定頁面包含以下頁籤：
在資料庫列表中，透過「啟用」開關可以快速切換狀態。停用後 AI 助理將暫時無法查詢此資料庫，但設定和資料會保留。
刪除資料庫是不可逆的操作。
MaiAgent 資料庫：刪除後，所有透過上傳檔案建立的資料表都會被一併移除
外部資料庫：僅移除 MaiAgent 中的連線設定，不會影響原始資料庫中的資料
