Looker Data Apps 總覽與設定

Looker 資料應用程式是由本機 AI 程式設計代理 (例如 Gemini CLI、Claude Code 或 Cursor) 根據自然語言提示詞建構的任意形式畫布資訊主頁。與標準格線資訊主頁不同，資料應用程式可讓您完全掌控視覺版面配置 (包括絕對位置、重疊元素和自訂網頁元件)，同時仍受 Looker 的受管理 LookML 語意層和使用者權限限制。

建構資料應用程式時，AI 程式設計代理程式會在您的本機執行，以生成應用程式程式碼。將資料應用程式發布至 Looker 後，使用者開啟或與資訊主頁互動時，系統不會使用任何 AI 模型。

Looker 資料應用程式總覽

資料應用程式是 Looker 擴充功能，由 Looker 擴充功能架構提供支援，並在單一元素的使用者定義資訊主頁 (UDD) 中執行。

主要功能包括：

  • AI 輔助撰寫，零執行階段 AI：您可以在電腦上使用 AI 程式設計代理，根據提示詞生成版面配置和元件程式碼。發布的資料應用程式會在 Looker 中以標準網頁元件的形式執行，使用者查看資訊主頁時不會呼叫任何 AI 模型。
  • 網路隔離沙箱：由於 AI 代理程式會編寫應用程式程式碼，因此 Looker 會在隔離的瀏覽器沙箱中執行每個資料應用程式，並封鎖對外的網路連線。應用程式程式碼只能與 Looker 執行個體通訊，因此查詢結果和使用者憑證無法傳送至外部伺服器。
  • 受管理的資料存取權：資料應用程式只會透過 Looker 的 LookML 語意層查詢資料。所有查詢都會根據檢視者的 Looker 權限、模型存取權和資料列層級存取篩選器執行。
  • 互動式控制項和排定傳送時間：資料應用程式內建互動式篩選器、交叉篩選器和深入分析檢視畫面，並支援下載 Looker PDF 和排定電子郵件傳送時間。

事前準備

安裝開發人員工具及編寫資料應用程式前，請確認您符合下列必要條件：

執行個體需求

  • 您必須使用執行 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 金鑰的「Client ID」和「Client Secret」。

資料夾 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，才能轉譯資料應用程式。

安裝開發人員工具

如要製作資料應用程式，請在本機開發環境 (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：輸入「Client Secret」(用戶端密鑰) (已在本機儲存至 data-apps-config.json，且只有擁有者有檔案權限)。
  5. Looker 資料夾 ID：輸入您在「資料夾 ID」中識別的目標資料夾 ID，或按 Enter 鍵接受預設資料夾 (即「共用」資料夾 1)。

完成提示後，安裝程式會自動執行四步驟驗證檢查，確認您的憑證有效，且 Looker 執行個體可以儲存及提供資料應用程式。

製作、預覽及發布資料應用程式

請按照下列工作流程，使用 AI 程式設計代理建立資料應用程式：

步驟 1：啟動 AI 程式碼編寫代理

在終端機中前往 Data Apps 安裝目錄 (~/looker-data-apps)，然後啟動 AI 程式設計代理。

步驟 2：提示代理程式生成資料應用程式

使用自然語言撰寫提示，要求虛擬服務專員建構應用程式。您的應用程式必須以現有的探索和檢視畫面為基礎，但不需要使用技術 ID。例如：

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 資訊卡，部分重疊於主橫幅。
  • 在寬資料格旁新增多欄內容提要側欄。
  • 套用自訂企業品牌宣傳訊息、字型樣式和背景漸層。

加入豐富的互動式 UI 元件

請代理程式新增互動式網頁元素：

  • 分頁導覽：在多個分頁中整理複雜的營運指標，不必重新載入網頁。
  • 強制回應對話方塊和導覽匣：點擊指標時，開啟詳細的細目檢視畫面或詞彙定義。
  • 互動式篩選器和控制項：新增自訂切換按鈕、滑桿和搜尋輸入內容，動態更新圖表序列。

使用進階資料表和圖表

善用內建元件程式庫：

  • 整合 AG Grid：內嵌支援資料欄排序、資料欄大小調整和儲存格格式設定的互動式資料表。
  • 進階 Highcharts 類型：產生標準資訊主頁動態磚不支援的儀表、熱度圖、樹狀圖和桑基圖。

測試 Looker 平台功能

確認資料應用程式已整合 Looker 工作流程：

  • 交叉篩選：設定圖表，讓您在一個圖表中選取類別時，系統會篩選其餘的圖表。
  • 匯出 PDF：將整個資訊主頁下載為 PDF。
  • 排定傳送時間：設定自動排程，透過電子郵件將資料應用程式的 PDF 快照傳送給團隊。