您位於此處:
Tableau Next MCP Beta 版伺服器工具參照 (Beta 版)
此參照包含 Tableau Next Model Context Protocol (MCP) Server 的 Beta 版工具。每個工具都會依照其種類以字母順序進行組織
連線
| 工具/技能 | 描述 |
|---|---|
| create_data_model_object | 在 Data 360 中建立新的「資料模型物件」(DMO)。雙工具 DMO-from-DLO 流程的 工具 1。 |
| create_data_stream | 針對檔案或資料庫來源,在單一呼叫中建立「資料串流」及其相關聯的 DLO。 |
| create_dlo_to_dmo_mapping | 建立連結 DLO 至 DMO 的 1:1 欄位對應。雙工具 DMO-from-DLO 流程的 工具 2。非 idempotent。 |
| create_file_data_stream | 在單一呼叫中建立檔案型「資料串流」及其相關聯的 DLO。檔案上載流程的步驟 5。預設為也會建立 DMO。 |
| delete_connection | 依識別碼永久刪除 CDP 資料連線。 |
| generate_presigned_credential | 產生預先指定的 S3 PUT URL 以上載 CSV 或 Excel 檔案。檔案上載流程的步驟 1。 |
| get_connection | 依照單一 CDP 資料連線的識別碼,取用單一 CDP 資料連線的完整記錄。 |
| get_data_stream | 取得資料串流的狀態和詳細資料。在 run_data_stream 之後輪詢以追蹤取用進度。 |
| get_upload_connection | 針對此組織的單數 UploadedFiles 連線。檔案上載流程的步驟 3。 |
| infer_file_schema | 從上載的檔案輸入資料欄名稱和資料類型。檔案上載流程的步驟 4。在建立串流前向使用者呈現以進行確認。 |
| list_connections | 列舉組織中指定連接器類型的 CDP 資料連線。 |
| list_data_connection_objects | 列舉連線中可用的物件:Excel 試算表名稱或資料庫表格。 |
| list_file_sheets | 在上載的 Excel 檔案中列舉工作表名稱。當來源為 Excel 時,使用 infer_file_schema 前。 |
| run_data_stream | 將已上載檔案觸發至 DLO。檔案上載流程的步驟 6。串流必須處於「啟用」狀態,您才能呼叫此工具。 |
| test_existing_connection | 測試現有 CDP 資料連線是否可到達,且其認證仍可運作。 |
Dashboard (顯示面板)
| 工具/技能 | 描述 |
|---|---|
| add_dashboard_page | 將新頁面新增至現有顯示面板的版面配置。在內部處理讀/修改/寫。 |
| add_global_filter_to_dashboard | 將全域篩選條件小工具新增至由「語意模型」欄位支援的顯示面板。在內部處理讀/修改/寫。 |
| add_widget_to_dashboard | 將小工具 (viz、文字、篩選、影像或度量) 新增至顯示面板,並以原子方式放置在網格上。 |
| create_dashboard | 在目前組織中建立新的 Tableau Next 顯示面板。 |
| delete_dashboard | 刪除 Tableau Next 顯示面板。此動作是永久的,無法復原,因此請謹慎進行。 |
| get_dashboard | 取得單一顯示面板的完整中繼資料,包括版面配置、小工具、擁有工作區和 URL。 |
| list_dashboards | 列舉 Tableau Next 顯示面板 (僅限中繼資料),以在目前組織中進行探索。 |
| remove_dashboard_page | 依照以 0 為基礎的頁面索引,將頁面 (及其小工具) 從顯示面板中移除。在內部處理讀/修改/寫。 |
| remove_widget_from_dashboard | 以原始方式從顯示面板中移除小工具及其所有版面配置位置。 |
| update_dashboard | 透過取代完整記錄來更新現有顯示面板。先呼叫 get_dashboard,然後以單一 update_dashboard 呼叫傳回完整的小工具與版面配置,包括您的變更。如果您僅傳送變更,則更新只會以這些變更覆寫顯示面板。 |
升級與重複使用
| 工具/技能 | 描述 |
|---|---|
| create_promotion_pull_request | 下載已完成「促銷」要求的中繼資料封裝,並建立提取要求。先決條件:packageExportStatus 欄位必須為「就緒」。 |
| create_reuse_promotion_request | 建立「重複使用」(將生產資產提取至個人組織) 或「促銷」(將個人組織資產封裝至生產組織) 要求。 |
| get_promotion_reuse_request | 依識別碼的單一「重複使用」或「促銷」要求,用於輪詢其生命週期的狀態。 |
| list_promotion_reuse_requests | 使用選用篩選條件列舉目前組織中的「重複使用」(或「促銷」) 要求。一律將 requestType=reuse 傳遞至範圍結果。 |
查詢
| 工具/技能 | 描述 |
|---|---|
| run_query | 針對 Data Cloud DLO 和 DMO 執行類似 PostgreSQL 的 Hyper SQL 查詢,並傳回第一個結果區塊。 |
| run_semantic_query | 針對 Tableau Next Semantic 資料模型觸發結構化查詢,並傳回表格結果。 |
搜尋資產
| 工具/技能 | 描述 |
|---|---|
| browse_data_assets | 依關鍵字或資產類型瀏覽並探索所有類型的資料資產。DLO、DMO、已計算洞察物件 (CIO)、顯示面板、視覺效果、工作區和語意資料模型 (SDM) 的主要探索端點。 |
語意建模
| 工具/技能 | 描述 |
|---|---|
| add_semantic_model_calculated_dimension | 將計算的維度 (衍生的種類 TuA 運算式) 新增至語意模型。 |
| add_semantic_model_calculated_measure | 將計算的度量 (衍生的數值 TuA 運算式) 新增至語意模型。 |
| add_semantic_model_data_object | 將資料物件 (實體或表格—DLO、DMO 或 CIO) 新增至語意模型。偏好 DMO,而非原始 DLO。 |
| add_semantic_model_dimension | 將原始維度 (種類、日期或文字欄) 新增至 SDM 中的資料物件。 |
| add_semantic_model_measure | 將原始度量 (數值彙總欄) 新增至 SDM 中的資料物件。 |
| add_semantic_model_metric | 將業務度量或 KPI 新增至語意模型。timeDimensionReference 是必要的,即使非時間彙總也是如此。 |
| add_semantic_model_parameter | 將參數 (動態篩選輸入) 新增至語意模型。 |
| add_semantic_model_relationship | 在語意模型中新增兩個資料物件之間的關係 (聯結)。joinType 必須為模型層級關係的「自動」。 |
| classify_analytics_interactions | 在單一要求中更新一或多個分析分類。支援單一或批次分類更新。 |
| classify_answer | 驗證 (建立為 VQ)、拒絕為不準確,或更新一或多個分類的分類。 |
| create_analytics_utterances | 建立一或多個分析說話方式記錄。僅建立問題,不包含互動或工作人員回應。 |
| create_semantic_model | 在目前的組織中建立新的 SDM。 |
| create_semantic_model_calculated_dimension | 使用 if-else 邏輯和模型層級欄位參照建立新的衍生分組欄位。 |
| create_semantic_model_calculated_measure | 使用 IIF 邏輯和標準彙總函數在 SDM 中建立新的衍生數值欄位。 |
| create_semantic_model_data_object | 在語意模型內建立新資料物件。使用此工具可將現有的 Data Cloud 物件 (DMO、DLO 或 CIO) 新增為可參與關係、度量和其他語意定義的新實體。 |
| create_semantic_model_logical_view | 在語意模型上建立邏輯檢視 (預先加入、篩選或聯合形式的虛擬表格)。 |
| create_semantic_model_metric | 在語意模型內建立新的業務度量。使用此工具可定義透過篩選條件和其他內容,在特定時間維度上追蹤度量的新度量。 |
| create_semantic_model_relationship | 在語意模型內建立資料物件之間的新關係。使用此工具來定義資料物件之間的聯結條件,以用於查詢和分析。 |
| delete_analytics_utterances | 依其 API 名稱刪除多個分析說話方式。僅刪除問題。 |
| delete_semantic_model | 刪除語意模型及其所有的定義。此動作是永久的,無法復原,因此請謹慎進行。 |
| delete_semantic_model_calculated_dimension | 從 SDM 刪除已計算維度。此動作是永久的,無法復原,因此請謹慎進行。 |
| delete_semantic_model_calculated_measure | 從 SDM 刪除計算的度量。此動作是永久的,無法復原,因此請謹慎進行。 |
| delete_semantic_model_data_object | 從語意模型刪除資料物件。您可以選擇性串聯刪除相依關係。 |
| delete_semantic_model_logical_view | 從語意模型刪除邏輯檢視。 |
| delete_semantic_model_metric | 從 SDM 刪除度量或 KPI。此動作是永久的,無法復原,因此請謹慎進行。 |
| delete_semantic_model_parameter | 從語意模型永久刪除參數。 |
| delete_semantic_model_relationship | 從 SDM 刪除關係 (聯結)。此動作是永久的,無法復原,因此請謹慎進行。 |
| generate_descriptions | 針對缺少欄位、度量或資料物件自動產生人類可讀的描述。增強模型中繼資料,讓工作人員無須手動撰寫即可進一步瞭解欄位語意。 |
| generate_questions | 自動產生語意模型的測試問題,以協助工作人員保持準確性。 |
| get_analytics_full_interaction | 依說話方式 API 名稱取得單一分析完整互動 (範圍、分類和範例互動)。 |
| get_analytics_utterance | 依 API 名稱取得單一分析說話方式。僅傳回問題文字與中繼資料。 |
| get_dlo_to_dmo_mapping_status | 檢查原始資料來源 (DLO) 與已建模業務物件 (DMO) 之間的資料對應狀態。 |
| get_semantic_model | 取得一個語意模型的完整設定檔。傳遞 includeModelContent=true 以取得單一通話中的完整快照。 |
| get_semantic_model_calculated_dimension | 針對特定計算的維度,來取用完整公式和資料類型定義。 |
| get_semantic_model_calculated_measure | 針對數值衍生的欄位 (包括彙總類型) 取得完整的計算詳細資料。 |
| get_semantic_model_data_object | 取得語意模型內特定資料物件的完整定義,包括其中繼資料、欄位、度量和維度。當您需要單一資料物件的完整詳細資料時,請使用此工具。 |
| get_semantic_model_logical_view | 針對 SDM 中的單一邏輯檢視,從結構 (資料物件、聯結和篩選條件) 取得。此工具為唯讀,不存在 create_logical_view 工具。 |
| get_semantic_model_metric | 請在 SDM 中取用一個度量的完整定義或 KPI。 |
| get_semantic_model_relationship | 取得特定關係的完整定義,包括連線的資料物件、聯結條件、基數和其他關係中繼資料。 |
| list_analytics_interactions | 使用選用的篩選條件,取得分析完整互動 (問題與回答配對) 的分頁清單。在單一通話中傳回所有模型之間的所有問題。 |
| list_semantic_model_calculated_dimensions | 在 SDM 中列舉計算的維度 (公式型分組欄位)。 |
| list_semantic_model_calculated_measures | 在 SDM 中列舉計算的度量 (公式型數值欄位)。 |
| list_semantic_model_data_objects | 列舉在語意模型中定義的資料物件 (實體)。 |
| list_semantic_model_dependencies | 顯示語意模型中的定義相互依賴的方式。針對指定的模型,傳回每個定義 (已計算維度、已計算度量、度量或關係) 相依的對應。 |
| list_semantic_model_dimensions | 在 SDM 中列舉特定資料物件的原始維度。 |
| list_semantic_model_measures | 列舉 SDM 中特定資料物件的原始度量。 |
| list_semantic_model_metrics | 列舉在 SDM 中定義的業務度量或 KPI。傳回完整的度量定義。 |
| list_semantic_model_parameters | 列舉在語意模型上定義的參數 (動態篩選條件或範圍輸入)。 |
| list_semantic_model_relationships | 在語意模型中列舉資料物件之間的關係 (聯結)。 |
| list_semantic_models | 列舉來電者可用的語意資料模型,並選擇性篩選。 |
| run_regression_evaluator | 對具有回應 (實際) 和預期查詢 (由使用者提供或儲存在資料庫中) 的指定現有問題執行評估程式。 |
| scan_relationships | 在語意模型中建議資料物件之間的關係。識別遺漏或隱含關係,以改善工作人員查詢的準確性。 |
| scan_similarities | 在語意模型中列出資料物件之間的類似欄位、度量或維度。識別會讓工作人員混淆的冗餘或不明確欄位。 |
| update_analytics_utterance | 依 API 名稱更新分析說話方式 (例如,更新說話方式文字、模型 API 名稱、工作人員類型或來源類型)。 |
| update_and_classify_analytics_interaction | 依分類識別碼更新分析互動與分類記錄 (例如,更新範例互動資料或工作人員回應)。 |
| update_semantic_model | 更新語意模型的模型層級內容,例如標籤、描述、種類或業務偏好設定。此工具不會更新欄位或關係。 |
| update_semantic_model_calculated_dimension | 修改現有已計算維度的公式或中繼資料。 |
| update_semantic_model_calculated_measure | 修改現有已計算度量的運算式或內容。 |
| update_semantic_model_data_object | 更新語意模型內現有資料物件的定義或中繼資料。使用此工具修改單一資料物件的中繼資料、欄位或篩選條件。 |
| update_semantic_model_dimension | 更新資料物件上的維度。這是少量更新。 |
| update_semantic_model_logical_view | 更新邏輯檢視的實體層級內容,例如描述或篩選條件。 |
| update_semantic_model_measure | 更新資料物件上的度量。這是少量更新。 |
| update_semantic_model_metric | 使用完整 PUT 取代更新度量或 KPI。透過每個呼叫重新傳送標籤、measurementReference、timeDimensionReference 和 insightsSettings 值。 |
| update_semantic_model_parameter | 更新語意模型上的參數。這是完整取代,不是部分修補程式。 |
| update_semantic_model_relationship | 更新語意模型內的現有關係,例如聯結定義、基數或中繼資料。 |
共用與存取權
| 工具/技能 | 描述 |
|---|---|
| add_asset_share | 將 Tableau Next 資產的共用授與 (檢視者、編輯者或擁有者) 新增至使用者或群組。 |
| list_asset_shares | 列舉資產的所有共用記錄 (具有存取權的人員和層級)。 |
| remove_asset_share | 移除特定使用者或群組的 Tableau Next 資產存取權。 |
| search_users_and_groups | 依名稱或電子郵件搜尋使用者和群組,以解析共用的識別碼。 |
| update_asset_share | 更新資產上現有共用的存取層級 (檢視者、編輯者或擁有者)。 |
視覺效果
| 工具/技能 | 描述 |
|---|---|
| create_comparative_viz | 依度量建立長條標記視覺效果排名實體,依遞減順序排序。或者新增堆疊長條的色彩細目。 |
| create_compositional_viz | 依維度 (整體的一部分) 建立圓環圖標視覺效果,將一個度量分割成片段。 |
| create_relationship_viz | 建立圓圈標記散點視覺效果,以需要的點數維度彼此繪製兩個度量。 |
| create_timeseries_viz | 使用選用的色彩細目建立線條圖視覺效果,繪製一段時間內的一個度量。 |
| create_visualization | 使用自然語言規格從語意模型建立新的視覺效果。傳回具有指定圖表類型、欄位和樣式的呈現視覺效果。 |
| delete_visualization | 刪除 Tableau Next 視覺效果。此動作是永久的,無法復原,因此請謹慎進行。 |
| edit_visualization | 使用自然語言規格從語意模型建立新的視覺效果。傳回具有指定圖表類型、欄位和樣式的呈現視覺效果。 |
| get_visualization | 取得單一視覺效果的完整中繼資料,包括編碼規格與篩選條件。 |
| list_visualizations | 列舉目前組織的視覺效果或工作表 (僅限中繼資料)。 |
| render_visualization | 使用關鍵字或條件搜尋現有視覺效果,並傳回呈現的結果。在單一作業中結合探索與顯示。 |
| show_dashboard | 使用關鍵字或條件搜尋現有顯示面板,並傳回呈現的結果。在單一作業中結合探索與顯示。 |
工作區
| 工具/技能 | 描述 |
|---|---|
| add_workspace_asset | 依資產識別碼和資產類型將現有組織資產新增至工作區。「重新新增」會無訊息傳回 304 狀態。 |
| create_workspace | 在目前組織中建立新的 Tableau Next 工作區。 |
| delete_workspace | 刪除工作區。此動作是永久的,無法復原,因此請謹慎進行。串聯刪除所有「建立」類型的資產,包括顯示面板、視覺效果和 SDM。 |
| list_workspace_assets | 列舉範圍至特定工作區的資產,包括顯示面板、視覺效果和語意模型。 |
| list_workspaces | 列舉工作區,或依識別碼提取工作區。傳回識別碼、名稱、標籤、權限和 URL。 |
| remove_workspace_asset | 將資產參照從工作區中移除。這只會移除連結,且不會刪除基本資產。 |
