Smart Platform AI 助理(AI_Agent)模組

Smart Platform AI 助理（AI Agent）模組可以根據使用者以自然語言輸入的指令（Prompt）， 自主理解任務內容、規劃執行步驟，並透過 Smart Platform 內建工具與外部大型語言模型（LLM）協作， 協助使用者完成開啟指定頁面、查詢資料、轉出檔案以及啟動 Actionflow 等各式作業， 讓使用者不需要熟悉各種操作流程，只要「跟 AI 助理說出需求」即可完成日常工作。

Smart Platform AI 助理在串接外部 LLM 服務時，常見的供應商包括 OpenAI（ChatGPT）、Google（Gemini）以及 Anthropic（Claude）。

此章節包含主題:

適用時機

AI 助理適用於希望以自然語言快速操作 Smart Platform 的各種情境，例如：

若企業希望降低使用者學習成本、減少操作步驟，或將既有的 Smart Platform 頁面與流程「AI 化」， 建議可善用 AI 助理模組進行整合。

事前準備

在使用 Smart Platform AI 助理前，請先準備好外部大型語言模型（LLM）的帳號與 API Key，詳細步驟請參考外部資源設定， AI 助理本身不包含語言模型，而是串接外部 LLM 服務進行指令解析，目前支援三大類供應商。

以上模型皆為 付費商用服務，企業必須自行向相關供應商申請帳號與 API Key，方可在 Smart Platform 中進行串接。 請留意：這些 LLM 並非免費服務，依照模型種類、使用量與各供應商的計費方式不同，費用將有所差異。

在使用任一服務前，建議務必參考其官方網站提供的最新收費方式、API 使用限制與政策說明。 Smart Platform 本身不會向使用者收取額外的模型費用，但系統向外部 LLM 發出的每一次請求都會依該服務廠商的計價方式產生費用。

AI 助理系統設定

在開始設計 AI 作業前，需先於 系統設定 中完成 AI 助理所需的 LLM 相關參數， 包含 LLM 類型、模型名稱、API Key 以及溫度參數等。這些設定為後續所有 AI 作業的共用設定。

  1. 進入 AI 助理系統設定畫面

    請依下列步驟操作（可參考下圖）：

    步驟一：從主畫面依序進入設計端 → 系統管理 → 系統設定 → AI 助理。

    步驟二：在左側選單中點擊「AI 助理」，右側即會顯示 LLM 相關設定畫面。

    步驟三：完成設定後，請點擊畫面右上角的【存檔】以儲存設定。

    AI 助理系統設定畫面

  2. 設定 LLM 相關參數

    主要設定項目說明如下：

    • LLM 類型：設定本系統要串接的 LLM（大型語言模型）服務。 目前支援常見LLM，如 OpenAI（ChatGPT）、Google（Gemini）、 Anthropic（Claude） 等。

    • LLM 模型：輸入或選擇使用的模型名稱，例如 gpt-4o。

    • LLM API Key：填入自外部 LLM 服務取得的 API 金鑰，請妥善保管，避免洩漏。

      若尚未申請 OpenAI、Google Gemini 或 Anthropic Claude 等外部 LLM 服務的 API Key， 可參考本文件下方的「外部資源設定」區段，依照各供應商的說明進行申請與設定。 詳細步驟請參考： 《外部資源設定》

    • LLM 溫度參數：用來控制 AI 回答的隨機程度。 數值愈高，回覆愈有創意、愈發散；數值愈低，則愈精準、偏向保守。 建議可依實際使用情境調整至適當的數值。

      不同模型支援的溫度範圍可能不同， 例如部分模型為 0.0～2.0，也有模型僅支援 0.0～1.0。 請依所選 LLM 的 API 規格設定合適的範圍，以確保運作正常。

    • 條件清單預設敘述：此欄位讓設計者快速填寫「可用條件清單」的說明，協助 AI 理解哪些值是合法的選項。

      當頁面上有類似「營運處」等具有選項的條件（例如：北市、北區、中區、南區等），設計者不必手動逐一輸入，可使用旁邊的自動套用按鈕，系統將自動填寫預設說明。

      AI 助理系統設定畫面

      在預設敘述中，可以使用特殊關鍵字 #List，系統在載入 AI 作業時自動將其替換為條件項目，例：

      必須由使用者輸入，而且值必須是：#List 中的一項，其他值都不合法

      此機制讓 AI 可自動根據頁面條件選項進行驗證，避免錯誤參數，並讓設計者能自由調整說明內容，減少逐項維護條件項目的負擔。

AI 作業定義

AI 作業定義用來描述「當使用者下達某類型指令時，AI 助理應該如何操作 Smart Platform」， 例如要開啟哪一個儀表板或報表、需要哪些條件欄位、如何帶入參數，以及最終要以何種方式回應使用者 （開啟頁面、轉出檔案、執行 Actionflow 等）。

  1. 開啟 AI 作業定義管理畫面

    於 Smart Platform 主畫面左側功能列點擊 「AI」圖示，即可進入 AI 作業定義 管理頁面，在此可以新增、編輯或刪除各種 AI 作業。

    AI 作業定義入口

  2. 新增 AI 作業

    在左側「AI 作業定義」樹狀結構上，以滑鼠右鍵點擊資料夾，即可選擇：

    • 新增頁面：定義 AI 助理要操作的儀表板或報表頁面。

    • 新增 ActionFlow：定義 AI 助理要啟動的流程（例如發起會議流程）。

    • 新增資料夾：用於整理分類不同的 AI 作業。

    新增 AI 作業選單

  3. 選擇目標頁面

    若選擇「新增頁面」，系統會開啟「選擇目標頁面」對話框，讓設計者從既有 Smart Platform 頁面中， 選取欲由 AI 助理操作的儀表板或報表，例如「訂單明細」、「門市銷售分析」等。

    選擇目標頁面

  4. 編輯 AI 作業屬性與條件

    選定目標頁面或 Actionflow 後，即會進入 AI 作業詳細設定畫面，可設定的主要欄位包含：

    AI 作業定義編輯畫面範例

    • 儲存：可手動按存檔將異動的規格儲存，或切換樹的節點會自動存檔。

    • 重新整理：當您在此節點的原頁面新增或刪除條件後，可點擊此按鈕，系統會先自動儲存變更，並重新載入 AI 作業設定畫面以更新最新內容。

    • 頁面編號：系統自動帶入此 AI 作業所對應的頁面唯一識別碼（GUID）。 此編號主要提供系統內部辨識使用，通常無需人工修改。

    • 頁面名稱：對應至實際頁面的名稱，例如「門市銷售分析」、「訂單明細」。

    • 標題：AI 作業名稱，例如「訂單明細」、「門市銷售分析 (ppt)」。

    • AI 任務說明：向 AI 說明此作業的用途與行為，例如 「輸出訂單明細資料」、「輸出門市銷售分析為 pptx 檔案」等。 此內容會作為系統提示（System Prompt），協助 AI 了解任務。

    • AI 條件說明：此處的條件欄位會依據「目標頁面或 Actionflow 本身的欄位」自動帶入。 您可在此描述這些條件的格式與使用方式，例如「年份（string）、營業區（string）、區域（string）」等， 讓 AI 能正確解析使用者指令並對應到實際的頁面條件。 此外，若某些條件在實際頁面中並不需要使用，您可在 AI 設計介面中將其移除； 日後若需要再次使用，也可以透過「新增條件」將先前移除的條件重新加入。

    • 加入現在時間判斷：勾選後，AI 可利用現在時間推算「今天」、「明天」、「下週一」等相對日期。

    • 回應方式：可選擇「開啟頁面」、「輸出檔案」、「執行頁面並回傳訊息」等回應方式。 若選擇「輸出檔案」，需再搭配下方的「輸出檔案類型」與「檔案類型」一起設定。

    AI 作業定義 Smart Platform Tools 任務類型

    • 輸出檔案類型：僅在回應方式為「輸出檔案」時使用，用來指定要輸出的物件類別。

      • Q－資料：以查詢結果資料列為主。

      • Q－報表：以報表版面及其內容為主。

      • D－資料／儀表板版面：以儀表板元件或整個版面為主，可輸出對應畫面或資料。

    • 檔案類型：依「輸出檔案類型」不同，可選擇實際匯出的檔案格式：

      • Q－資料：支援 Excel、TXT、XML、PDF、Word。

      • Q－報表：支援 PDF、Word、Excel。

      • D（儀表板）：支援 PDF、Word、PPT、圖片。

    • 其他欄位則可依實際需求進行設定，例如是否必填、欄位型別等。

  5. 維護與刪除 AI 作業

    若日後不再使用某個 AI 作業，可在左側樹狀結構上以滑鼠右鍵點選該作業，選擇「刪除」將其移除； 也可透過新增資料夾、拖曳節點等方式，整理不同類型的 AI 作業，維持樹狀結構的整齊。

    刪除 AI 作業示意

  6. 設計端統一管理 AI 作業

    所有頁面與 Actionflow 若需要開放給 AI 助理使用，皆可在「AI 作業定義」中集中設定任務與參數說明。

    AI 助理設計端總覽畫面

AI 助理使用情境範例

本節說明 AI 助理在 Smart Platform 中的應用情境，示範如何透過自然語言指令， 開啟儀表板或報表並帶入參數，以及轉出檔案或啟動 Actionflow。

注意：只有在使用者端登入時，才會顯示 AI 助理圖示（如下圖紅色箭頭所示）；若以「設計端登入」，則僅會在 AI 作業定義的設計頁籤中看到，不會一直出現在設計端操作介面。

「使用者端登入」時才會顯示 AI 助理 圖示

點選 AI 助理圖示後，會在畫面右側開啟 AI 助理對話窗（如下圖所示）， 使用者可直接輸入自然語言指令，要求系統開啟儀表板、帶入參數、匯出報表， 或啟動 Actionflow 等操作。

在對話窗左上角 「新對話」 按鈕（加號圖示）， 點選後會開啟一個全新的對話視窗，用於開始新的需求或操作流程。 若想查看之前與 AI 的對話紀錄，可點選左上角的 「»」 展開歷史對話列表， 方便切換與回顧過往的互動內容。

AI 助理對話窗：含新對話與歷史對話切換功能

若使用者透過 AI 助理請求開啟特定頁面，但其帳號並未具備該頁面的權限， 系統仍會收到指令，但在實際開啟頁面時會進行權限驗證。 若權限不足，AI 助理會回覆「未授權的頁面」，提醒使用者無法存取該功能。

AI 助理對話窗：「未授權的頁面」，提醒使用者無法存取該功能

  • 情境一：開啟儀表板並帶入參數

    使用者輸入指令：「開啟 202206 北市士林區門市銷售」。 AI 助理會解析指令中的年月（202206）、縣市（北市）與區域（士林區）， 自動開啟對應的「門市月銷售分析」儀表板，並將這些條件帶入頁面上的查詢參數，讓使用者直接看到符合條件的圖表與數據。

    情境一：開啟儀表板並帶入參數
    情境一：開啟儀表板並帶入參數

    對應的 AI 作業定義如下圖所示：

    門市銷售分析 (開啟) 作業定義

  • 情境二：儀表板帶入參數，轉出 PPTX

    使用者輸入指令：「202105 北市內湖區門市銷售 輸出 PPT 檔」。 AI 助理會依指令執行「門市銷售分析」儀表板，帶入年月（202105）與區域（北市／內湖區）， 並依 AI 作業設定將儀表板版面轉出為 PPTX 檔案，供使用者下載。

    情境二：儀表板帶入參數並轉出 PPTX
    情境二：儀表板帶入參數並轉出 PPTX

    對應的 AI 作業定義如下圖所示：

    門市銷售分析 (ppt) 作業定義

  • 情境三：報表帶入參數，轉出 PDF

    使用者輸入指令：「2025 年 3 月東南實業的訂單明細 轉出 PDF」。 AI 助理會依指令解析公司名稱（東南實業）與日期區間（2025/03/01 ～ 2025/03/31）， 執行「訂單明細」報表並將結果轉出為 PDF 檔案，讓使用者直接下載。

    情境三：報表帶入參數並轉出 PDF
    情境三：報表帶入參數並轉出 PDF

    對應的 AI 作業定義如下：

    訂單明細 作業定義

  • 情境四：開啟請假單並帶入欄位參數

    使用者輸入指令：「下星期一我要請整天事假」。AI 助理會根據現在時間判斷「下星期一」的實際日期， 自動計算請假起迄時間與天數，開啟「員工請假單」頁面並帶入假別、請假起始時間、 結束時間與請假天數等欄位，讓使用者只需確認後送出表單即可。

    情境四：開啟請假單並帶入參數
    情境四：開啟請假單並帶入參數

    相關 AI 作業定義如下：

    畫面為欄位選取視窗，設計者可在此點選要提供給 AI 助理使用的欄位。 支援搜尋、全選、清除選擇等功能，並能一次選取多個欄位（如圖中灰底區塊所示）。 選擇完成後點擊「確定」即可套用，點擊「取消」則不做任何動作。

    請假單 作業定義。

  • 情境五：儀表板帶入參數，於 Mobile 裝置轉出圖片

    在手機或平板上，使用者可點選畫面右下角的「AI」圖示開啟 AI 助理對話框，接著以文字或語音輸入指令：「2021 廠區產品分析 傳圖片」。 AI 助理會自動執行「年度廠區產品分析」儀表板，帶入指定年度後產出圖片檔案，並在對話中直接顯示預覽，方便使用者查看。

    情境五：Mobile 儀表板轉出圖片

    對應的 AI 作業定義如下：

    年度廠區產品分析 作業定義

  • 情境六：啟動 Actionflow 發起會議並寄送通知

    使用 AI 助理可以啟動現有的 Actionflow，例如「發起會議流程」。 只需在指令中提供會議的時間、標題、說明及與會人員，例如： 「我要在今天下午 5:00 到 6:00 發起會議，會議標題是：研討會流程，會議事由是：討論研討會整體活動流程，與會人員包括：vvin，annylin，charlotte」 。 AI 助理會自動將這些資訊轉換為 Actionflow 所需的格式，並建立會議資料、填寫行事曆，還會發送通知 Email 給與會人員，完成整個流程。

    情境六：Actionflow 發起會議流程示意

    補充說明：
    在這個例子中，使用的 Actionflow（例如「發起會議流程」）是由設計者先在系統中建立的，透過「系統流程」選項進行設定。 Actionflow 包含各種步驟，如 Script、SQL、E-Mail、資料寫入等，並可反覆執行。

    當 AI 助理啟動 Actionflow 時，它會根據預先設定的規則，將使用者提供的資訊（如會議時間、標題、與會人員等）整理成 Actionflow 所需的格式， 並自動填入對應的流程節點，完成自動化操作。

    系統流程：Actionflow 來源位置示意

    對應的 AI 作業定義畫面如下：

    發起會議流程 作業定義。

    • AI 助理模組應用－AI Text to SQL

    AI Text to SQL 讓使用者只需用自然語言描述查詢需求，系統便會自動生成對應的 SQL 查詢語句。這項功能特別適合對 SQL 語法不熟悉的使用者。 例如，設計者可以輸入：「列出所有銷售明細，包含客戶編號、客戶名稱、業務姓名、品名、訂單日期、數量、單價」，系統會根據資料庫的結構及欄位名稱，自動生成相應的 SQL 查詢語句。 若要使用此功能，請參考以下步驟進行操作。

    1. 啟用「AI 設定」功能

      在使用 AI Text to SQL 前，設計者需要在「資料連線管理」中為資料來源啟用 AI 設定，以便 AI 能正確理解資料表結構。

      資料連線管理：進入資料來源設定

    2. 設定資料來源中的 AI 規格

      在資料來源的 AI 設定頁籤 中，設計者需要進行以下設定：

      • 啟用：開啟後，資料表與欄位可以提供給 AI 使用。

      • 規格套用方式：

        • 所有資料表及欄位：自動匯入完整資料庫結構。

        • 選擇資料表及欄位：只提供選定的資料表與欄位，避免暴露不必要的資料。

      • 欄位名稱方式：

        • 原生欄位名稱：使用資料庫的原生欄位名稱。

        • 標題/說明：使用欄位的描述名稱。

      • 欄位說明設定：為資料庫的欄位補充說明，有助於提升 SQL 產生準確度。

      • 資料表關聯（ERD）設定：若資料庫中已設定資料表間的關聯，AI 會根據這些關聯自動生成 JOIN 條件。

      資料來源中的 AI 設定：設定欄位說明

    3. 啟用 AI SQL 生成功能

      在新增查詢時，設計者可以點選右上角的 「AI SQL」 按鈕，開啟 AI 助理對話框並以自然語言描述查詢需求，AI 會自動生成 SQL。

      AI SQL 對話框：輸入查詢需求

    4. AI Text to SQL 的功能特色

      • 自動轉換資料庫結構為 AI 可理解的格式。

      • 支援欄位別名和說明，提升解析準確度。

      • 支援多資料表 JOIN，依資料表關聯自動產生 JOIN 條件。

      • 資料安全保障：AI 僅接收資料庫結構，無法接觸實際資料。

    Smart Platform AI 助理架構

    Smart Platform AI 助理透過外部大型語言模型（LLM）、內部工具（Dashboard、Query、Report、Input、Actionflow） 以及企業內部各式資料來源（資料庫、資料倉儲、ERP、CRM、SCM、REST/SOAP 服務等）組成一個完整的 AI 應用架構。

    架構上由使用者以自然語言提出需求，AI 助理由 LLM 協助理解意圖與拆解任務， 再透過 Prompt Template 與 Smart Platform Tools 將指令轉換為實際操作， 並可符合 MCP Client（Model Context Protocol）標準，與其他 Agent Builder 整合。

    Smart Platform AI 助理架構圖

    外部資源設定

    本節說明 Smart Platform AI 助理在串接外部 LLM 服務時，常見三種供應商 OpenAI（ChatGPT）、Google（Gemini）、Anthropic（Claude）之 API Key 申請方式與在本系統中的基本設定提示。

    1. OpenAI（ChatGPT）API Key 申請與設定

      帳號註冊與登入

      1. 前往 OpenAI 平台： https://platform.openai.com/

      2. 點選 Sign up 或 Sign in 登入。

      3. 可使用 Email 註冊，或以 Google / Microsoft / Apple 帳號登入。

      建立 API Key

      1. 登入後，請直接進入 API Key 管理頁面：
        https://platform.openai.com/account/api-keys

      2. 若系統要求補充開發者資訊（Developer Setup），請依畫面完成設定，否則可能無法看到 API Keys。

      3. 於 API Keys 頁面點選 Create new secret key 建立新的金鑰。

      4. 輸入金鑰名稱（例如：production-backend、dev-testing）。

      5. 建立後畫面會顯示一組 Secret Key，請立即複製並妥善保存（之後無法再查看）。

      ※ 若於右上角帳號選單未看到「API keys」，可能仍停留在 ChatGPT 主站頁面，請重新登入 Developer Platform 或使用上述 API Key 連結。

      在本系統中的設定提示

      • LLM 類型：選擇 ChatGPT

      • LLM 模型：例如 gpt-4.1、gpt-4o 等。

      • API Key：填入於 OpenAI 平台建立的 Secret Key。

    2. Google（Gemini） API Key 申請與設定

      登入 Google AI Studio

      1. 前往 AI Studio 後台（可產生 API Key）：
        https://aistudio.google.com/

      2. 點選右上角 Sign in，使用 Google 帳號登入。

      3. 首次使用需依畫面指示同意相關條款。

      建立 Gemini API Key

      1. 登入後進入左側選單的 API keys 頁面。

      2. 按下 Create API key 建立新的 API Key。

      3. 複製產生的 API Key 並妥善保存。

      ※ Google AI Studio 介面可能更新，按鈕名稱與位置可能略有變動，請以實際操作畫面為準。

      在本系統中的設定提示

      • LLM 類型：選擇 Gemini

      • LLM 模型：例如 gemini-1.5-flash、gemini-1.5-pro 等。

      • API Key：填入於 Google AI Studio 建立的 API Key。

    3. Anthropic（Claude） API Key 申請與設定

      帳號註冊與登入

      1. 前往 Anthropic Console：
        https://console.anthropic.com/

      2. 點選 Sign up 註冊，或 Sign in 登入既有帳號。

      3. 依畫面指示完成 Email 驗證與必要資料填寫。

      建立 API Key

      1. 登入後，於左側選單進入 API Keys。

      2. 點選 Create Key 並輸入金鑰名稱（例如：prod-service）。

      3. 系統會產生一組 API Key，請立即複製並妥善保存。

      ※ Anthropic Console 介面可能會更新，部分按鈕位置或名稱可能略有變動，請以實際畫面為準。

      在本系統中的設定提示

      • LLM 類型：選擇 Claude

      • LLM 模型：例如 claude-3.5-sonnet-latest、claude-3.5-haiku-latest 等。

      • API Key：填入於 Anthropic Console 建立的 API Key。

    本節內容僅為一般性操作說明，實際介面、可用模型與計費政策請以各 LLM 服務官方網站公告為準。