在 Gemini 協助下編寫 LookML

本說明文件頁面說明如何使用 Gemini 輔助功能，在 LookML 專案中建立維度、維度群組和評量。根據書面提示產生 LookML 程式碼建議，是 Looker (原始版本) 和 Looker (Google Cloud Core) 執行個體提供的 Gemini in Looker 功能。

Gemini in Looker 提供生成式 AI 輔助功能，協助您處理資料。

瞭解 Gemini for Google Cloud 如何使用您的資料，以及使用時機。

本頁面適用於 Looker 開發人員。

事前準備

如要在 Looker IDE 中使用 Gemini，請注意下列需求：

• 您必須為 Looker 執行個體啟用 Gemini in Looker：
  • 針對 Looker (原始版本)，執行個體必須執行 Looker 25.2 以上版本，且必須在管理員設定中啟用 Gemini in Looker。如需詳細啟用說明，請參閱「管理員設定 - Looker 中的 Gemini」說明頁面。
  • 針對 Looker (Google Cloud Core)，您必須在 Google Cloud 控制台中為 Gemini in Looker 啟用執行個體。如需詳細啟用說明，請參閱「在 Looker (Google Cloud Core) 執行個體上管理 Gemini」說明文件頁面。
• 您必須指派 Looker 角色，該角色包含 LookML 專案中至少一個模型的 develop 權限。
• 您必須具備 Looker Gemini 角色。

在 Looker IDE 中使用 Gemini

如要使用 Gemini 在 Looker 專案中建立 LookML，請按照下列步驟操作：

1. 在 Looker 執行個體中啟用開發模式。
2. 在 Looker IDE 中開啟專案。
3. 使用 IDE 檔案瀏覽器開啟要插入 LookML 的 LookML 檢視表檔案。

4. 從側邊面板選取器中選取「Help me code」圖示。

   

5. 開啟「幫我編寫程式碼」面板後，按一下將游標放在 LookML 檢視檔案中的一行。根據 LookML 檔案類型和游標在檔案中的位置，Gemini 會提供適當的選項來引導您，例如「建立維度」或「建立評估」。

6. 在「Help me code」面板中選取下列其中一個選項：

   • 建立維度群組
   • 建立維度
   • 建立測量指標
   • 其他程式碼建議：如果您想嘗試不同的 LookML 元素，可以使用「其他程式碼建議」選項。請注意，Gemini 仍處於早期技術階段，因此請先驗證並測試所有輸出內容，再部署。

7. 在「幫我編寫程式碼」面板文字欄位中，使用對話式語言描述要建立的維度、維度群組或資料表。如需相關指引，請參閱本頁的「在 Looker IDE 中使用 Gemini 的訣竅」和「提示範例」部分。

8. 按下 Enter 鍵或點選「提交」圖示，即可將要求傳送給 Gemini。Gemini 會回覆建議的程式碼。

9. 您可以使用建議的程式碼執行以下操作：

   • 將游標懸停在「插入」按鈕上，即可預覽檔案中的建議 LookML。您可以將游標移至檔案中的不同行，在其他位置預覽檔案，然後再將 LookML 插入檔案。
   • 按一下「編輯」按鈕，即可手動變更建議的 LookML。
   • 按一下「插入」按鈕，即可在游標所在位置的檔案中插入 LookML。
   • 選取「喜歡」圖示 (這個回覆很有幫助) 或「不喜歡」圖示 (這個回覆與預期不符)，針對建議的程式碼提供意見回饋。
   • 按一下「新代碼建議」連結，重新開始並為 Gemini 輸入新的提示。

   

10. 在 LookML 檔案中按一下「儲存變更」。

11. 如要驗證 LookML，請按照下列步驟操作：

    • 使用 LookML Validator 驗證 LookML。
    • 在「探索」中測試 LookML。

在 Looker IDE 中使用 Gemini 的訣竅

以下是使用 Looker IDE 中的 Gemini 的訣竅：

• 為獲得最佳成效，請以美式英文撰寫提示。詳情請參閱 Gemini for Google Cloud 限制說明文件。
• 「Help me code」面板不會保留對話中先前提示的內容，也不會在登入和重新整理時保留提示。
• 使用 Gemini 建議的 LookML 時，請務必使用 LookML 驗證工具驗證 LookML，並在 Explore 中測試新欄位。
• 視您的要求而定，Gemini 可能會建議您使用參照其他檢視檔案欄位的 LookML。將建議的 LookML 新增至檔案後，請儲存檔案並執行 LookML 驗證工具。如果您需要在模型檔案中新增 include 陳述式，LookML 驗證工具就會顯示錯誤。

提示範例

以下提供一些提示和結果範例，供您參考：

• 使用經緯度建立維度
• 建立今日總銷售量的評估指標

使用經緯度建立維度

以下是使用「Create a dimension」選項的提示，要求 Gemini 根據檢視畫面檔案中定義的 longitude 和 latitude 欄位建立新的維度：

show coordinates with longitude and latitude

Gemini 會傳回以下建議的程式碼：

   dimension: coordinates {
      type: location
      sql_latitude: ${TABLE}.latitude ;;
      sql_longitude: ${TABLE}.longitude ;;
   }

您可以在探索中驗證這段 LookML，方法是選取新的 coordinates 欄位，以及該欄位所依據的 longitude 和 latitude 欄位。由於 Gemini 是使用 type:location 建立維度，因此探索結果會包含超連結，可在地圖上查看座標：

建立用於計算今日總銷售量的評估指標

以下是使用「建立指標」選項的提示，要求 Gemini 為當天所有訂單的總和建立新指標：

show the total sale price of today's orders

Gemini 會傳回以下建議的程式碼：

   measure: todays_orders {
      type: sum
      sql: ${basic_order_items.sale_price} ;;
      filters: [basic_order_items.created_at_date: "today"]
  }

提供意見回饋

您可以在「幫我編寫程式碼」面板中，針對生成的 LookML 提供意見回饋。如果產生的 LookML 看起來正確無誤，請按一下 thumb_up 喜歡圖示。如果產生的 LookML 不正確或與預期不符，請按一下「倒讚」thumb_down 圖示。

相關資源

• 進一步瞭解 Gemini for Google Cloud
• 進一步瞭解 Looker 中的 Gemini