Qlik MCP 工具

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

存取權限與 Qlik MCP 工具

對 MCP 工具的存取受您的權限控制。您需要在自訂角色中擁有 Qlik MCP: Allowed 權限，才能從您的 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：獲取有關圖的中繼資料，而不擷取其資料

提示範例：

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

資料產品

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

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 的篩選面板，以便使用者調整檢視。確保視覺效果標題清晰，且工作表已準備好供高階主管對象使用。」