您在此处:
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。不是无能 |
| create_file_data_stream | 在一次调用中创建基于文件的数据流及其关联的 DLO。文件上传流的步骤 5。默认也创建 DMO。 |
| delete_connection | 按 ID 永久删除 CDP 数据连接。 |
| generate_presigned_credential | 生成预签名的 S3 PUT URL,用于上传 CSV 或 Excel 文件。文件上传流的步骤 1。 |
| get_connection | 按 ID 检索单个 CDP 数据连接的完整记录。 |
| get_data_stream | 检索数据流的状态和详细信息。run_data_stream 后轮讯,以跟踪摄取进度。 |
| get_upload_connection | 检索该组织的 singleton 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 数据连接是否可访问,及其凭据是否仍有效。 |
仪表板
| 工具/技能 | 描述 |
|---|---|
| add_dashboard_page | 将新页面添加到现有仪表板的布局。内部处理读取-修改-写入。 |
| add_global_filter_to_dashboard | 将全局筛选器小部件添加到由语义模型字段支持的仪表板。内部处理读取-修改-写入。 |
| add_widget_to_dashboard | 将小部件(即文本、筛选器、图像或度量)添加到仪表板,并将其原子性地放在网格上。 |
| 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 | 按 ID 检索单个重用或促销请求。用于轮询生命周期中的状态。 |
| list_promotion_reuse_requests | 使用可选筛选器,枚举当前组织中的重用(或促销)请求。始终将 requestType=reuse 传递给范围结果。 |
查询
| 工具/技能 | 描述 |
|---|---|
| run_query | 对 Data Cloud DLO 和 DMO 执行类似 PostgreSQL 的 Hyper SQL 查询,并返回第一个结果块。 |
| run_semantic_query | 根据 Tableau Next 语义数据模型触发结构化查询,并返回列表式结果。 |
搜索资产
| 工具/技能 | 描述 |
|---|---|
| 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 | 在单个请求中更新一个或多个 Analytics 分类。支持单个或批量分类更新。 |
| 分类答案 | 验证(创建为 VQ)、拒绝不准确或更新一个或多个分类的分类。 |
| create_analytics_utterances | 创建一个或多个 Analytics 话语记录。仅创建问题,没有交互或客服人员响应。 |
| 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 名称删除多个 Analytics 语句。仅删除问题。 |
| 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 名称获取单个 Analytics 完全交互(话语、分类和示例交互)。 |
| get_analytics_utterance | 按 API 名称获取单个 Analytics 话语。仅返回问题文本和元数据。 |
| 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 | 通过可选筛选,检索 Analytics 完全交互(问答对)的分页列表。在一次调用中返回所有模型中的所有问题。 |
| list_semantic_model_calculated_dimensions | 在 SDM 中枚举计算维度(基于公式的分组字段)。 |
| list_semantic_model_calculated_measure | 在 SDM 中枚举计算评测(基于公式的数值字段)。 |
| list_semantic_model_data_objects | 枚举语义模型中定义的数据对象(实体)。 |
| list_semantic_model_dependentencies | 显示语义模型中的定义如何相互依赖。对于给定的模型,返回每个定义(计算维度、计算评测、度量或关系)所依赖的映射。 |
| list_semantic_model_dimensions | 枚举 SDM 中特定数据对象的原始维度。 |
| list_semantic_model_measure | 枚举 SDM 中特定数据对象的原始评测。 |
| list_semantic_model_metrics | 枚举 SDM 中定义的业务度量或 KPI。返回完整的度量定义。 |
| list_semantic_model_parameters | 枚举在语义模型上定义的参数(动态筛选器或范围输入)。 |
| list_semantic_model_relationships | 枚举语义模型中数据对象之间的关系(连接)。 |
| list_semantic_models | 通过可选筛选,枚举对调用者可用的语义数据模型。 |
| run_regression_evaluator | 对给定现有问题运行评估器,该问题具有回答(实际)和预期查询,由用户给定或存储在数据库中。 |
| scan_relationships | 建议语义模型中数据对象之间的关系。识别缺失或隐式关系,以提高客服人员查询的准确性。 |
| scan_likeities | 在语义模型中,列出跨数据对象的相似字段、评测或维度。标识会使客服人员困惑的冗余或不明确字段。 |
| update_analytics_utterance | 按 API 名称更新 Analytics 话语(例如,更新话语文本、模型 API 名称、客服人员类型或源类型)。 |
| update_and_classify_analytics_interaction | 按分类 ID 更新 Analytics 交互与分类记录(例如,更新示例交互数据或客服人员响应)。 |
| 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 和 insightSettings 值。 |
| 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 | 按名称或电子邮件搜索用户和组,以解析共享的 ID。 |
| update_asset_share | 更新资产上现有共享的访问级别(查看者、编辑者或所有者)。 |
可视化
| 工具/技能 | 描述 |
|---|---|
| create_comparative_viz | 按评测创建条形图标记可视化排名实体,并按降序排序。或者,为堆叠条形图添加颜色细分。 |
| create_compositional_viz | 创建圈形饼图可视化,将一个评测按维度(整体的一部分)拆分为切片。 |
| create_ relationship_viz | 创建圆圈标记散点可视化,使用所需的点维度绘制两个评测的对比图。 |
| create_timeseries_viz | 创建线标记可视化,随时间绘制一个评测,并提供可选的颜色细分。 |
| 创建可视化 | 使用自然语言规范从语义模型创建新的可视化。返回具有指定图表类型、字段和样式的渲染可视化。 |
| delete_visualization | 删除 Tableau Next 可视化。此操作是永久性操作,无法撤销,因此请谨慎操作。 |
| edit_visualization | 使用自然语言规范从语义模型创建新的可视化。返回具有指定图表类型、字段和样式的渲染可视化。 |
| get_visualization | 检索单个可视化的完整元数据,包括编码规范和筛选器。 |
| list_visualizations | 枚举当前组织中的可视化或工作表(仅限元数据)。 |
| render_visualization | 使用关键字或条件搜索现有可视化,并返回呈现的结果。在单个操作中合并发现和显示。 |
| show_dashboard | 使用关键字或条件搜索现有仪表板,并返回呈现的结果。在单个操作中合并发现和显示。 |
工作区
| 工具/技能 | 描述 |
|---|---|
| add_workspace_asset | 按资产 ID 和资产类型将现有组织资产添加到工作区。重新添加会静默返回 304 状态。 |
| create_workspace | 在当前组织中创建新的 Tableau Next 工作区。 |
| delete_workspace | 删除工作区。此操作是永久性操作,无法撤销,因此请谨慎操作。级联删除所有创建类型的资产,包括仪表板、可视化和 SDM。 |
| list_workspace_assets | 枚举范围特定工作区的资产,包括仪表板、可视化和语义模型。 |
| list_workspaces | 枚举工作区,或按 ID 获取一个工作区。返回 ID、名称、标签、权限和 URL。 |
| remove_workspace_asset | 从工作区中删除资产引用。这将仅删除链接,而不会删除基础资产。 |
