Menyiapkan dan mengonfigurasi setelan

Dokumen ini menjelaskan cara mengonfigurasi setelan awal setelah Anda menginstal ekstensi IDE Google Cloud Data Agent Kit.

Catatan: Jika Anda menggunakan plugin Data Agent Kit dengan CLI atau agen pengodean yang didukung, Anda dapat menggunakan perintah bahasa alami untuk mengonfigurasi setelan.

Sebelum memulai

Sebelum memulai, selesaikan langkah-langkah di Menginstal Data Agent Kit, termasuk memilih layanan yang ingin Anda gunakan. Bagian menu Google Cloud Data Agent Kit untuk layanan yang belum Anda pilih akan menampilkan integrasi tidak diaktifkan hingga Anda memilihnya.

Penting: Di IDE Anda, Google Cloud Data Agent Kit dan Google Cloud CLI harus dikonfigurasi untuk menggunakan akun pengguna, project, region, dan akun penagihan yang sama.

Mengonfigurasi project dan region Google Cloud

Jika Anda belum mengonfigurasi project dan region, ikuti langkah-langkah berikut.

1. Untuk membuka editor Setelan Data Cloud, klik ikon Google Cloud Data Agent Kit di panel aktivitas.
2. Luaskan Setelan, lalu klik Setelan.
3. Pilih Umum.
4. Pilih Project ID dan Region Anda. Project ID harus cocok dengan project ID yang Anda tentukan di gcloud CLI.
5. Klik Simpan.

Meninjau peran yang diperlukan

Data Agent Kit memeriksa peran Identity and Access Management (IAM) Anda saat Anda memilih layanan yang ingin digunakan.

1. Untuk membuka editor Setelan Data Cloud, klik ikon Google Cloud Data Agent Kit di panel aktivitas.
2. Luaskan Setelan, lalu klik Setelan.
3. Klik Service Integrations.

4. Pilih layanan yang ingin Anda gunakan, lalu klik Berikutnya.

   Jika Anda tidak memiliki peran atau API yang diperlukan, halaman Missing permissions akan terbuka. Bagian ini mencantumkan izin IAM yang direkomendasikan untuk setiap layanan yang dipilih dan API yang harus diaktifkan.

5. Untuk mendapatkan izin yang belum ada yang Anda perlukan untuk menggunakan Data Agent Kit, klik Daftar email untuk mengirim daftar tersebut ke administrator Anda, atau klik Salin daftar. Minta administrator Anda untuk memberi Anda peran IAM yang sesuai di project. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Mengonfigurasi region BigQuery

1. Untuk membuka editor Setelan Data Cloud, klik ikon Google Cloud Data Agent Kit di panel aktivitas.
2. Luaskan Setelan, lalu klik Setelan.
3. Pilih BigQuery.
4. Pilih region BigQuery.
5. Klik Simpan.

Melihat Runtime Serverless untuk Apache Spark

1. Untuk membuka editor Setelan Data Cloud, klik ikon Google Cloud Data Agent Kit di panel aktivitas.
2. Luaskan Setelan, lalu klik Setelan.
3. Pilih Apache Spark. Semua runtime serverless untuk project Anda akan ditampilkan.
4. Untuk melihat konfigurasi runtime serverless, klik namanya.

Membuat Runtime Serverless untuk Apache Spark

1. Untuk membuka editor Setelan Data Cloud, klik ikon Google Cloud Data Agent Kit di panel aktivitas.
2. Luaskan Setelan, lalu klik Setelan.
3. Pilih Apache Spark.
4. Klik Create.
5. Isi kolom, lalu klik Simpan.

Menghapus Runtime Serverless untuk Apache Spark

1. Untuk membuka editor Setelan Data Cloud, klik ikon Google Cloud Data Agent Kit di panel aktivitas.
2. Luaskan Setelan, lalu klik Setelan.
3. Pilih Apache Spark.
4. Untuk runtime serverless yang ingin Anda hapus, klik Hapus.

Menyiapkan Penjadwal

1. Untuk membuka editor Setelan Google Cloud Data Agent Kit, klik ikon Google Cloud Data Agent Kit di panel aktivitas.
2. Luaskan Setelan, lalu klik Setelan.
3. Klik Scheduler.
4. Pilih project dan region. Project dan region tidak harus cocok dengan project dan region yang Anda pilih di tab Umum.
5. Pilih lingkungan Managed Service untuk Apache Airflow Environment guna menyiapkan alur kerja.
6. Klik Simpan.

Menginstal dependensi

Beberapa operasi Google Cloud Data Agent Kit mengharuskan Anda menginstal software tambahan setelah Anda menginstal ekstensi. Dalam beberapa kasus, Anda akan diminta untuk menyetujui penginstalan otomatis. Dalam kasus lain, Anda harus menginstal software secara manual.

Orchestration Pipelines

Untuk menggunakan Orchestration Pipelines di IDE Anda, instal yang berikut:

• dbt CLI
• CLI Dataform

Notebook

Notebook yang dihasilkan Google Cloud Data Agent Kit mencakup sel %pip install --upgrade bigframes yang dikomentari. Jika BigQuery DataFrames belum diinstal di kernel Anda, hapus komentar dan jalankan sel tersebut sebelum Anda menjalankan bagian notebook lainnya.

Untuk mengizinkan agen menjalankan sel kode di notebook Anda, Anda dapat mengaktifkan setelan google.datacloud.executeCellToolForNotebookMCP di setelan IDE Anda. Setelan ini mengaktifkan alat execute_cell untuk Notebook Model Context Protocol (MCP).

Penting: Mengizinkan agen untuk mengeksekusi sel kode di notebook Anda adalah kemampuan yang canggih dan harus diaktifkan dengan hati-hati. Anda harus memulai ulang IDE setelah mengubah setelan ini.

Memecahkan masalah

Jika Anda mengalami masalah, coba logout dari Google Cloud Data Agent Kit dan gcloud CLI, lalu login lagi. Untuk menemukan metode tambahan dalam mendiagnosis dan menyelesaikan error konfigurasi, lihat Memecahkan Masalah Data Agent Kit.

Melaporkan masalah

Untuk melaporkan masalah, lakukan tindakan berikut:

1. Di menu Google Cloud Data Agent Kit di panel aktivitas, klik Laporkan bug.
2. Di formulir yang terbuka, dokumentasikan masalahnya, lalu klik Kirim.

Langkah berikutnya

• Mentransformasi data menggunakan Data Agent Kit
• Memitigasi risiko injeksi perintah
• Mencoba codelab yang menggunakan Data Agent Kit