Looker 数据应用概览和设置

Looker 数据应用 是自由格式的画布信息中心，由本地 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 托管的实例，该实例运行的是 Looker 26.18 或更高版本。
  • Looker 管理员必须在管理控制台 面板中的常规 > 预览版 下启用 Data Apps 预览版切换开关。如需了解详情，请参阅 预览版功能文档页面。
  • 用户的浏览器必须具有对 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 才能呈现数据应用。
  • PDF 导出：不支持将数据应用下载为 PDF。
  • 定时传送：不支持设置自动时间表以使用电子邮件发送数据应用的 PDF 快照 。

安装开发者工具

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

运行安装脚本

在有权访问 AI 编码代理的机器上打开终端，然后运行以下命令：

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

配置设置选项

在安装过程中，请响应互动式提示：

  1. 安装目录：输入您要存储 数据应用项目的本地路径，或按 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 编码代理

在终端中，前往数据应用安装目录 (~/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），以查看您创建的所有本地应用的图库。

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

与 AI 智能体对话，以优化布局、样式和互动：

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

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

如果您对设计感到满意，请提示代理部署应用：

Publish this app to Looker.

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

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

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

建议尝试的事项

如需在预览期间探索 Looker 数据应用的功能，请尝试以下场景：

根据图片复制现有报告

将其他 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 卡片。
  • 在宽数据网格旁边添加多列高管摘要边栏。
  • 应用自定义企业品牌、字体样式和背景渐变。

加入丰富的互动式界面组件

要求代理添加互动式 Web 元素：

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

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

充分利用内置组件库：

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

测试 Looker 平台功能

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