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

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

始める前に

始める前に、Data Agent Kit をインストールするの手順（使用するサービスを選択するなど）を完了します。選択していないサービスの Google Cloud Data Agent Kit メニューのセクションには、選択するまで「統合が無効になっています」と表示されます。

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

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

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

必要なロールを確認する

Data Agent Kit は、使用するサービスを選択するときに Identity and Access Management（IAM）ロールを確認します。

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

  4. 使用するサービスを選択し、[次へ] をクリックします。

    必要なロールまたは API が不足している場合は、[権限がありません] ページが開きます。選択したサービスごとに推奨される IAM 権限と、有効にする必要がある API が一覧表示されます。

  5. Data Agent Kit の使用に必要な権限が不足している場合は、[メールリスト] をクリックしてリストを管理者に送信するか、[リストをコピー] をクリックします。プロジェクトに対する対応する 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 用のサーバーレス ランタイムを作成する

  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. [保存] をクリックします。

依存関係のインストール

Google Cloud Data Agent Kit の一部のオペレーションでは、拡張機能をインストールした後に追加のソフトウェアをインストールする必要があります。場合によっては、自動インストールに同意するよう求められます。それ以外の場合は、ソフトウェアを手動でインストールする必要があります。

Orchestration Pipelines

IDE で Orchestration Pipelines を操作するには、次のものをインストールします。

Notebooks

Google Cloud Data Agent Kit が生成する Notebooks には、コメントアウトされた %pip install --upgrade bigframes セルが含まれています。BigQuery DataFrames がカーネルにインストールされていない場合は、ノートブックの残りの部分を実行する前に、そのセルのコメントを解除して実行します。

エージェントがノートブックでコードセルを実行できるようにするには、IDE の設定で google.datacloud.executeCellToolForNotebookMCP 設定を有効にします。この設定により、Notebook Model Context Protocol（MCP）の execute_cell ツールが有効になります。

トラブルシューティング

問題が発生した場合は、Google Cloud Data Agent Kit と gcloud CLI からログアウトして、もう一度ログインしてみてください。構成エラーを診断して解決するその他の方法については、Data Agent Kit のトラブルシューティングをご覧ください。

問題を報告

問題を報告するには、次の操作を行います。

  1. アクティビティ バーの Google Cloud Data Agent Kit メニューで、[バグを報告] をクリックします。
  2. 表示されたフォームで、問題を記録し、[送信] をクリックします。

次のステップ