在 Gemini 協助下編寫 LookML

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

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

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

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

事前準備

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

  • 您必須為 Looker 執行個體啟用 Gemini in Looker：
  • 您必須獲派 Looker 角色，且該角色在 LookML 專案中至少有一個模型具備 develop 權限。
  • 您必須獲派 Looker Gemini 角色。

在 Looker IDE 中使用 Gemini

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

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

  4. 從側邊面板選取器選取「幫我編寫程式碼」圖示。

    Looker IDE，醒目顯示「幫我寫程式碼」圖示。

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

  6. 在「幫我編寫程式碼」面板中選取下列其中一個選項：

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

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

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

  9. 建議的程式碼可讓您執行下列操作：

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

    滑鼠游標懸停在「插入」按鈕上時，Gemini 會顯示程式碼放置位置的預覽畫面。

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

  11. 請按照下列步驟驗證 LookML：

在 Looker IDE 中使用 Gemini 的訣竅

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

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

提示範例

以下列舉幾個範例提示和結果，供您參考：

使用經緯度建立維度

以下是使用「建立維度」選項的提示，要求 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 建立維度，因此探索結果會包含超連結，方便您在地圖上查看座標：

Looker 探索功能顯示經緯度欄位，以及與經緯度值相符的新座標欄位值。

建立今日總銷售額的指標

以下是使用「建立指標」選項的提示，要求 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「不喜歡」圖示。