Google Cloud Data Agent Kit を使用すると、お好みの IDE またはエージェント コーディング環境で Google Cloud データリソースを操作できます。設定に応じて、IDE 拡張機能またはプラグインをインストールします。
Data Agent Kit には、次の Google Cloudサービスがプリインストールされています。
- Cloud Shell
- Cloud Workstations
始める前に
Data Agent Kit をインストールする前に、次の操作を行います。
ローカル環境を設定する
ローカルマシンに、お好みの IDE またはコーディング エージェントと Node.js をインストールします。
- IDE、エージェント CLI、コーディング エージェントをインストールして設定します。すでにインストールされている場合は、最新バージョンに更新します。
- Node.js をインストールします。
Google Cloudを設定する
- まだ作成していない場合は、 Google Cloud プロジェクトを作成します。
- 課金を有効にします。
必要なロール
タスクを完了するために追加の権限が必要になると、Data Agent Kit から通知されます。必要なのは、使用するサービスに対する権限のみです。Data Agent Kit の各サービスに必要な権限と API の完全なリストについては、権限をご覧ください。
拡張機能またはプラグインをインストールする
インストール プロセスは、使用する IDE またはコーディング エージェントによって異なります。
VS Code
VS Code で Data Agent Kit を使用するには、拡張機能をインストールします。
- IDE で、[拡張機能] をクリックするか、
Ctrl/Cmd+Shift+Xを押します。 Google Cloud Data Agent Kitを検索します。- [インストール] をクリックします。
- プロンプトが表示されたら、IDE を再起動します。拡張機能が正常にインストールされると、Google Cloud Data Agent Kit アイコンがアクティビティ バーに追加されます。
この拡張機能は、Visual Studio Marketplace からインストールすることもできます。
Antigravity
使用している Antigravity ツールの手順をクリックして開きます。
Antigravity IDE
Antigravity IDE で Data Agent Kit を使用するには、拡張機能をインストールします。
- IDE で、[拡張機能] をクリックするか、
Ctrl/Cmd+Shift+Xを押します。 Google Cloud Data Agent Kitを検索します。- [インストール] をクリックします。
- プロンプトが表示されたら、IDE を再起動します。拡張機能が正常にインストールされると、Google Cloud Data Agent Kit アイコンがアクティビティ バーに追加されます。
Antigravity CLI
Antigravity CLI で Data Agent Kit を使用するには、プラグインをインストールします。ターミナルで、次のコマンドを実行します。
agy plugin install https://github.com/GoogleCloudPlatform/data-agent-kit-plugin
Antigravity 2.0
Antigravity CLI で Data Agent Kit を使用するには、プラグインをインストールします。
- [設定] をクリックします。
- [設定] ペインで、[カスタマイズ] をクリックします。
- [Build with Google Plugins] を見つけて、[カスタマイズ] をクリックします。
- リストで Google Cloud Data Agent Kit を見つけて、[ダウンロード] をクリックします。
Antigravity for VS Code 拡張機能
VS Code 用 Antigravity 拡張機能を使用しているときに VS Code で Data Agent Kit を使用するには、次の操作を行います。
- VS Code のステータスバーで、[Antigravity - Settings] をクリックします。
- [設定] ペインで、[カスタマイズ] をクリックします。
- [Build with Google Plugins] を見つけて、[カスタマイズ] をクリックします。
- リストで Google Cloud Data Agent Kit を見つけて、[ダウンロード] をクリックします。
Claude Code CLI
Claude Code CLI で Data Agent Kit を使用するには、プラグインをインストールします。ターミナルで次のコマンドを実行します。
claude plugin install data-agent-kit-starter-pack@claude-plugins-official
Codex CLI
Codex CLI で Data Agent Kit を使用するには、プラグインをインストールします。ターミナルで次のコマンドを実行します。
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit-plugin
codex plugin add dak@dak-marketplace
Cursor
Cursor で Data Agent Kit を使用するには、拡張機能をインストールします。
- IDE で、[拡張機能] をクリックするか、
Ctrl/Cmd+Shift+Xを押します。 Google Cloud Data Agent Kitを検索します。- [インストール] をクリックします。
- プロンプトが表示されたら、IDE を再起動します。拡張機能が正常にインストールされると、Google Cloud Data Agent Kit アイコンがアクティビティ バーに追加されます。
VS Code ベースの IDE
VS Code ベースの他のすべての IDE で Data Agent Kit を使用するには、拡張機能をインストールします。
- IDE で、[拡張機能] をクリックするか、
Ctrl/Cmd+Shift+Xを押します。 Google Cloud Data Agent Kitを検索します。- [インストール] をクリックします。
- プロンプトが表示されたら、IDE を再起動します。拡張機能が正常にインストールされると、Google Cloud Data Agent Kit アイコンがアクティビティ バーに追加されます。
Data Agent Kit にログインする
拡張機能またはプラグインをインストールしたら、ログインする必要があります。
拡張機能へのログイン
IDE 拡張機能をインストールした場合は、Google Cloud Data Agent Kit に対して認証を行う必要があります。
ログイン ダイアログが自動的に開かない場合は、IDE ウィンドウの下部にあるステータスバーで Google Cloud Data Agent Kit のログイン リンクを探してクリックします。
または、
Ctrl/Cmd+Shift+Pを押してコマンド パレットを開き、[Google Cloud Data Agent Kit: Sign in] を検索して選択することもできます。画面の指示に沿ってログインを完了します。
認証が完了したことを確認するウェブページが表示されます。
ページを閉じて IDE に戻ります。
プラグインへのログイン
Google Cloud CLI をインストールしてログインします。Data Agent Kit プラグインは、gcloud CLI 認証情報とアプリケーションのデフォルト認証情報（ADC）の両方の認証情報を使用します。
- ローカルマシンまたは IDE でターミナルを開きます。
- gcloud CLI をまだインストールしていない場合は、gcloud CLI をインストールするの手順に沿って gcloud CLI をダウンロードしてインストールします。
- ターミナルで
gcloud initを実行して、gcloud CLI を初期化します。gcloud init
- 次のコマンドを実行し、プロンプトに従って認証を行い、アプリケーションのデフォルト認証情報を設定します。
gcloud auth login && gcloud auth application-default login
- gcloud CLI を最新バージョンに更新します。
gcloud components update
トラブルシューティング
問題が発生した場合は、いったんログアウトしてからもう一度ログインしてみてください。インストール エラーを診断して解決するその他の方法については、トラブルシューティングをご覧ください。