Tableau

本笔记本概述了 Tableau 的入门指南。

概述

Tableau 的 VizQL 数据服务（又名 VDS）为开发人员提供了对其 Tableau 已发布数据源的编程访问权限，使他们能够为任何自定义工作负载或应用程序（包括 AI 代理）扩展其业务语义。“simple_datasource_qa”工具将 VDS 添加到 Langchain 框架。 本笔记本向您展示如何使用它来构建代理，以根据您的企业语义模型回答分析问题。

关注 tableau-langchain 项目，了解更多即将推出的工具！

设置

请确保您正在运行并有权访问

1. python 版本 3.12.2 或更高版本
2. 至少包含 1 个已发布数据源的 Tableau Cloud 或 Server 环境

首先安装和/或导入所需的软件包

# %pip install langchain-openai

# %pip install langgraph

# %pip install langchain-tableau --upgrade

Requirement already satisfied: regex>=2022.1.18 in /Users/joe.constantino/.pyenv/versions/3.12.2/lib/python3.12/site-packages (from tiktoken<1,>=0.7->langchain-openai->langchain-tableau) (2024.11.6)
Requirement already satisfied: httpcore==1.* in /Users/joe.constantino/.pyenv/versions/3.12.2/lib/python3.12/site-packages (from httpx>=0.25.2->langgraph-sdk<0.2.0,>=0.1.42->langgraph->langchain-tableau) (1.0.7)
Requirement already satisfied: h11<0.15,>=0.13 in /Users/joe.constantino/.pyenv/versions/3.12.2/lib/python3.12/site-packages (from httpcore==1.*->httpx>=0.25.2->langgraph-sdk<0.2.0,>=0.1.42->langgraph->langchain-tableau) (0.14.0)

注意：您可能需要重启内核才能使用更新的软件包

凭据

您可以显式声明您的环境变量，如本文档中的几个示例所示。但是，如果未提供这些参数，“simple_datasource_qa”工具将尝试自动从环境变量中读取它们。

对于您选择查询的数据源，请确保您已在 Tableau 中更新 VizqlDataApiAccess 权限，以允许 VDS API 通过 REST 访问该数据源。更多信息请点击此处。

# langchain package imports
from langchain_openai import ChatOpenAI

# langchain_tableau and langgraph imports
from langchain_tableau.tools.simple_datasource_qa import initialize_simple_datasource_qa
from langgraph.prebuilt import create_react_agent

API 参考:ChatOpenAI | create_react_agent

身份验证变量

您可以显式声明您的环境变量，如本 cookbook 中的几个示例所示。但是，如果未提供这些参数，“simple_datasource_qa”工具将尝试自动从环境变量中读取它们。

对于您选择的数据源，请确保您已在 Tableau 中更新 VizqlDataApiAccess 权限，以允许 VDS API 通过 REST 访问该数据源。更多信息请点击此处。

import os

from dotenv import load_dotenv

load_dotenv()

tableau_server = "https://stage-dataplane2.tableau.sfdc-shbmgi.svc.sfdcfc.net/"  # replace with your Tableau server name
tableau_site = "vizqldataservicestage02"  # replace with your Tableau site
tableau_jwt_client_id = os.getenv(
    "TABLEAU_JWT_CLIENT_ID"
)  # a JWT client ID (obtained through Tableau's admin UI)
tableau_jwt_secret_id = os.getenv(
    "TABLEAU_JWT_SECRET_ID"
)  # a JWT secret ID (obtained through Tableau's admin UI)
tableau_jwt_secret = os.getenv(
    "TABLEAU_JWT_SECRET"
)  # a JWT secret ID (obtained through Tableau's admin UI)
tableau_api_version = "3.21"  # the current Tableau REST API Version
tableau_user = "joe.constantino@salesforce.com"  # replace with the username querying the target Tableau Data Source

# For this cookbook we are connecting to the Superstore dataset that comes by default with every Tableau server
datasource_luid = (
    "0965e61b-a072-43cf-994c-8c6cf526940d"  # the target data source for this Tool
)

# Add variables to control LLM models for the Agent and Tools
os.environ["OPENAI_API_KEY"]  # set an your model API key as an environment variable
tooling_llm_model = "gpt-4o"

实例化

initialize_simple_datasource_qa 初始化名为 simple_datasource_qa 的 Langgraph 工具，该工具可用于 Tableau 数据源上的分析问题和解答。

此初始化函数

1. 使用 Tableau 的连接应用框架进行基于 JWT 的身份验证，从而向 Tableau 进行身份验证。所有必需的变量都必须在运行时或作为环境变量定义。
2. 异步查询 datasource_luid 变量中指定的目标数据源的字段元数据。
3. 基于目标数据源的元数据，将自然语言问题转换为进行 VDS 查询数据源请求所需的 json 格式的查询负载。
4. 向 VDS 执行 POST 请求。
5. 格式化结果并在结构化响应中返回。

# Initalize simple_datasource_qa for querying Tableau Datasources through VDS
analyze_datasource = initialize_simple_datasource_qa(
    domain=tableau_server,
    site=tableau_site,
    jwt_client_id=tableau_jwt_client_id,
    jwt_secret_id=tableau_jwt_secret_id,
    jwt_secret=tableau_jwt_secret,
    tableau_api_version=tableau_api_version,
    tableau_user=tableau_user,
    datasource_luid=datasource_luid,
    tooling_llm_model=tooling_llm_model,
)

# load the List of Tools to be used by the Agent. In this case we will just load our data source Q&A tool.
tools = [analyze_datasource]

调用 - Langgraph 示例

首先，我们将初始化我们选择的 LLM。然后，我们使用 langgraph 代理构造函数类定义一个代理，并使用与目标数据源相关的查询来调用它。

from IPython.display import Markdown, display

model = ChatOpenAI(model="gpt-4o-mini", temperature=0)

tableauAgent = create_react_agent(model, tools)

# Run the agent
messages = tableauAgent.invoke(
    {
        "messages": [
            (
                "human",
                "which states sell the most? Are those the same states with the most profits?",
            )
        ]
    }
)
messages
# display(Markdown(messages['messages'][4].content)) #display a nicely formatted answer for successful generations

以下是根据查询的数据，销售额和利润最高的州的結果

销售额最高的州

1. California: $457,687.63
2. New York: $310,876.27
3. Texas: $170,188.05
4. Washington: $138,641.27
5. Pennsylvania: $116,511.91

利润最高的州

1. California: $76,381.39
2. New York: $74,038.55
3. Washington: $33,402.65
4. Michigan: $24,463.19
5. Virginia: $18,597.95

比较

• California 和 New York 是唯一同时出现在两个列表中的州，表明它们是顶级销售商，也产生了最多的利润。
• Texas 虽然销售额排名第三，但在利润方面却没有进入前五名，这表明尽管销售额很高，但盈利能力可能存在问题。

此分析表明，正如德克萨斯州所示，高销售额并不总是与高利润相关。

链式调用

待办。

API 参考

待办。

相关

• 工具概念指南
• 工具使用指南