Earth Engine 程式碼編輯器的「詢問」面板會使用 Gemini 協助您編寫、瞭解、偵錯及最佳化指令碼。這項服務是整合至程式碼編輯器的對話式 AI 助理，可簡化地理空間分析和指令碼開發作業。
介面和工具
AI 輔助面板位於 Earth Engine 程式碼編輯器的右側窗格。如要開啟，請點選「檢查器」、「控制台」和「工作」分頁旁邊的「詢問」分頁。
「詢問」窗格包含多項控制項和工具，可協助您管理與 AI 的互動。
按鈕和控制選項
- 傳送 / 停止：將提示傳送給助理。生成作業進行時，按鈕會切換為停止圖示，方便你取消要求。你也可以使用
enter/return鍵傳送訊息。 - 發起新對話：清除對話記錄並開始新的工作階段。
- 說明：開啟對話方塊，顯示功能、帳單和條款相關資訊。
- 模型選取：下拉式選單，可供選擇要使用的 Gemini 模型。部分模型可能無法運作，具體視 API 金鑰的層級而定。系統會儲存你的選擇，供下次工作階段使用。
- 工具切換按鈕：這個選單可供啟用或停用特定工具，供助理使用。系統會儲存你的選擇，供下次工作階段使用。
- 複製 (程式碼區塊)：將生成的程式碼複製到剪貼簿。
- 插入 (程式碼區塊)：將產生的程式碼插入指令碼編輯器。如果編輯器不是空白，系統會顯示差異對話方塊，醒目顯示變更供您查看。
- 重新生成：最後一則回覆底部會顯示重試按鈕，可重新執行提示。
- 權杖計數器：顯示目前對話工作階段使用的權杖數量。可用於監控 API 金鑰的使用情形，確保不會超出限制。
工具選項
你可以啟用下列工具，提升智慧助理的回覆品質。請注意，啟用工具會在要求中加入額外背景資訊 (例如文件或搜尋結果)，因此可能會增加權杖用量。
- 文件：搜尋 Earth Engine 公開說明文件，提供正確的程式碼和說明。
- 資料集搜尋：在 Earth Engine Data Catalog中搜尋資料集。
- Google 搜尋：根據 Google 搜尋結果提供回覆，從網路上取得最新資訊。請注意，Google 搜尋工具無法與 Google 文件或資料集搜尋工具同時使用。啟用 Google 搜尋後，使用者介面中的其他工具會自動停用。
必要條件
這項功能會使用您自己的 Gemini API 金鑰，向模型發出要求。
如何取得 Gemini API 金鑰
您可以在 Google AI Studio 的 Cloud 專案中建立或查看 Gemini API 金鑰。
- 前往 Google AI Studio API 金鑰。
- 按一下「建立 API 金鑰」，然後選取建立金鑰的選項。
如要進一步瞭解 Gemini API 金鑰，請參閱 Gemini API 金鑰說明文件。
在程式碼編輯器中設定 API 金鑰
取得 API 金鑰後，請務必將金鑰加入程式碼編輯器：
- 在「詢問」面板中，按一下對話輸入框中的鑰匙圖示。
- 將 API 金鑰貼到隨即顯示的對話方塊。
- 視需要勾選方塊，儲存金鑰供日後使用，然後按一下「確定」。
自動使用螢幕內容
為提供相關協助，「幫我」功能會在每次要求中自動加入下列情境：
- 編輯器中目前指令碼的全文。
- 任何匯入的資產和幾何圖形。
- 目前工作階段的對話記錄。
排解控制台錯誤
AI 助理直接整合至程式碼編輯器的控制台，可協助您快速解決執行階段錯誤：
- 如果指令碼發生錯誤，請在「控制台」分頁中尋找紅色錯誤資訊卡。
- 按一下錯誤資訊卡上的「疑難排解」按鈕。
- 系統會自動開啟「詢問」面板，並將含有錯誤訊息和腳本相關情境脈絡的自動生成提示訊息排入佇列，供您傳送。
提示詞範例
你可以直接在對話框中輸入內容，要求助理協助處理各種工作。以下列舉幾個可以向 AI 提出的問題，並依工作類型分類：
程式碼生成與工作流程
- 「請編寫指令碼，載入 2023 年東非的 Sentinel-2 影像，篩選雲量低於 10% 的影像，計算 NDVI 中位數，然後使用白到綠的視覺化調色盤將其新增至地圖。」
- 「Create a cloud-free Landsat 9 composite for summer 2024 in Central Europe and export it to my cloud storage bucket.」(在 2024 年夏季，為中歐建立無雲的 Landsat 9 合成影像，並匯出至我的 Cloud Storage bucket)。
Earth Engine 應用程式
- 「編寫程式碼，建立 Earth Engine 應用程式分割面板地圖，並排比較 2020 年和 2024 年的影像。」
- 「在左側新增面板，內含下拉式選單 (可選取年份) 和地圖重新整理按鈕。」
- 「在地圖中加入自訂圖例，顯示地表覆蓋分類。」
偵錯
- 「我收到『User memory limit exceeded』錯誤訊息，該如何解決這個問題？"
- 「我的地圖顯示的圖層像素值沒有差異，這與我的預期不符，請問是哪裡出錯了？」
- 「為什麼我在執行這項計算時，會收到『Image.select: Band 'NDVI' not found』錯誤訊息？」
說明
- 「Explain what
ee.Reducer.mean().combine()is doing on line 15 of my script.」(說明指令碼第 15 行的ee.Reducer.mean().combine()作用。) - 「
ee.Image.clip()和ee.Image.mask()有何不同？」
最佳化
- 「Can you optimize this image collection map operation to run more efficiently?」
- 「如何針對多個多邊形和圖片重新編寫這項
reduceRegions作業，避免逾時？」
帳單與費用
使用這項功能時，必須提供自己的 Gemini API 金鑰。費用取決於 Gemini API 定價和金鑰的配額層級。
- 免費方案：Gemini API 提供免費方案 (設有使用限制)。
- 付費級別：如果您使用付費級別的 API 金鑰，無論是否註冊特定 Earth Engine 專案，都會產生費用。
詳情請參閱 Gemini API 定價。
監控用量及控管費用
您可以在 AI Studio 中直接管理金鑰，以及查看用量和費用。
- 在 AI Studio 介面中，查看 API 金鑰的層級、用量、限制和支出。
- 在 AI Studio 的「支出」分頁中設定每月支出上限。
資料和隱私權
我們會依據《Gemini API 服務條款》的規定處理你的資料。請務必詳閱提示和生成內容的使用規定。
意見回饋
歡迎提供寶貴意見，協助我們改善服務品質！如要隨時分享意見回饋，請點選程式碼編輯器右上角的意見回饋按鈕。使用「傳送程式碼編輯器相關意見」選項。我們會積極閱讀這些意見，以改善模型成效並決定功能的優先順序。