MaiAgent 資料庫進行 Text to SQL
本篇將介紹如何上傳 Excel、CSV 等試算表至 MaiAgent 資料庫，讓 Agent 透過自然語言查詢與分析您的資料
想讓 Agent 協助您分析 Excel、CSV 等試算表資料，只需要將檔案上傳至 MaiAgent 資料庫，Agent 就能用自然語言查詢資料並產出統計分析結果。
步驟一：建立 MaiAgent 資料庫
從左側導航欄進入「AI 功能」>「資料庫」
點擊「新增資料庫」
選擇「MaiAgent 資料庫」
輸入資料庫名稱（例如「2024 年度銷售資料」），點擊建立
步驟二：上傳試算表檔案
建立完成後，進入資料庫設定頁面：
切換至「表格管理」頁籤
點擊「上傳表格檔案」
拖曳或選取您的試算表檔案
您可以自行下載範例檔案（100 筆品項的食品銷售檔案.xlsx）進行測試，體驗 Agent 的數據分析能力。
上傳完成後，等待處理狀態顯示「成功」，即代表資料表已建立完成。
支援格式：.csv、.xlsx、.xls、.json、.jsonl。Excel 檔案中每個工作表會各自建立一張資料表。
表格格式注意事項
步驟三：關聯 Agent
將資料庫關聯至您的 Agent，Agent 才能查詢資料：
切換至「關聯 AI 助理」頁籤
從左側選取要關聯的 Agent，移至右側
點擊「儲存」
請確保 Agent 的回答模式已切換至 Agent 模式，否則無法使用 Text to SQL 功能。
回答模式的詳細設定請參考：建立 Agent
步驟四：與 Agent 對話
以上步驟完成後，您可以進入 Agent 的對話頁面，直接用自然語言告訴 Agent 您的需求。
數據分析
Text to SQL 工具能協助您分析試算表中的數據，例如：「幫我找到去年銷售量最好的乳製品」
當您提出需求後，Agent 會自動調用 Text-to-SQL 工具。
這個工具就像一位翻譯員，可以將您說的話翻譯成電腦看得懂的 SQL 語法，讓 Agent 可以從資料庫中提取資料。
Agent 會自動加上條件判斷、排序依據等查詢限制，將您的需求轉換為更完整的查詢指令。
Agent 的思考 Query： 找到去年銷售量最好的乳製品，按銷售數量降序排列。自動加入降序排列的條件，讓結果更符合您的需求。
Agent 的回應(點按工具回應即可查看)：
結果
Agent 找到了所有「乳製品」的銷售資料及該項目的其他欄位資料。
每一行代表一筆資料，包含：產品 ID、產品名稱、產品類別、銷售金額、銷售數量......。
Agent 根據這些資料，判斷出銷售最好的乳製品是「乳酪」，銷售數量為 110，銷售金額為 40,150 元。
報表製作(Canvas 模式)
Text to SQL 工具也能協助您製作精美的報表，此功能會需要開啟 Canvas 模式：
至「Agent 設定頁面 > 回答模式設定下」找到 Agent 模式
將 Agent 模式由一般模式改為畫布模式(Canvas)
儲存設定後，即可與 Agent 進行對話，例如：「請幫我產出統計過後的營收視覺化報表」
Agent 的思考 Query： 計算食品公司各商品的營收統計，包括總營收、平均營收、營收標準差、營收分布區間、各分類營收占比等統計指標。自動產出報表需要的計算結果，讓結果更符合您的需求。
Agent 的回應(點按工具回應即可查看)：
結果
Agent 獲得工具自動統計的所有須統計項目結果並回傳。
Agent 將這些資料作為視覺化依據，使用 Canvas 做出可互動的報表畫面。
點按「使用畫布」方框即可查看畫面內容
報表呈現畫面如下，您可以：
切換查看原始程式碼或畫面
依照想查看的統計分類切換報表內容(此處依每個 Agent 產出內容不同而不相同)
當切換至其他分類時，即可查看分類營收占比圓餅圖及分布分析長條圖：
最後更新於
這有幫助嗎？