設定及調整設定

本文說明安裝 Google Cloud Data Agent Kit IDE 擴充功能後，如何設定初始設定。

事前準備

開始之前，請先完成「安裝 Data Agent Kit」中的步驟，包括選取要使用的服務。如果您尚未選取服務，Google Cloud Data Agent Kit 選單中這些服務的專區會顯示「整合功能尚未啟用」，直到您選取服務為止。

設定 Google Cloud 專案和區域

如果您尚未設定專案和區域，請按照下列步驟操作。

  1. 如要開啟 Data Cloud 設定編輯器，請按一下活動列中的「Google Cloud Data Agent Kit」圖示。
  2. 展開「設定」，然後點選「設定」。
  3. 選取「Common」。
  4. 選取專案 ID 和區域。專案 ID 必須與您在 gcloud CLI 中指定的專案 ID 相符。
  5. 按一下 [儲存]。

查看必要角色

選取要使用的服務時，Data Agent Kit 會檢查您的 Identity and Access Management (IAM) 角色。

  1. 如要開啟 Data Cloud 設定編輯器，請按一下活動列中的「Google Cloud Data Agent Kit」圖示。
  2. 展開「設定」，然後點選「設定」。
  3. 按一下「服務整合」。

  4. 選取要使用的服務，然後按一下「下一步」。

    如果缺少任何必要角色或 API，系統會開啟「缺少權限」頁面。其中列出所選服務的建議 IAM 權限，以及必須啟用的 API。

  5. 如要取得使用 Data Agent Kit 時缺少的權限，請按一下「電子郵件清單」將清單傳送給管理員，或按一下「複製清單」。請管理員授予您專案的相應 IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

設定 BigQuery 區域

  1. 如要開啟 Data Cloud 設定編輯器，請按一下活動列中的「Google Cloud Data Agent Kit」圖示。
  2. 展開「設定」，然後點選「設定」。
  3. 選取 [BigQuery]。
  4. 選取 BigQuery 區域。
  5. 按一下 [儲存]。

查看 Apache Spark 的無伺服器執行階段

  1. 如要開啟 Data Cloud 設定編輯器，請按一下活動列中的「Google Cloud Data Agent Kit」圖示。
  2. 展開「設定」，然後點選「設定」。
  3. 選取「Apache Spark」。系統會顯示專案的所有無伺服器執行階段。
  4. 如要查看無伺服器執行階段設定，請按一下其名稱。

建立 Serverless Runtime for Apache Spark

  1. 如要開啟 Data Cloud 設定編輯器，請按一下活動列中的「Google Cloud Data Agent Kit」圖示。
  2. 展開「設定」，然後點選「設定」。
  3. 選取「Apache Spark」。
  4. 點選「建立」。
  5. 填寫欄位，然後按一下「儲存」。

刪除 Serverless Runtime for Apache Spark

  1. 如要開啟 Data Cloud 設定編輯器，請按一下活動列中的「Google Cloud Data Agent Kit」圖示。
  2. 展開「設定」，然後點選「設定」。
  3. 選取「Apache Spark」。
  4. 找出要刪除的無伺服器執行階段，然後按一下「刪除」。

設定排程器

  1. 如要開啟 Google Cloud Data Agent Kit 設定編輯器，請按一下活動列中的「Google Cloud Data Agent Kit」圖示。
  2. 展開「設定」，然後點選「設定」。
  3. 按一下「排程器」。
  4. 選取專案和區域。專案和區域不必與「通用」分頁中選取的專案和區域相符。
  5. 選取 Managed Service for Apache Airflow 環境，設定工作流程。
  6. 按一下 [儲存]。

安裝依附元件

安裝擴充功能後，您還需要安裝其他軟體，才能執行部分 Google Cloud Data Agent Kit 作業。在某些情況下，系統會提示您同意自動安裝。在其他情況下，您必須手動安裝軟體。

Orchestration Pipelines

如要在 IDE 中使用 Orchestration Pipelines，請安裝下列項目：

Notebooks

Google Cloud Data Agent Kit 產生的 Notebooks 包含標示為註解的 %pip install --upgrade bigframes 儲存格。如果核心未安裝 BigQuery DataFrame，請取消註解並執行該儲存格，再執行筆記本的其餘部分。

如要允許代理程式在筆記本中執行程式碼儲存格，請在 IDE 設定中啟用 google.datacloud.executeCellToolForNotebookMCP 設定。這項設定會啟用 Notebook Model Context Protocol (MCP) 的 execute_cell 工具。

疑難排解

如果遇到問題，請嘗試登出 Google Cloud Data Agent Kit 和 gcloud CLI，然後重新登入。如要瞭解診斷及解決設定錯誤的其他方法，請參閱「排解資料代理程式套件問題」。

回報問題

如要回報問題，請按照下列步驟操作：

  1. 在活動列的 Google Cloud Data Agent Kit 選單中，按一下「Report bug」。
  2. 在開啟的表單中記錄問題，然後按一下「提交」。

後續步驟