Qlik MCP 工具

Qlik MCP 伺服器包含可讓您的 LLM 在您的 Qlik Cloud 租用戶中為您執行動作的工具。您可以透過選取想要使用的 Qlik MCP 工具來自訂您的體驗。

存取權限與 Qlik MCP 工具

MCP 工具的存取權由您的權限控制。您需要在自訂角色中具備 Qlik MCP: 允許 權限，才能從您的 LLM 用戶端存取 Qlik MCP 工具。

此外，由於 Qlik MCP 工具是以連線使用者的身分獲得授權，因此它會使用您現有的使用者角色和空間權限。您還需要在 Qlik Cloud 中具備權限，才能使用這些工具所使用的功能或內容類型。例如，如果您沒有在 Qlik Cloud 中存取譜系的權限，您就無法使用 Qlik MCP 工具 Qlik get lineage。根據您的權限，如果您無法在 Qlik Cloud 中使用該功能或特性，某些工具可能會回應無存取權。

工具的可用性也可能受到您租用戶授權的限制。

選取 Qlik MCP 工具

Qlik MCP 工具是專門建置的動作目錄，LLM 可以呼叫這些動作在您的 Qlik Cloud 租用戶中執行動作。這些動作包括：

• 尋找應用程式和資料集

• 檢查欄位和圖中繼資料

• 套用和清除篩選

• 建立工作表和圖

• 管理受治理的資產，例如詞彙表術語和資料產品。

每個工具都代表具有明確定義之輸入和輸出的特定功能。

可用的 Qlik MCP 工具

下表顯示目前 Qlik MCP 工具類別和工具名稱的概述。

各個工具可以完成的任務

應用程式探索與中繼資料

使用這些工具尋找正確的 Qlik 分析應用程式，並在建置圖或套用篩選之前快速了解其中的內容。此類別支援端對端探索流程：在 Qlik 資源中搜尋以找出相關的應用程式。

提供下列工具：

• Qlik_search：依名稱或內容搜尋 Qlik 資源 (應用程式、資料集、資料產品、詞彙表)。

• Qlik_describe_apps：取得應用程式的全面中繼資料，包括欄位、擁有者、發佈狀態。

• Qlik_get_fields：列出應用程式中可用作維度的所有資料欄位。

• Qlik_list_sheets：列出應用程式中的所有工作表。

• Qlik_get_sheet_details：取得特定工作表的詳細資訊，包括所有圖及其類型。

• Qlik_search_spaces：根據查詢字串搜尋空間。

提示範例：

「我需要分析客戶流失。」這個簡單的提示可讓您：

• 使用 qlik_search 尋找與「流失」或「客戶保留」相關的應用程式。

• 為了獲得最佳相符結果，請執行 qlik_describe_app 以確認它是正確的應用程式，並查看其中繼資料 (擁有者和發佈狀態)。

• 使用 qlik_get_fields 列出可用的欄位，並識別候選維度和量值，例如 Customer、ChurnFlag、SubscriptionType、Region 和 ChurnDate。

• 使用 qlik_list_sheets 查看已存在哪些儀表板。

• 對於任何有潛力的工作表 (例如「流失概述」)，呼叫 qlik_get_sheet_details 並總結已有哪些圖以及還存在哪些差距。

商業詞彙表

這組工具可讓使用者端對端設定和維護受治理的商業詞彙表：

• 建立詞彙表

• 使用類別進行組織

• 新增和策劃術語 (包括編輯、移除和管理生命週期狀態，例如草稿-已驗證-已棄用)

• 將這些術語連接到實際的分析資產 (應用程式、資料集、欄位、主項目)。

提供下列工具：

• Qlik_create_glossary：建立新的商業詞彙表

• Qlik_get_full_glossary_export：取得包含所有術語、類別、連結的完整詞彙表 (耗費資源的作業)

• Qlik_get_glossary_categories：擷取詞彙表的所有類別

• Qlik_create_glossary_category：在詞彙表中建立新類別

• Qlik_search_glossary_terms：在詞彙表中搜尋術語

• Qlik_get_glossary_term：從詞彙表中取得特定術語

• Qlik_create_glossary_term：建立具有描述、標籤、關係的新詞彙表術語

• Qlik_update_glossary_term：修改現有的詞彙表術語

• Qlik_delete_glossary_term：移除詞彙表術語

• Qlik_update_term_status：更新術語狀態 (草稿、已驗證、已棄用)。只有管理員可以驗證術語。術語經過驗證後，只有管理員可以修改該術語

  資訊備註

  此作業有三種狀態：

  • draft：術語處於草稿狀態。

  • verified：術語已由管理員驗證。

  • deprecated：術語已棄用，不應使用。

  狀態名稱區分大小寫，且必須完全如上提供。

• Qlik_get_glossary_term_links：取得連結至詞彙表術語的資源

  此函數支援兩種模式：

  • 單一連結模式：提供個別參數，例如 resource_id 或 resource_type。

  • 批次模式：透過 'links' 參數提供連結字典清單

  資訊備註

  連結至子資源時，必須為每個連結一起提供所有三個子資源欄位 (subResourceId、subResourceName 和 subResourceType)。

• Qlik_create_glossary_term_links：將術語連結至應用程式、資料集、欄位、主項目

提示範例：

「協助我為我們的銷售網域建置和治理商業詞彙表。建立名為『Sales Glossary』的詞彙表，新增類別『Revenue』、『Customers』和『Pipeline』。然後為『Annual Recurring Revenue (ARR)』和『Customer Churn』建立術語，並提供明確的定義和標籤 (例如 finance 和 sales-ops)，將它們設定為草稿，並將每個術語連結至相關的資料集欄位和 KPI 主項目。」

資料集與資料品質

這些工具可透過檢查資料集是什麼 (中繼資料和資料產品成員資格)、它包含什麼 (結構描述)、資料看起來如何 (分析統計資料-分佈和快速的列樣本)，協助使用者了解、驗證和治理資料集。這些工具也支援管理工作流程：改善資料集文件 (名稱-描述)，以及觸發和監控資料品質計算，以隨著時間重新整理品質指標。

提供下列工具：

• Qlik_get_dataset：載入資料集的中繼資料，包括信任分數

• Qlik_get_dataset_schema：載入資料集的結構描述 (欄定義)

• Qlik_get_dataset_profile：載入資料集的設定檔資料 (統計資料、分佈)

• Qlik_get_dataset_sample：載入資料集的前 10 列以進行預覽

• Qlik_get_dataset_freshness：取得資料集的最後更新時間戳記

• Qlik_get_dataset_trust_score：取得資料集的信任分數

• Qlik_get_dataset_memberships：取得資料集的資料產品成員資格

• Qlik_update_dataset_metadata：更新資料集的名稱和描述

• Qlik_update_dataset_quality：要求對資料集進行資料品質計算

• Qlik_get_dataset_quality_computation_status：檢查品質計算的狀態

提示範例：

「評估我們的 Customer Orders 資料集是否已準備好用於新的儀表板。向我顯示其中繼資料和目前的信任分數，確認最後的重新整理時間，並列出它屬於哪些資料產品。然後載入結構描述和 10 列樣本，以對 order_date、customer_id 和 net_amount 等索引鍵欄位進行合理性檢查。執行資料集設定檔以找出遺漏值和異常值，如果品質指標看起來已過時，請觸發資料品質計算並持續檢查工作狀態，直到其完成。 最後，更新資料集描述以記錄已知的限制和建議的用途。」

資料探索與分析

這些工具支援對資料和現有分析內容進行快速和臨時的調查，而不需要使用者永久建置新的視覺化。您可以建立暫時的計算或查詢物件來回答「假設性」問題，透過列出相異值或搜尋特定值來檢查欄位。

提供下列工具：

• Qlik_create_data_object：為臨時分析查詢建立暫時的計算物件

  資訊備註

  在套用選取項目之前，請使用 get_field_values() 或 search_field_values() 來驗證值是否存在。

  警告備註

  Qlik 執行所有計算，因此：

  • 切勿對傳回的資料進行彙總、加總、平均或計算：值是最終的。

  • 對於不同的計算，請使用新的運算式再次呼叫工具。

  • 一律套用適當的篩選-選取項目以限制資料大小並改善效能。

• Qlik_get_field_values：取得特定欄位的相異值 (在篩選之前使用)

  資訊備註

  對於高基數欄位，請一律改用 qlik_search_field_values()

  警告備註

  在建立選取項目-篩選之前，請使用此工具或 qlik_search_field_values() 來驗證值是否存在。這有助於避免在套用具有不存在值的篩選時發生錯誤。

• Qlik_search_field_values：跨欄位搜尋特定值 (在集合分析之前驗證)

  警告備註

  在使用集合分析或選取項目建立資料物件之前：請使用 qlik_search_field_values 來驗證值是否存在。這可防止因不存在的篩選值而發生錯誤，這對於：年份、日期、貨幣代碼、產品名稱特別重要。

  最佳實務範例工作流程：

  1. qlik_search_field_values(fieldName="payment_year", searchTerms=["2022"])

  2. 驗證結果中存在 "2022"

  3. 使用 {payment_year={2022} 建立資料物件。

• Qlik_get_chart_data：從現有的圖視覺化中擷取分頁資料

• Qlik_get_chart_info：取得有關圖的中繼資料，而不擷取其資料

提示範例：

「協助我調查為什麼上個月 North 地區的收入下降。首先，檢查現有的『Revenue by Region』圖：向我顯示其中繼資料 (維度、量值、篩選、列數)，然後提取過去兩個月的圖資料。在我套用任何選取項目之前，列出 Region 的相異值並搜尋欄位值，以確認是使用『North』、『NORTH』還是『Northern』。然後建立暫時的計算，以比較 North 與其他地區的月增率收入和利潤，並反白顯示哪些產品類別對變化的貢獻最大。」

資料產品

這些工具將資料產品作為受治理、可共用的資料集套件來管理其完整生命週期：

1. 建立它。

2. 檢查其中繼資料和文件。

3. 維護其定義 (名稱、描述以及它包含哪些資料集)

4. 透過在空間之間移動它並將其啟動或停用，來控制它在何處可用以及是否可用。

它們也支援生命週期結束的清理，在不再需要資料產品時將其刪除。

提供下列工具：

• Qlik_create_data_product：建立新的資料產品

• Qlik_get_data_product：取得特定資料產品的中繼資料

• Qlik_get_data_product_documentation：取得資料產品的 Markdown 文件

• Qlik_update_data_product：更新資料產品的屬性 (名稱、描述、資料集)

• Qlik_update_data_product_space：將資料產品移動到不同的空間

• Qlik_update_activate_data_product：在特定空間中啟動資料產品

• Qlik_update_deactivate_data_product：停用資料產品

• Qlik_delete_data_product：刪除資料產品

提示範例：

「建立名為『Sales Analytics – Curated』的資料產品，並提供明確的描述，且包含這些資料集：Orders、Customers 和 Products。然後向我顯示資料產品中繼資料並提取其 Markdown 文件，以便我可以檢閱消費者將看到的內容。更新描述以新增使用指引，並同時新增 Returns 資料集。將資料產品移動到我們的共用『Analytics』空間，在那裡啟動它以獲得更廣泛的存取權，如果我們稍後將其替換為新版本，請停用舊版本。最後，如果該產品已完全淘汰且不再被參考，請將其刪除。」

譜系

此工具可讓使用者透過擷取資料集或應用程式的上游譜系，來追蹤資料的來源和流向。因為每次呼叫只會往回傳回一個步驟，所以您通常會遞迴重複呼叫以建置完整的鏈結。這對於以下情況很有用：

• 影響分析。

• 疑難排解非預期的數字。

• 治理或稽核。

• 識別提供報告或資料集的真實來源。

提供下列工具：

• Qlik_get_lineage：載入資料集或應用程式的譜系歷程記錄 (遞迴呼叫以取得完整鏈結)

提示範例：

「向我顯示 Customer Orders 資料集的完整上游譜系。從資料集開始，遞迴往回追溯，直到到達原始來源系統。對於每個步驟，總結直接父項是什麼，並注意涉及的任何關鍵轉換或中繼資料集或應用程式。然後告訴我，如果發生變更，哪個上游來源最有可能影響 net_amount 欄位。」

主項目 (維度與量值)

這些工具可透過使用主 (物件庫) 維度和量值，協助使用者在應用程式中標準化和重複使用關鍵商業邏輯。您可以盤點已可用的內容 (以避免複製並鼓勵一致性)，並且可以建立新的可重複使用維度和量值，以便跨多個工作表的圖使用相同的欄位定義和計算運算式，從而改善治理、可維護性和指標對齊。

您可以使用新定義更新您的主項目，以進行快速微調。您也可以刪除主項目。例如，您可以要求您的 LLM 用戶端清理應用程式中未使用的任何主項目。

提供下列工具：

• Qlik_list_dimensionst：列出應用程式中可用的所有物件庫維度

• Qlik_create_dimension：建立可重複使用的物件庫維度

• Qlik_update_dimension：更新 Qlik 應用程式中現有的物件庫維度

• Qlik_delete_dimension：從 Qlik 應用程式中刪除物件庫維度

• Qlik_list_measures：列出應用程式中可用的所有物件庫量值

• Qlik_create_measure：建立具有運算式的可重複使用物件庫量值

• Qlik_update_measure：更新 Qlik 應用程式中現有的物件庫量值

• Qlik_delete_measure：從 Qlik 應用程式中刪除物件庫量值

提示範例：

「協助我標準化我們的 Sales Performance 應用程式中的指標。首先，列出現有的物件庫維度和量值，這樣我們就不會複製任何內容。然後根據適當的區段欄位建立新的物件庫維度『Customer Segment』，並使用我們的標準定義 (毛利除以收入，格式化為百分比) 建立可重複使用的量值『Gross Margin %』。建立它們之後，告訴我在建置圖時應該參考的確切主項目名稱，以便所有儀表板都使用相同的邏輯。」

選取與篩選

這些工具控制 Qlik 應用程式的互動式篩選狀態：

• 將選取項目套用至一個或多個欄位 (使用確切值或模式-述詞樣式比對)。

• 檢查目前有哪些篩選為作用中。

• 全域或針對特定欄位清除選取項目。

它們共同支援引導式分析流程、可重現的調查步驟。

提供下列工具：

• Qlik_select_values：將選取項目 (篩選) 套用至欄位 - 支援確切值和模式比對

  資訊備註

  何時使用選取項目而非集合分析：

  • 當您想要為多個後續作業篩選整個應用程式或工作階段時，請使用 select_values()。

  • 當您需要針對特定計算進行一次性篩選時，請在運算式中使用集合分析

  選取項目會在所有作業中持續存在，直到被清除為止，它們會影響所有後續的資料擷取。作為最佳實務，對於單一分析查詢，請優先使用集合分析而非選取項目，以避免狀態管理額外負荷。

  警告備註

  • 請先使用 qlik_get_field_values() 或 qlik_search_field_values() 來驗證您要選取的值是否存在。選取不存在的值將會以無訊息方式失敗。

  • 傳回的選取項目是實際目前套用的選取項目，且為真實情況。任何選取失敗的欄位 (例如：值不存在的欄位) 都不會出現在傳回的清單中。

• Qlik_clear_selections：清除選取項目 - 全部或特定欄位

  警告備註傳回的選取項目是實際目前套用的選取項目，且為真實情況。任何選取失敗的欄位 (例如，值不存在)，都不會出現在傳回的清單中。

• Qlik_get_current_selections：取得應用程式中目前作用中的選取項目或篩選

提示範例：

「為 Executive Sales 應用程式設定我的分析內容：選取 Year = 2025 和 Region = EMEA，並在 Product Category 上套用以模式為基礎的選取項目，以僅包含以『Cloud』開頭的類別。然後向我顯示目前的選取項目，以便我可以確認哪些是作用中。在我檢閱 KPI 之後，僅清除 Product Category 選取項目 (保留 Year 和 Region)，最後清除所有選取項目，將應用程式重設回未篩選的狀態。」

視覺化與工作表

這些工具可讓使用者在 Qlik 應用程式中組合儀表板：

• 建立新的工作表作為畫布。

• 新增設定了維度、量值和顯示選項的視覺化 (圖、表格、KPI)。

• 在工作表上放置篩選面板，以便使用者可以互動式地切片分析。

它們共同涵蓋了建置可用、自助式儀表板頁面的基本工作流程。

提供下列工具：

• Qlik_create_sheet：在應用程式中建立新的空白工作表 (儀表板)

• Qlik_add_chart：將視覺化 (長條圖、折線圖、圓餅圖、表格、KPI 等) 新增至工作表

  資訊備註

  • 在進行工具呼叫之前規劃您的查詢結構。

  • 先使用 qlik_search_field_values 或 qlik_get_field_values 測試日期值是否存在

  • 對於一次性查詢，請使用集合分析而非應用程式層級的選取項目

• Qlik_add_filter：將篩選面板新增至工作表以進行使用者驅動的篩選

提示範例：

「在我們的分析應用程式中建立名為『Sales Overview』的新工作表。新增 Total Revenue 和 Total Orders 的 KPI、顯示 Revenue by Month 的折線圖，以及顯示 Revenue by Region 的長條圖 (遞減排序)。然後新增包含 Year、Region 和 Product Category 的篩選面板，以便使用者可以調整檢視。確保視覺效果的標題清晰，且工作表已準備好供高階主管對象使用。」