Menginstal Data Agent Kit

Google Cloud Data Agent Kit memungkinkan Anda bekerja dengan Google Cloud data resource di IDE atau lingkungan coding agentic pilihan Anda. Bergantung pada penyiapan Anda, Anda menginstal ekstensi atau plugin IDE.

Data Agent Kit sudah diinstal sebelumnya dengan layanan Google Cloud berikut:

  • Cloud Shell
  • Cloud Workstations

Sebelum memulai

Sebelum menginstal Data Agent Kit, lakukan hal berikut.

Menyiapkan lingkungan lokal Anda

Di komputer lokal, instal IDE atau agen coding pilihan Anda dan Node.js.

  1. Instal dan siapkan IDE, CLI agentik, atau agen coding Anda. Jika sudah diinstal, update ke versi terbaru.
  2. Instal Node.js.

Menyiapkan Google Cloud

  1. Jika Anda belum memilikinya, buat Google Cloud project.
  2. Aktifkan penagihan.

Peran yang diperlukan

Data Agent Kit akan memberi tahu Anda saat Anda memerlukan izin tambahan untuk menyelesaikan tugas. Anda hanya memerlukan izin untuk layanan yang Anda gunakan. Untuk mengetahui daftar lengkap izin dan API yang diperlukan untuk setiap layanan di Data Agent Kit, lihat Izin.

Menginstal ekstensi atau plugin

Proses penginstalan Anda bergantung pada IDE atau agen coding yang Anda gunakan.

VS Code

Untuk menggunakan Data Agent Kit di VS Code, instal ekstensi:

  1. Di IDE, klik Extensions atau tekan Ctrl/Cmd+Shift+X.
  2. Telusuri Google Cloud Data Agent Kit.
  3. Klik Instal.
  4. Jika diminta, mulai ulang IDE Anda. Setelah ekstensi berhasil diinstal, ikon Google Cloud Data Agent Kit akan ditambahkan ke kolom aktivitas.

Anda juga dapat menginstal ekstensi dari Visual Studio Marketplace.

Antigravity

Klik untuk meluaskan petunjuk alat Antigravitasi yang Anda gunakan.

Antigravity IDE

Untuk menggunakan Data Agent Kit di Antigravity IDE, instal ekstensi.

  1. Di IDE, klik Extensions atau tekan Ctrl/Cmd+Shift+X.
  2. Telusuri Google Cloud Data Agent Kit.
  3. Klik Instal.
  4. Jika diminta, mulai ulang IDE Anda. Setelah ekstensi berhasil diinstal, ikon Google Cloud Data Agent Kit akan ditambahkan ke kolom aktivitas.

Antigravity CLI

Untuk menggunakan Data Agent Kit dengan Antigravity CLI, instal plugin. Di terminal, jalankan perintah berikut:

agy plugin install https://github.com/GoogleCloudPlatform/data-agent-kit-plugin

Antigravity 2.0

Untuk menggunakan Data Agent Kit dengan Antigravity CLI, instal plugin.

  1. Klik Setelan.
  2. Di panel Setelan, klik Penyesuaian.
  3. Cari Build with Google Plugins, lalu klik Customize.
  4. Cari Google Cloud Data Agent Kit dalam daftar, lalu klik Download.

Ekstensi Antigravity untuk VS Code

Untuk menggunakan Data Agent Kit di VS Code saat menggunakan ekstensi Antigravity untuk VS Code, lakukan hal berikut:

  1. Di status bar VS Code, klik Antigravity - Settings.
  2. Di panel Setelan, klik Penyesuaian.
  3. Cari Build with Google Plugins, lalu klik Customize.
  4. Cari Google Cloud Data Agent Kit dalam daftar, lalu klik Download.

CLI Claude Code

Untuk menggunakan Data Agent Kit dengan Claude Code CLI, instal plugin. Jalankan perintah berikut di terminal Anda:

claude plugin install data-agent-kit-starter-pack@claude-plugins-official

Codex CLI

Untuk menggunakan Data Agent Kit dengan Codex CLI, instal plugin. Jalankan perintah berikut di terminal Anda:

codex plugin marketplace aadd GoogleCloudPlatform/data-agent-kit-plugin
codex plugin add dak@dak-marketplace

Kursor

Untuk menggunakan Data Agent Kit di Cursor, instal ekstensi.

  1. Di IDE, klik Extensions atau tekan Ctrl/Cmd+Shift+X.
  2. Telusuri Google Cloud Data Agent Kit.
  3. Klik Instal.
  4. Jika diminta, mulai ulang IDE Anda. Setelah ekstensi berhasil diinstal, ikon Google Cloud Data Agent Kit akan ditambahkan ke kolom aktivitas.

IDE berbasis VS Code

Untuk menggunakan Data Agent Kit dengan semua IDE lain berdasarkan VS Code, instal ekstensi.

  1. Di IDE, klik Extensions atau tekan Ctrl/Cmd+Shift+X.
  2. Telusuri Google Cloud Data Agent Kit.
  3. Klik Instal.
  4. Jika diminta, mulai ulang IDE Anda. Setelah ekstensi berhasil diinstal, ikon Google Cloud Data Agent Kit akan ditambahkan ke kolom aktivitas.

Login ke Data Agent Kit

Setelah menginstal ekstensi atau plugin, Anda harus login.

Login ekstensi

Jika Anda menginstal ekstensi IDE, Anda harus melakukan autentikasi ke Google Cloud Data Agent Kit.

  1. Jika dialog login tidak terbuka secara otomatis, cari link login Google Cloud Data Agent Kit di status bar di dekat bagian bawah jendela IDE, lalu klik link tersebut.

    Atau, Anda dapat menekan Ctrl/Cmd+Shift+P untuk membuka palet perintah, menelusuri dan memilih Google Cloud Data Agent Kit: Sign in.

  2. Ikuti petunjuk dan selesaikan proses login.

    Halaman web yang mengonfirmasi bahwa autentikasi telah selesai akan ditampilkan.

  3. Tutup halaman dan kembali ke IDE.

Login plugin

Instal dan login ke Google Cloud CLI. Plugin Data Agent Kit menggunakan kredensial dari kredensial gcloud CLI dan kredensial default aplikasi (ADC).

  1. Buka terminal di mesin lokal atau di IDE Anda.
  2. Jika Anda belum pernah menginstal gcloud CLI, ikuti langkah-langkah di Menginstal gcloud CLI untuk mendownload dan menginstal gcloud CLI.
  3. Di terminal, jalankan gcloud init untuk melakukan inisialisasi gcloud CLI: 
    gcloud init
  4. Jalankan perintah berikut dan ikuti perintah untuk mengautentikasi dan menyiapkan kredensial default aplikasi: 
    gcloud auth login && gcloud auth application-default login
  5. Update gcloud CLI ke versi terbaru: 
    gcloud components update

Memecahkan masalah

Jika Anda mengalami masalah, coba logout, lalu login lagi. Untuk menemukan metode tambahan dalam mendiagnosis dan menyelesaikan error penginstalan, lihat Memecahkan masalah.

Langkah berikutnya