概览
Tableau 的 VizQL Data Service(简称 VDS)为开发人员提供了对其 Tableau 已发布数据源的程序化访问,允许他们将其业务语义扩展到任何自定义工作负载或应用程序,包括 AI 代理。simple_datasource_qa 工具将 VDS 添加到 LangChain 框架。本笔记本向您展示如何使用它来构建基于企业语义模型回答分析问题的代理。 请关注 tableau-langchain 项目,更多工具即将推出!设置
请确保您正在运行并可以访问:- Python 3.12.2 或更高版本
- 至少有一个已发布数据源的 Tableau Cloud 或 Server 环境
凭据
您可以像本文档中所示的多种情况一样,明确声明您的环境变量。但是,如果未提供这些参数,simple_datasource_qa 工具将尝试自动从环境变量中读取它们。 对于您选择查询的数据源,请确保您已更新 Tableau 中的 VizqlDataApiAccess 权限,以允许 VDS API 通过 REST 访问该数据源。更多信息请参见此处。认证变量
您可以像此教程中所示的多种情况一样,明确声明您的环境变量。但是,如果未提供这些参数,simple_datasource_qa 工具将尝试自动从环境变量中读取它们。 对于您选择的数据源,请确保您已更新 Tableau 中的 VizqlDataApiAccess 权限,以允许 VDS API 通过 REST 访问该数据源。更多信息请参见此处。实例化
initialize_simple_datasource_qa 初始化一个名为 simple_datasource_qa 的 LangGraph 工具,可用于对 Tableau 数据源进行分析性问答。 此初始化函数:- 使用 Tableau 的连接应用框架进行基于 JWT 的身份验证,登录 Tableau。所有必需变量必须在运行时或作为环境变量定义。
- 异步查询 datasource_luid 变量中指定的目标数据源的字段元数据。
- 根据目标数据源的元数据,将自然语言问题转换为进行 VDS 查询数据源请求所需的 JSON 格式查询负载。
- 执行对 VDS 的 POST 请求。
- 以结构化响应格式化并返回结果。
调用 - LangGraph 示例
首先,我们将初始化我们选择的 LLM。然后,我们使用 LangGraph 代理构造函数类定义一个代理,并使用与目标数据源相关的查询来调用它。链接
待办事项。API 参考
待办事项。以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。