使用 MaiAgent 知識庫進行 Text to SQL

想讓您的 AI 助理協助您分析以 Excel、試算表形式存取的資料,您可以透過以下步驟讓 AI 助理協助您產出統計分析結果。

步驟一:將 AI 助理切換至 Agent 模式

  • Agent 模式賦予 AI 助理使用工具的能力在這個模式下,AI 助理才能夠理解試算表資料的結構,並運用 Text-to-SQL 工具進行分析。

在 Agent 模式下選擇 MaiAgent,切換後不需做更改後面網址欄位

請一定要選擇 maiagent 服務並儲存結果,否則無法啟用 text to SQL 工具

步驟二:上傳 CSV 等試算表檔案

1. 進入知識庫頁面,點按編輯操作

2. 上傳檔案(.xls, .xlsx, .csv)

詳細知識庫檔案上傳方法請參考:知識庫總覽—如何上傳知識庫?

您可以自行下載範例檔案(100 筆品項的食品銷售檔案.xlsx)進行測試,體驗 AI 助理的數據分析能力。

試算表欄位數量Reranker 檢索片段數量是兩個完全獨立的設定參數,彼此之間不存在依賴關係或相互影響。

Reranker 介紹,請參考:技術人員手冊—Reranker 模型

檔案上傳畫面
上傳完成後畫面

當檔案出現在知識庫內並且處理狀態顯示「完成」時(如上右圖),系統會自動建立資料庫,AI 助理就能讀取您的檔案,協助您以 SQL 語法產出計算、統計結果。

📍請注意:未上傳資料將無法使用 Text-to-SQL 問答功能

表格格式注意事項

步驟三:與 AI 助理對話

以上步驟完成後,您可以進入與 AI 助理對話的頁面,像和其他人對話討論一樣,直接用自然語言告訴 AI 助理您的需求。

AI 助理對話介面,請參考:選擇串接平台,根據需求選擇您最適合的對話平台。

數據分析

Text to SQL 工具能協助您分析試算表中的數據,例如:「幫我找到去年銷售量最好的乳製品」

  • 當您提出需求後,AI 助理會自動調用 Text-to-SQL 工具。

  • 這個工具就像一位翻譯員,可以將您說的話翻譯成電腦看得懂的 SQL 語法,讓 AI 助理可以從資料庫中提取資料。

AI 助理會自動加上條件判斷、排序依據等查詢限制,將您的需求轉換為更完整的查詢指令。

  • AI 助理的思考 Query: 找到去年銷售量最好的乳製品,按銷售數量降序排列。自動加入降序排列的條件,讓結果更符合您的需求。

  • AI 助理的回應(點按工具回應即可查看):

結果

  • AI 助理找到了所有「乳製品」的銷售資料及該項目的其他欄位資料。

  • 每一行代表一筆資料,包含:產品 ID、產品名稱、產品類別、銷售金額、銷售數量......。

  • AI 助理根據這些資料,判斷出銷售最好的乳製品是「乳酪」,銷售數量為 110,銷售金額為 40,150 元。

報表製作(Canvas 模式)

Text to SQL 工具也能協助您製作精美的報表,此功能會需要開啟 Canvas 模式:

  1. 至 「 AI 助理設定頁面 > 回答模式設定下」 找到 Agent 模式

  1. 將 Agent 模式由一般模式改為畫布模式(Canvas)

儲存設定後,即可與 AI 助理進行對話,例如:「請幫我產出統計過後的營收視覺化報表」

  • AI 助理的思考 Query: 計算食品公司各商品的營收統計,包括總營收、平均營收、營收標準差、營收分布區間、各分類營收占比等統計指標。自動產出報表需要的計算結果,讓結果更符合您的需求。

  • AI 助理的回應(點按工具回應即可查看):

[('分類營收占比-主食', '10.72%'), ('分類營收占比-乳製品', '11.97%'), ('分類營收占比-冷凍', '9.06%'), ('分類營收占比-罐頭', '10.25%'), ('分類營收占比-肉類', '13.23%'), ('分類營收占比-蔬果', '13.34%'), ('分類營收占比-調料', '4.51%'), ('分類營收占比-零食', '14.53%'), ('分類營收占比-飲料', '12.40%'), ('商品總數', '100'), ('平均營收', '19546.06'), ('最低營收', '1400'), ('最高營收', '63364'), ('營收標準差', '15736.83'), ('總營收', '1954606')]

結果

  • AI 助理獲得工具自動統計的所有須統計項目結果並回傳。

  • AI 助理將這些資料作為視覺化依據,使用 Canvas 做出可互動的報表畫面。

點按「使用畫布」方框即可查看畫面內容

報表呈現畫面如下,您可以:

  1. 切換查看原始程式碼或畫面

  2. 依照想查看的統計分類切換報表內容(此處依每個 AI 助理產出內容不同而不相同)

當切換至其他分類時,即可查看分類營收占比圓餅圖及分布分析長條圖:

結語

使用 MaiAgent Text to SQL 工具,您可以快速讓 AI 助理協助您分析試算表內容,並產出精美的報表。現在就開始體驗,讓 AI 助理成為您的數據分析好幫手!

額外提示

  • 資料品質很重要: 確保您的試算表資料是乾淨且正確的,這將直接影響 AI 助理分析結果的準確性。

  • 不想交給 AI 的資料需確實刪除:在試算表中隱藏的資料知識庫仍然能正常解析並提供給 AI 助理,因此若有不希望暴露給 AI 助理的資料不能僅以隱藏處理,而必須確實刪除。

  • 多嘗試不同的問題: 透過不同的提問方式,您可以從資料中挖掘出更多有價值的資訊。

  • 善用 Canvas 模式: Canvas 模式可以讓您輕鬆製作出各種視覺化報表,更直觀地呈現數據分析結果。

Last updated

Was this helpful?