在 Tableau Server 中启用 AI 的先决条件

若要针对 Tableau Server 配置和启用 Tableau Agent，您将需要以下各项：

• Tableau Server 管理员角色。Tableau 中的 AI 站点设置是特定于站点的，启用后，所有有权访问该站点的用户都可以使用 AI 功能。

• 活动 LLM 提供商帐户或自定义网关端点。根据我们的身份验证方法，包含 API 密钥、端点 URL 或 OAuth 凭据的主动部署

• 您的 API 密钥。在使用 API 密钥身份验证模式时，您将需要此密钥以将 Tableau Server 连接到您的 OpenAI、Azure OpenAI LLM 提供商或自定义网关。我们建议遵循标准安全最佳实践并定期轮换 API 密钥。

• 如果你使用的是 Azure OpenAI，需要已在 Azure 中部署聊天/补全模型和嵌入模型。

• 您希望 Tableau Agent 用于完成任务（如理解用户请求并返回相关输出）的 LLM模 型。从版本 2026.3 开始，如果使用 OpenAI 直接连接，您可以接受建议的默认值。您也可以选择自己的模型。如果使用 Azure OpenAI 或自定义网关连接，您需要选择模型。

  Tableau 建议使用以下模型以获得最佳结果：

  • 理解用户请求（小型/快速任务模型）：gpt-4o-mini 或更高版本

  • 执行分析任务（复杂推理或大型模型）：gpt-4o 或更高版本，或者 Claude Sonnet 4.6 或更高版本

  • 处理数据上下文（嵌入模型）：text-embedding-3-small 或 LLM 提供商支持的类似小型嵌入模型。

• 如果您将转发代理与 Tableau Server 一起使用，则需要将其配置为与 LLM 通信。有关详细信息，请参见下面的配置转发代理。

支持的连接

可用功能

Tableau Server 中提供了以下 Tableau 中的 AI 功能：

• Tableau Web 制作：使用对话式 UI 为您构建可视化项或完成任务：使用户能够在 Tableau Server Web 制作和 Tableau Desktop（版本 2025.3 及更高版本）中的 Tableau Agent 的帮助下探索数据、创建可视化项和计算，以及发现见解。有关 Tableau Agent 的详细信息，请参见使用 Tableau Agent 探索您的数据(链接在新窗口中打开)。

• 仪表板中的 Tableau Agent（测试版）：需要 Tableau Server+。如果将自定义网关与 OAuth 身份验证结合使用，则不可用。您必须选择加入测试版才能启用此功能。使仪表板使用者和作者能够快速概览其仪表板或深入了解其仪表板中的可视化项。他们还可以使用仪表板问答来询问有关其数据的问题。作为仪表板作者，您可以在仪表板级别打开或关闭每个功能。您还可以配置仪表板见解以包括或排除某些工作表，或仅关注某些类型的见解。有关详细信息，请参见仪表板中的 Tableau Agent（测试版）(链接在新窗口中打开)。

  注意：仪表板中的 Tableau Agent 要求用户对他们想要使用 Tableau Agent 的所有工作簿具有“AI 访问”和“完整数据查询”权限能力。“完整数据查询”权限可确保 Tableau Agent 能够访问运行所需的基础数据。有关详细信息，请参见“权限”(链接在新窗口中打开)。

• Tableau Prep 中的 Tableau Agent：建议清理和转换数据的步骤：使用户能够在 Tableau Agent 的帮助下清理数据、创建计算字段和构建流程。Tableau Server 的 Tableau Prep Web 制作和 Tableau Prep Builder（版本 2025.3 及更高版本）中提供了此功能。有关 Tableau Prep 中的 Tableau Agent 的详细信息，请参见使用 Tableau Agent 构建 Tableau Prep 流程(链接在新窗口中打开)。

配置 Tableau 中的 AI

根据您选择的 LLM 提供商，配置 Tableau 中的 AI 的步骤和您需要输入的信息会有所不同。支持为每个站点配置不同的 LLM 提供商。

步骤 1：连接到 LLM 提供商或自定义网关

1. 以服务器管理员身份登录到 Tableau Server。

2. 在要启用生成式 AI 功能的站点上，选择“设置”。

3. 在“Tableau 中的 AI”下，单击“连接”。

   

4. 在“连接到 LLM” 对话框中，从 LLM 提供商下拉列表中选择您的提供商。

   

5. 根据您的选择，请执行以下操作：

   • OpenAI：输入您的 API 密钥。

   • Azure OpenAI：输入您的 API 密钥 和资源名称。

   • 自定义网关（测试版）：接受免责声明以选择加入测试版。

     • 输入自定义网关 URL （示例：https://gateway.example.com/v1）。

     • 选择“身份验证模式”。

       • 无身份验证：选择何时通过内部网络规则（例如，IP 白名单或 VPC/VPN 边界）保护网关。

       • API 密钥：输入您的内部 API 网关所需的令牌/密钥。

       • Oauth：：提供所需的 OAuth 客户端详细信息：

         • 客户端 ID 和客户端密文：身份提供程序生成的应用程序凭据。

         • 重定向 URL：Tableau Server 所需的回调端点。输入以 /auth/add_oauth_token 结尾的有效 URL（例如：https://<your-server-name>/auth/add_oauth_token）。如果使用 HTTP 而不是 HTTPS，则域名必须为 localhost。

         • OAuth 配置文件：上载为 IDP 配置的自定义 XML 配置文件。有关详细信息，请参见 Tableau 连接器 SDK 中的XML 元素(链接在新窗口中打开)。

6. 单击“连接”。

步骤 2：配置模型设置

如果使用 OpenAI，请选择推荐的模型（默认情况下已选择），然后单击“应用”。Tableau 建议使用这些模型以获得最佳性能。每当 Tableau 更改推荐模型时，模型都会自动更新。

如果您使用的是 Azure OpenAI 或自定义网关，则需要选择模型。对于 Azure OpenAI，必须首先部署和命名您选择的模型。无论您为部署的模型使用什么名称，都与您在模型字段中键入的名称相同。然后，您可以在字段中输入该名称。

您还必须维护手动选择的模型，并在不再支持模型时更新设置，以避免用户失去对 Tableau Agent 的访问权限。

1. 单击“编辑模型”。

2. 在“模型设置”对话框中，选择或输入 LLM 主机或网关提供的特定模型 ID：

   • 了解用户请求：选择或输入小型模型标识符（例如，gpt-4o-mini 或更高版本）。

   • 创建可视化项、计算字段和构建流程：选择或输入主要推理模型标识符（例如，gpt-4o 或 claude Sonnet 4.6）。

   • 流程数据上下文：选择或输入嵌入模型标识符（例如，text-embedding-3-small）。

     

3. 单击“应用”。

步骤 3：为用户启用 AI 功能

注意：仪表板中的 Tableau Agent 需要 Tableau Server 版本 2026.3 或更高版本、Tableau Server+，如果使用带有 OAuth 身份验证的自定义网关，则不可用。

1. 在“按功能划分的 AI 设置”下，为您希望在此站点上向用户提供的每项功能（Web 制作中的 Tableau Agent、Tableau Prep 中的 Tableau Agent、仪表板中的 Tableau Agent（测试版））单击“启用”。

2. 单击“设置”页面顶部的“保存”。

   

最终用户身份验证体验（OAuth 网关）

使用 OAuth 配置自定义网关时，将提示访问 Tableau Agent 的最终用户登录 LLM 网关并允许访问 Tableau Agent。

1. 在工作簿或制作会话中打开 Tableau Agent 时，键入问题后，智能体窗格将显示“登录到 LLM 网关”。

2. 单击“登录”在单独的浏览器窗口中打开组织的 OAuth/身份提供程序登录屏幕。

3. 通过身份验证后，用户将被重定向回 Tableau，并且可以与 Tableau Agent 交互。

配置转发代理

如果 Tableau 配置为使用转发代理连接到 Internet，则您可以将 Tableau Server 配置为使用代理主机和端口设置来联系 LLM。

使用命令 tsm configuration set(链接在新窗口中打开) 进行更改。

• 对于 HTTPS 代理主机，请使用以下键值对：

  -k tomcat.https.proxyHost -v host.domain

  -k tomcat.https.proxyPort -v port_number

  例如，如果您的代理服务器位于 https://proxy.example.lan:8443，则运行以下命令：

  tsm configuration set -k tomcat.https.proxyHost -v proxy.example.lan

  tsm configuration set -k tomcat.https.proxyPort -v 8443

  tsm pending-changes apply

  此命令将重新启动 Tableau Server。配置生产环境时请注意这一点。

• 对于 HTTP 代理主机，请使用以下键值对：

  -k tomcat.http.proxyHost -v host.domain

  -k tomcat.http.proxyPort -v port_number

  设置这些键后，运行

  tsm pending-changes apply

  此命令将重新启动 Tableau Server。配置生产环境时请注意这一点。