設定をセットアップして構成する

このドキュメントでは、Visual Studio Code 用の Google Cloud Data Agent Kit 拡張機能をインストールした後に初期設定を構成する方法について説明します。

始める前に

始める前に、拡張機能をインストールするの手順を完了します。

Google Cloud プロジェクトとリージョンを構成する

プロジェクトとリージョンを構成していない場合は、次の手順を行います。

  1. データクラウド設定エディタを開くには、アクティビティ バーの Google Cloud Data Agent Kit アイコンをクリックします。
  2. [設定] を展開し、[設定] をクリックします。
  3. [共通] を選択します。
  4. プロジェクト ID とリージョンを選択します。プロジェクト ID は、gcloud CLI で指定したプロジェクト ID と一致している必要があります。
  5. [保存] をクリックします。

必要なロールを確認する

  1. データクラウド設定エディタを開くには、アクティビティ バーの Google Cloud Data Agent Kit アイコンをクリックします。
  2. [設定] を展開し、[設定] をクリックします。

  3. [Common] > [Required Permissions] に移動します。

    [アクセス] 列は、必要なロールのプリンシパルであるかどうかを示します。

  4. VS Code 用 Data Agent Kit 拡張機能を使用するために必要な権限が不足している場合は、プロジェクトに対する対応する Identity and Access Management（IAM）ロールを付与するよう管理者に依頼してください。ロールの付与の詳細については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

BigQuery リージョンを構成する

  1. データクラウド設定エディタを開くには、アクティビティ バーの Google Cloud Data Agent Kit アイコンをクリックします。
  2. [設定] を展開し、[設定] をクリックします。
  3. [BigQuery] を選択します。
  4. BigQuery リージョンを選択します。
  5. [保存] をクリックします。

Apache Spark 用サーバーレス ランタイムを表示する

  1. データクラウド設定エディタを開くには、アクティビティ バーの Google Cloud Data Agent Kit アイコンをクリックします。
  2. [設定] を展開し、[設定] をクリックします。
  3. [Apache Spark] を選択します。プロジェクトのすべてのサーバーレス ランタイムが表示されます。
  4. サーバーレス ランタイム構成を表示するには、その名前をクリックします。

Apache Spark 向け Serverless ランタイムを作成する

  1. データクラウド設定エディタを開くには、アクティビティ バーの Google Cloud Data Agent Kit アイコンをクリックします。
  2. [設定] を展開し、[設定] をクリックします。
  3. [Apache Spark] を選択します。
  4. [作成] をクリックします。
  5. フィールドに入力し、[保存] をクリックします。

Apache Spark 用 Serverless ランタイムを削除する

  1. データクラウド設定エディタを開くには、アクティビティ バーの 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. データクラウド設定エディタを開くには、アクティビティ バーの Google Cloud Data Agent Kit アイコンをクリックします。
  2. [設定] を展開し、[設定] をクリックします。
  3. [スキル] をクリックします。
  4. スキルを定義するマークダウンを読むには、スキルのタイトルをクリックします。

依存関係のインストール

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. 表示されたフォームで、問題を記録し、[送信] をクリックします。

次のステップ