跳轉到

程式資訊

  • 程式 ID：AIQueryView
  • 所屬子系統：A.系統資料
  • 狀態：stable

AI 智慧助理

「AI 智慧助理」是內嵌於 TsERP 的對話視窗，讓您用自然語言（中文白話）查詢與分析 ERP 內的資料，並可將結果直接畫成圖表。整個過程唯讀——只查不改，不會新增、修改或刪除任何資料。主要使用者為系統管理員。

功能簡介

平常要查資料得先找到對應表單、設定篩選條件、再按查詢。AI 智慧助理把這段流程改成「直接用講的」：

  • 自然語言查詢：例如輸入「列出近三個月應收前 10 大客戶」，助理會解讀需求、查出資料，並以表格回覆。
  • 分析並出圖：例如輸入「各幣別的應收金額長條圖」，助理會在視窗下方畫出 Vega 圖表（長條圖、折線圖等）。
  • 一鍵開啟查詢程式：問句可對應到一支現成查詢程式並預先填好條件，點「開啟查詢」即開窗（不自動查詢），詳見用自然語言開啟查詢。
  • 資料列不出門：對話中的查詢預設不把實際資料列送雲端模型，明細請透過「開啟查詢」在程式內查看。
  • 唯讀保證：助理只能查詢指定範圍內的資料，無法對任何資料表做新增 / 修改 / 刪除。
  • 資料範圍受白名單控管：只能查詢系統設定（_ai_schema）開放的唯讀檢視表（view），詳見可查詢的資料範圍。

誰看得到這個功能

主視窗右側的 AI 按鈕僅系統管理員可見。一般使用者畫面上不會出現此按鈕，也無法開啟 AI 智慧助理。

前置需求

開始使用前，請確認以下條件（多為系統管理員一次性設定）：

  • 權限：以系統管理員身分登入 TsERP（否則畫面上不會出現 AI 按鈕）。
  • API 金鑰：已在系統參數表（_prgpar）設定 CLAUDE_API_KEY（Anthropic Claude API 金鑰），這是必填項目，未設定無法使用。
  • WebView2 執行階段：若要顯示圖表，該台電腦需安裝 Microsoft Edge WebView2 Runtime。多數 Windows 11 已內建；若未安裝，圖表區會空白（查詢與表格結果仍可正常使用）。

系統參數設定（_prgpar）

由系統管理員在系統參數中設定下列項目：

參數鍵 必填 預設值 說明
CLAUDE_API_KEY 是 無 Anthropic Claude API 金鑰，缺少則無法啟用助理
CLAUDE_MODEL 否 claude-sonnet-4-6 指定使用的模型；留空即用預設模型
AI_MCP_SERVER_PATH 否 自動尋找 MCP server 執行檔路徑；留空時系統自動定位
AI_ROWS_TO_MODEL 否 N（關閉） 是否允許把查詢到的實際資料列送給雲端模型做總結。預設關閉（資料列不出門），詳見資料安全：資料列不送雲端模型

金鑰保密

CLAUDE_API_KEY 屬於機密憑證，請勿外流或寫進共用文件。建議由系統管理員統一保管與設定。

操作步驟

  1. 以系統管理員身分登入 TsERP 主視窗。

  2. 點選主視窗右側的 AI 按鈕，開啟「AI 智慧助理」對話視窗。

    看不到 AI 按鈕？

    該按鈕僅系統管理員可見。若您確定是管理員卻仍看不到，請參考常見問題。

  3. 在對話輸入框輸入您的問題（自然語言），例如：

    • 查詢類：列出近三個月應收前 10 大客戶
    • 出圖類：各幣別的應收金額長條圖

  4. 送出後稍候，助理會回覆：

    • 表格：顯示查詢結果列表。
    • 圖表：若問題需要視覺化，視窗下方會顯示 Vega 圖（需已安裝 WebView2）。

  5. 可接續追問（例如「只看美金的」「改成折線圖」），助理會依上下文調整結果。

AI 智慧助理對話視窗

自然語言查詢回覆表格

分析結果以 Vega 圖表顯示

用自然語言開啟查詢

除了在對話中回覆表格與圖表，AI 智慧助理還能把您的問句對應到一支現成的查詢程式、幫您預先填好查詢條件，讓您一鍵開窗、在該程式的原生條件面板中確認或微調後再自行查詢。適合「想看某主題的完整明細」的情境。

怎麼問

用平常說話的方式描述您想看的資料即可，例如：

  • 上個月哪個客戶毛利最低
  • 我要看毛利率分析
  • 查一下最近的進貨資料
  • 列出金流預測

助理判斷這類問題適合直接進某支查詢程式時，會在文字回覆下方附上一張動作卡，卡片上有 開啟查詢 按鈕。

用自然語言開啟查詢的動作卡

操作步驟

  1. 在對話輸入框輸入您的問題（自然語言），送出。
  2. 助理回覆時，若判斷適合直接進查詢程式，會在下方顯示動作卡，說明它建議開哪一支程式、預備填入哪些條件。
  3. 點卡片上的 開啟查詢 按鈕。
  4. AI 智慧助理視窗會關閉，同時開啟對應的查詢程式（例如「毛利率分析」），且查詢條件已經預先填好。
  5. 請先確認或微調條件（例如調整起訖日期、客戶範圍），再自行按該程式的 查詢 按鈕。

開啟後不會自動查詢

點 開啟查詢 只會開窗並帶好條件，不會自動執行查詢。這是刻意設計——讓條件對您透明、可先檢視與調整，避免直接跑出非預期的大量資料。

「毛利」固定對應毛利率分析

凡是與「毛利」相關的問題，一律對應到毛利率分析（QRY_PROFIT_NOGI）這支程式。

條件如何被驗證

助理填入的每一項條件在開窗前都會經過多重檢查，只有通過才會開窗：

  • 程式白名單：只允許開啟下方 13 支精選程式，其他一律不開。
  • 欄位存在：填入的條件欄位必須是該程式真的有的欄位。
  • 運算子合法：條件運算子必須符合該欄位型別允許的範圍（與查詢條件運算子同一套規則）。
  • 值型別檢查：填入的值必須能轉成該欄位的資料型別。

個別條件套用失敗會明確提示

若某一項條件無法套用，助理會明確告知，不會靜默遺漏；其餘可套用的條件仍會正常帶入。

支援的查詢程式（首波 13 支）

首波開放下列 13 支常用查詢程式。助理會依您的問題自動挑選最合適的一支：

程式代號 程式名稱 用途
QRY_PROFIT_NOGI 毛利率分析 毛利、毛利率相關分析（「毛利」問題固定對應此程式）
QRY_ORD_NOGI 訂單資料查詢 查訂單明細
QRY_SAL_NOGI 出貨資料查詢 查出貨明細
QRY_RA_NOGI 進貨資料查詢 查進貨明細
CU_QRY1 客戶資料查詢 查客戶基本資料
INV_QRY4 庫存流動狀況 查庫存進出流動情形
NOUSE 呆料查詢 查呆滯料
STOCKLIFE 庫齡呆料分析 依庫齡分析呆料
ORD_QRY3 客戶延納統計 統計客戶延遲交貨情形
FLOWCAST 金流預測 查未來現金流預測
SPBUYRANK 進貨廠商統計 統計各供應商進貨排名
PX_QRY 最近進價與售價 查品項最近一次進價與售價
QRY_TRLI_NOGI 其他交易單查詢 查其他交易單明細

資料安全：資料列不送雲端模型

為降低資料外流風險，AI 對話中的查詢預設不會把實際資料列傳給雲端模型：

  • 模型只會知道查到的欄位結構與筆數，看不到任何一筆實際資料值。
  • 聊天視窗內的圖表改由本地繪製，資料同樣不經過模型。
  • 想看完整明細時，請透過本節的 開啟查詢 在程式內查看——資料留在您的環境，不出門。

此行為由系統參數 AI_ROWS_TO_MODEL 控制，預設關閉（N）；即使未在 _prgpar 登錄此參數，也預設鎖死、無須任何部署動作即生效。

開啟前請評估合規風險

將 AI_ROWS_TO_MODEL 改為開啟後，查詢到的實際資料列會被送往雲端模型做總結，等同讓明細資料離開本地環境。除非已採用零留存（如企業條款或自架）方案，否則建議維持關閉。

可查詢的資料範圍

基於安全考量，AI 智慧助理只能查詢白名單內的唯讀檢視表（view）。白名單以外的資料表一律查不到。

白名單由系統設定決定（_ai_schema）

可查詢的檢視表清單與其欄位，是由資料庫的 _ai_schema 設定表控管，不是寫死在程式裡。實際開放哪些表依各公司資料庫的設定而定（例如某資料庫開放數百張檢視表）。要新增可查詢的資料表，由開發 / IT 在 _ai_schema 加入即可，不需改程式。

您不需要記住表名或欄位 —— 直接用中文描述要查的資料，助理會自動：

  1. 查出目前有哪些可查的檢視表，
  2. 取得相關表的欄位，
  3. 撰寫唯讀查詢並執行。

所有查詢都會經過資料庫端的安全閘道（TWORK_AI_QUERY）把關：只允許 SELECT、自動限制回傳筆數、並寫入查詢稽核紀錄（_ai_query_log）；任何新增 / 修改 / 刪除都會被擋下。

常見問題

為什麼我看不到 AI 按鈕？

AI 智慧助理的入口按鈕僅系統管理員可見。一般使用者畫面上不會顯示此按鈕。若您確定為管理員卻仍看不到，請確認登入帳號的權限角色，並請系統管理員協助檢查。

可以查詢，但下方圖表一直不顯示（空白）？

圖表以 Vega 在 WebView2 中繪製。請在該台電腦安裝 Microsoft Edge WebView2 Runtime 後重新開啟助理。未安裝時，查詢與表格結果仍可正常使用，只是無法出圖。

AI 智慧助理會改到我的資料嗎？

不會。 助理是唯讀設計，只能查詢白名單範圍內的資料，無法執行任何新增、修改或刪除動作，請放心使用。

我想查的資料 / 表單查不到？

助理只能查詢白名單（資料庫 _ai_schema 設定）內的檢視表。其餘資料表屬於白名單之外，需由開發 / IT 在 _ai_schema 加入後才能查詢。

回覆內容怪怪的 / 查不到預期資料？

試著把問題講得更具體（指定期間、幣別、排序、筆數等），例如把「應收前幾大」改成「列出 2026 年第一季應收金額前 10 大客戶」。若仍有疑問，請確認該資料是否落在可查詢的資料範圍內。

點了「開啟查詢」，程式開了但沒有自動跑出結果？

這是正常設計。開啟查詢 只負責開窗並把條件預先填好，讓您先確認或微調條件，不會自動執行查詢。請自行按該程式的 查詢 按鈕。詳見開啟後不會自動查詢。

問問題後沒有出現「開啟查詢」動作卡？

動作卡只在助理判斷您的問題適合直接進某支查詢程式時才會出現，且該程式需落在首波 13 支支援清單內。可把問題講得更貼近某支程式的用途（例如「我要看毛利率分析」）再試一次。

AI 會不會把我的資料傳到雲端？

預設不會。查詢到的實際資料列預設不送雲端模型，模型只知道欄位結構與筆數；明細請透過 開啟查詢 在程式內查看。此行為由系統參數 AI_ROWS_TO_MODEL 控制（預設關閉），詳見資料安全：資料列不送雲端模型。

進階：在 Claude Code / Claude Desktop 掛載同一組工具

給開發 / IT 人員

AI 智慧助理背後使用的本機 MCP server（TsErp.Ai.Mcp.Server），同樣可以掛進 Claude Code 或 Claude Desktop 的設定，讓開發者直接從 Claude 介面用同一組工具查詢 ERP（一樣是唯讀白名單範圍）。

在 .mcp.json 的 mcpServers 區段加入該 server，並於 env 帶入唯讀連線字串 TSERP_AI_RO_CONN 等必要環境變數即可。連線字串請務必使用唯讀帳號，與一般 ERP 寫入連線分離，避免誤改資料。

部署提醒：毛利率分析預設圖表（chart-spec）

給開發 / IT 人員

「毛利率分析」新增了預設圖表「客戶毛利額前十五」，其定義隨 chart-spec 部署（sql\chart-spec-deploy.sql 的圖表 seed）。若正式機尚未部署此 seed，該圖表不會出現，但不影響開啟查詢與條件帶入功能。請隨 chart-spec-deploy.sql 一起部署到正式機。

AI_ROWS_TO_MODEL 則無須部署——未在 _prgpar 登錄時預設鎖死（資料列不出門），零部署動作即生效。

相關功能

待補截圖清單

  • images/ai助理-步驟1.png：點開主視窗右側 AI 按鈕後的「AI 智慧助理」對話視窗整體畫面
  • images/ai助理-步驟2.png：輸入自然語言查詢（如「近三個月應收前 10 大客戶」）後回覆的表格結果
  • images/ai助理-步驟3.png：分析類問題（如「各幣別的應收金額長條圖」）在視窗下方顯示的 Vega 圖表
  • images/開啟查詢-動作卡.png：問句（如「上個月哪個客戶毛利最低」）回覆下方出現的「開啟查詢」動作卡，含卡片說明與 開啟查詢 按鈕