設定及調整設定

本文說明安裝 Visual Studio Code 適用的 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. 按一下 [儲存]。

查看必要角色

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

  3. 依序前往「Common」>「Required Permissions」。

    「存取權」欄會指出您是否為必要角色中的主體。

  4. 如要取得使用 VS Code 適用的 Data Agent Kit 擴充功能所需的任何缺少的權限，請要求管理員授予您專案的對應 Identity and Access Management (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. 按一下 [儲存]。

查看代理技能

VS Code 的 Data Agent Kit 擴充功能隨附代理程式技能，可在工作流程中使用。

  1. 如要開啟 Data Cloud 設定編輯器，請按一下活動列中的「Google Cloud Data Agent Kit」圖示。
  2. 展開「設定」，然後點選「設定」。
  3. 按一下「技能」。
  4. 如要閱讀定義技能的 Markdown，請按一下技能標題。

安裝依附元件

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

Orchestration Pipelines

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

筆記本

當您嘗試執行需要下列項目的作業時，IDE 會提示您同意，然後為您安裝軟體：

  • BigQuery DataFrames (2.36 以上版本)
  • Anywidget
  • BigQuery ML

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

疑難排解

如果遇到問題，請嘗試登出 Google Cloud Data Agent Kit 和 gcloud CLI，然後重新登入。如要瞭解診斷及解決設定錯誤的其他方法，請參閱「排解 VS Code 的 Data Agent Kit 擴充功能問題」。

回報問題

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

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

後續步驟