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 PDF 下载和预定电子邮件交付。

准备工作

在安装开发者工具和创作数据应用之前，请验证您是否满足以下前提条件：

实例要求

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

所需权限

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

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

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

  • 底层 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 数据应用具有以下限制：

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

安装开发者工具

如需创作数据应用，请在本地开发环境（macOS 或 Linux）中安装开发者工具。

运行安装脚本

在可访问 AI 编码助手的机器上打开终端，然后运行以下命令：

bash <(curl -fsSL https://dl.google.com/looker-data-apps/install.sh)

配置设置选项

在安装过程中，回答互动式提示：

  1. 安装目录：输入要存储 Data Apps 项目的本地路径，或按 Enter 接受默认路径 (~/looker-data-apps)。
  2. Looker 实例网址：输入您的 Looker 实例网址，例如 https://myinstance.looker.com。
  3. Looker API client_id：输入您的客户端 ID。
  4. Looker API client_secret：输入您的客户端密钥（以仅限所有者的文件权限本地保存到 data-apps-config.json）。
  5. 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 Explore、编写组件定义，并启动本地预览服务器。

第 3 步：检查本地预览

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

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

第 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 工作流集成：

  • 交叉过滤：配置图表，以便在一个图表中选择某个类别后，过滤其余的可视化图表。
  • PDF 导出：将整个信息中心下载为 PDF 文件。
  • 定时发送：设置自动发送时间表，以便通过电子邮件将数据应用的 PDF 快照发送给您的团队。