Looker Data Apps 概览和设置

Looker Data Apps 是自由形式的画布信息中心,由本地 AI 编码智能体(例如 Gemini CLI、Claude Code 或 Cursor)根据自然语言提示构建。数据应用让您能够完全控制可视化布局(包括绝对定位、重叠元素和自定义 Web 组件),同时仍受 Looker 的受管控 LookML 语义层和用户权限的约束。

构建数据应用时,AI 编码代理会在您的本地机器上运行,以生成应用代码。将数据应用发布到 Looker 后,用户打开信息中心或与之互动时,不会涉及 AI 模型。

Looker 数据应用概览

数据应用是一种 Looker 扩展程序,由 Looker 扩展程序框架提供支持,并在单元素用户定义的信息中心 (UDD) 内运行。

主要功能包括:

  • AI 辅助编写,零运行时 AI:您在计算机上使用 AI 编码智能体,根据提示生成布局和组件代码。已发布的数据应用在 Looker 中作为标准 Web 组件运行,当用户查看信息中心时,不会调用任何 AI 模型。
  • 网络隔离沙盒:由于 AI 智能体会编写应用代码,因此 Looker 会在隔离的浏览器沙盒中运行每个数据应用,该沙盒会阻止出站网络连接。应用代码只能与 Looker 实例通信,因此查询结果和用户凭据无法发送到外部服务器。
  • 受治理的数据访问:数据应用仅通过 Looker 的 LookML 语义层查询数据。每个查询都会在查看用户的 Looker 权限、模型访问权限和行级访问权限过滤条件下运行。
  • 互动式控件:数据应用包含内置的互动式过滤条件、交叉过滤和应用内深入分析视图。

准备工作

在安装开发者工具和编写数据应用之前,请验证您是否满足以下前提条件:

实例要求

  • 您必须使用运行 Looker 26.18 或更高版本的 Looker 托管实例。
  • Looker 管理员必须在管理控制台面板中的常规 > 预览版下启用数据应用预览版切换开关。如需了解详情,请参阅预览版功能文档页面。
  • 用户的浏览器必须具有对 www.gstatic.com 的网络访问权限,才能加载 Data Apps 运行时库。

所需权限

如需创建和发布数据应用,您必须具备以下条件:

如需查看已发布的数据应用,您的用户必须具备以下条件:

  • 对目标文件夹的查看访问权限级别

  • 底层 LookML 模型的 access_data、explore 和 see_user_dashboards Looker 权限

Looker API 凭证

您的开发者工具使用 Looker API 访问 Looker 实例。如需向开发者工具授予对 Looker API 的访问权限,您需要一个 API 密钥,该密钥由客户端 ID 和客户端密钥组成。在配置设置选项时,您需要向开发者工具提供客户端 ID 和客户端密钥。

如需检索 API 密钥,请按以下步骤操作:

  1. 您的 Looker 管理员必须在管理 > 用户页面中为您的用户账号启用 API 密钥。
  2. 在 Looker 中,前往用户账号页面。
  3. 在身份验证部分中,点击 API 密钥标题旁边的管理。
  4. 在 API 密钥页面中,您可以查看现有 API 密钥或创建新的 API 密钥。
  5. 复制所选 API 密钥的客户端 ID 和客户端密钥。

文件夹标识符

确定要发布数据应用的 Looker 文件夹的数字 ID。在 Looker 中,打开目标文件夹(例如共享或我的文件夹),并记下网址末尾的数字:

https://LOOKER_INSTANCE_URL/folders/FOLDER_ID

限制

Looker Data Apps 存在以下限制:

  • 嵌入、主题设置和打印:数据应用不支持嵌入、内部信息中心主题或打印。不过,您可以通过提示 AI 编码智能体,直接在数据应用中自定义视觉样式。
  • 复制数据应用:避免在 Looker 中复制数据应用。由于副本引用的是同一个底层应用,因此对一个副本所做的更改会反映在所有副本中。
  • LookML 导出和导入:不支持以 LookML 形式导出数据应用,也不支持从 LookML 导入数据应用。
  • 依赖于 www.gstatic.com:数据应用需要通过网络访问 www.gstatic.com 才能加载运行时和组件库。用户的浏览器必须能够访问 www.gstatic.com 才能呈现数据应用。
  • PDF 导出:不支持将数据应用下载为 PDF。
  • 定期发送:不支持设置自动时间表,以通过电子邮件发送数据应用的 PDF 快照。

安装开发者工具

如需编写数据应用,请在本地开发环境中安装开发者工具。

运行安装脚本

在有权访问 AI 编码智能体的机器上打开终端,然后运行适用于您的操作系统的命令:

  • macOS 或 Linux:

    bash <(curl -fsSL https://dl.google.com/looker-data-apps/install.sh)
    
  • Windows:(cmd.exe 或 PowerShell)或跨平台 Python:

    curl.exe -fsSL https://dl.google.com/looker-data-apps/install.py | python
    

配置设置选项

在安装过程中,请响应交互式提示:

  1. 安装目录:输入要存储 Data Apps 项目的本地路径,或按 Enter 接受默认路径 (~/looker-data-apps)。
  2. Looker 实例网址:输入 Looker 实例网址,例如 https://myinstance.looker.com。
  3. Looker API client_id 和 client_secret:输入您的客户端 ID 和客户端密钥(在本地保存到 data-apps-config.json,仅限所有者访问)。
  4. Looker 文件夹 ID:输入您在文件夹标识符中标识的目标文件夹 ID,或按 Enter 接受默认文件夹,即文件夹 1(共享文件夹)。

完成提示后,安装程序会自动运行四步验证检查,以确认您的凭据有效,并且您的 Looker 实例可以存储和提供数据应用。

编写、预览和发布数据应用

按照以下工作流程,使用 AI 编码智能体创建数据应用:

第 1 步:启动 AI 编码智能体

在终端中,前往 Data Apps 安装目录 (~/looker-data-apps),然后启动 AI 编码智能体。

第 2 步:提示代理生成数据应用

使用自然语言编写提示,让代理构建应用。您的应用必须基于现有的探索和视图,但您无需使用技术标识符。例如:

Build a responsive Looker Data App using the faa model and the
large\_flight\_data explore. I want this to be a dynamic, dark-themed operations
center.

Please include the following components:

The Map (Centerpiece): Create a custom visual that visualizes flights moving
from their Origin to Destination. Include a timeline slider (or playback
animation) based on Departure Time and Arrival Time so I can watch the flights
move over time.

KPI Strip: Across the top, include a row of KPI cards showing the total flight
Count, average Delay Mins, total Total Revenue, and average Load Factor.

Trend Chart: Include a line chart showing how Carbon Emissions and Total Revenue change over
the Departure Date periods.

Interactive Filters: Include drop-down filters for Airline, Status, and Origin
that wire into the charts and map to update the data dynamically.

AI 智能体会检查您的 LookML 探索,编写组件定义,并启动本地预览服务器。

第 3 步:检查本地预览

打开代理提供的本地预览网址 (http://localhost:8765)。

您还可以在终端中运行 make start(或 python3 skills/data-app-previewer/tools/start-preview.py),查看您创建的所有本地应用的图库。

在 Windows 上,如果 python3 不在 PATH 上,请在显示 python3 的任何位置使用 python 或 py -3。

第 4 步:以迭代方式优化应用

与 AI 智能体对话,优化布局、样式和互动:

  • “将 3 张指标卡片与画布右侧对齐。”
  • “在趋势图上方添加一个日期范围滑块。”
  • “将背景改为柔和的中性灰色,并添加带有柔和阴影的圆角卡片。”

第 5 步:将数据应用发布到 Looker

当您对设计感到满意时,请提示代理部署应用:

Publish this app to Looker.

代理会运行发布脚本,该脚本会打包组件脚本,并在您配置的文件夹中创建或更新信息中心对象。

第 6 步:在 Looker 中查看数据应用

点击代理返回的 Looker 链接。您的数据应用会在 Looker 中加载,并全面支持用户访问权限过滤条件、文件夹共享和平台功能。

建议尝试的操作

如需在预览期间探索 Looker Data Apps 的功能,请尝试以下场景:

复制图片中的现有报告

将其他 BI 工具(例如 Tableau 或 Power BI)中的现有报告的屏幕截图或演示文稿上传到 AI 智能体。向智能体输入提示:

Replicate the layout, visual hierarchy, and color scheme shown in this
screenshot, binding the charts to our customer_analytics explore.

多模态 AI 智能体可以从图片中提取坐标几何图形、排版和调色板,以生成匹配的数据应用布局。

设计自定义布局

通过创建非对称布局,突破标准矩形网格的限制:

  • 创建与主打横幅部分重叠的悬浮 KPI 卡片。
  • 在宽数据网格旁边添加多列摘要边栏。
  • 应用自定义企业品牌、字体样式和背景渐变。

整合丰富的互动式界面组件

让智能体添加互动式网页元素:

  • 标签页式导航:在多个标签页中整理复杂的运营指标,而无需重新加载页面。
  • 模态对话框和抽屉式导航栏:点击指标时,可打开详细的细分视图或词汇表定义。
  • 交互式过滤条件和控件:添加自定义切换按钮、滑块和搜索输入,以动态更新图表系列。

使用高级数据表和可视化图表

利用内置组件库:

  • AG Grid 集成:嵌入支持列排序、列大小调整和单元格格式设置的交互式数据表。
  • 高级 Highcharts 类型:生成标准信息中心图块不支持的仪表、热图、树状图和桑基图。

测试 Looker 平台功能

验证您的数据应用是否与 Looker 流程集成。