Menggunakan Antigravity CLI

Menggunakan Antigravity CLI

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara menggunakan antarmuka command line (CLI) Antigravity dengan instance Gemini Enterprise Agent Platform Workbench.

Dokumen ini ditujukan untuk analis data, data scientist, dan developer data yang menggunakan Workbench Platform Agen. Dokumen ini mengasumsikan bahwa Anda memiliki pengetahuan tentang cara menulis kode di lingkungan notebook.

Ringkasan

Antigravity CLI adalah platform yang mengutamakan terminal dari Google Antigravity, sebuah agen coding AI yang berjalan di terminal. Untuk mengetahui informasi selengkapnya, lihat antigravity.google.

Antigravity CLI tersedia di terminal di antarmuka JupyterLab instance Agent Platform Workbench Anda. Anda dapat menggunakannya untuk bekerja dengan notebook dan file di instance Anda, serta untuk menjalankan perintah shell dan perintah Google Cloud , dengan memberikan petunjuk dalam bahasa alami.

Agent Platform Workbench menambahkan hal berikut ke Antigravity CLI:

• Kemampuan notebook yang membuat, menjelaskan, mengedit, memeriksa, dan menjalankan notebook, serta membuat kernel Jupyter.
• PluginGoogle Cloud dengan dokumentasi dan panduan Google Cloud untuk perintah gcloud.
• Cell magic %%agy, yang menulis kode untuk sel notebook dari deskripsi Anda.

Batasan

Pertimbangkan batasan berikut saat Anda menggunakan Antigravity CLI dengan Agent Platform Workbench:

• Antigravity CLI hanya tersedia dalam bentuk CLI. Antarmuka chat grafis dan alat lanjutan dalam editor tidak disertakan.

• Saat Anda meminta Antigravity CLI untuk mengubah notebook, alat ini akan mengubah file notebook langsung di disk instance. Akibatnya, Anda tidak dapat mengurungkan pengeditan yang dilakukan oleh Antigravity CLI menggunakan tombol Undo atau Control+Z (Command+Z di macOS) pada editor notebook. Namun, Anda dapat meminta Antigravity CLI untuk mengurungkan perubahan menggunakan perintah bahasa alami, seperti Undo your last change.

• Antigravity CLI menulis langsung ke disk dan dapat mengubah file yang juga Anda buka di JupyterLab. Jika Anda memiliki perubahan yang belum disimpan di notebook, simpan perubahan tersebut sebelum meminta Antigravity CLI untuk mengubah notebook yang sama.

• Antigravity CLI disematkan ke versi yang disertakan dalam image instance Anda, dan tidak dapat diupdate secara otomatis. Untuk menggunakan versi yang lebih baru, upgrade instance Anda ke versi image yang lebih baru. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade lingkungan instance.

• Antigravity CLI berjalan dengan kredensial yang aktif di instance Anda. Secara default, kredensial ini adalah kredensial akun layanan instance Agent Platform Workbench Anda, sehingga Antigravity CLI dapat mengakses resource yang sama dengan yang dapat diakses instance. Jika Anda mengautentikasi identitas yang berbeda pada instance (misalnya, dengan menjalankan gcloud auth login atau gcloud auth application-default login), Antigravity CLI akan menggunakan izin identitas tersebut.

Sebelum memulai

Sebagai teknologi tahap awal, produk Gemini untuk Google Cloud dapat menghasilkan output yang tampaknya masuk akal tetapi sebenarnya tidak benar. Sebaiknya Anda memvalidasi semua output dari produk Gemini untuk Google Cloud sebelum Anda menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Gemini untuk Google Cloud dan responsible AI.

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Agent Platform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Agent Platform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Peran yang diperlukan

Untuk menggunakan Antigravity CLI di Agent Platform Workbench, Anda harus memberikan izin kepada pengguna instance Agent Platform Workbench dan akun layanan instance.

Catatan: CLI Antigravity beroperasi secara ketat dalam izin lingkungan instance Agent Platform Workbench Anda. Jika Anda (atau akun layanan yang digunakan instance Anda) tidak memiliki izin untuk mengakses resource tertentu, Antigravity CLI juga tidak akan dapat mengaksesnya. Jika perintah gagal karena izin, minta administrator Anda untuk memberikan izin yang diperlukan.

Memberikan izin kepada pengguna instance

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan Antigravity CLI di instance Agent Platform Workbench, minta administrator untuk memberi Anda peran IAM Agent Platform User (roles/aiplatform.user) di project. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Memberikan izin ke akun layanan instance Anda

Untuk memastikan bahwa akun layanan instance Agent Platform Workbench Anda memiliki izin yang diperlukan untuk mengaktifkan Antigravity CLI agar berjalan di instance Agent Platform Workbench, minta administrator untuk memberikan peran IAM Agent Platform User (roles/aiplatform.user) ke akun layanan instance Agent Platform Workbench Anda di project.

Penting: Anda harus memberikan peran ini ke akun layanan instance Agent Platform Workbench, bukan ke akun pengguna Anda. Kegagalan dalam memberikan peran ke akun utama yang benar dapat menyebabkan error izin.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin aiplatform.endpoints.predict, yang diperlukan untuk memungkinkan Antigravity CLI berjalan di instance Agent Platform Workbench.

Administrator Anda mungkin juga dapat memberi akun layanan instance Agent Platform Workbench izin ini dengan peran khusus atau peran bawaan lainnya.

Mengaktifkan Antigravity CLI

Antigravity CLI hanya tersedia di instance Agent Platform Workbench yang menggunakan image Debian 12 (workbench-instances-2603) atau yang lebih baru. Agen ini tidak diinstal pada instance yang menggunakan image Debian 11 (workbench-instances).

Instance baru mengaktifkan Antigravity CLI secara default. Jika Anda tidak menetapkan kunci metadata instance enable-antigravity saat membuat instance, Agent Platform Workbench akan menetapkannya ke true.

Untuk menonaktifkan atau mengaktifkan Antigravity CLI untuk sebuah instance, tetapkan kunci metadata instance enable-antigravity ke false atau true, lalu hentikan dan mulai instance. Instance akan menerapkan setelan saat dimulai. Untuk mengetahui informasi selengkapnya, lihat Mengelola fitur melalui metadata.

Menggunakan Antigravity CLI

1. Di konsol Google Cloud , buka halaman Instances.

   Buka Instances

2. Di samping nama instance Agent Platform Workbench, klik Open JupyterLab.

3. Di JupyterLab, klik File > New launcher.

4. Di tab Launcher, di bagian Other, klik tile Antigravity CLI.

   Terminal akan terbuka dan memulai Antigravity CLI. Anda juga dapat memasukkan agy di terminal JupyterLab mana pun.

5. Masukkan perintah, seperti "Buat notebook baru bernama 'test-notebook'". Untuk contoh lainnya, lihat Contoh perintah.

6. Saat Antigravity CLI mengusulkan tindakan, seperti mengedit file atau menjalankan perintah shell, tinjau dan setujui atau tolak tindakan tersebut. Untuk mengetahui informasi selengkapnya, lihat Menyetujui tindakan alat.

Keterampilan notebook dan plugin Google Cloud

Keahlian adalah petunjuk dan skrip yang digunakan Antigravity CLI untuk jenis tugas tertentu. Saat Antigravity CLI aktif, Agent Platform Workbench memberinya kemampuan notebook berikut:

• Penarget notebook: menemukan notebook yang Anda buka di JupyterLab, sehingga Anda dapat menyebutnya sebagai "notebook ini".
• Penjelas notebook: meringkas sel notebook dan output teksnya.
• Pengubah notebook: menambahkan dan mengedit sel. Tindakan ini hanya mengubah sel target dan mempertahankan notebook dalam format yang digunakan JupyterLab.
• Validator notebook: memeriksa apakah notebook valid. NotebookLM akan meminta persetujuan Anda sebelum memperbaiki notebook yang sudah tidak valid.
• Pembuat notebook: membuat notebook dengan kernel yang tersedia di instance.
• Notebook executor: menjalankan notebook di kernel instance dan menyimpan output. Jika sel gagal, sel tersebut akan diberi nama.
• Pembuat kernel: membuat lingkungan Python dan kernel Jupyter dengan paket yang Anda minta.

Antigravity CLI juga dilengkapi dengan plugin google-cloud-developer dari marketplace plugin Antigravity. Plugin ini memberikan panduan Antigravity CLI untuk perintah gcloud, bantuan terkait autentikasi, dokumentasi Google Cloud , dan keterampilan untuk produk seperti Cloud Logging, Cloud Monitoring, dan Agent Platform.

Antigravity CLI menggunakan keahlian atau plugin saat perintah Anda membutuhkannya. Anda tidak perlu menyebutkan namanya dalam perintah.

Contoh perintah

Untuk mendapatkan ide tentang cara menggunakan Antigravity CLI, lihat contoh perintah berikut:

• "Jelaskan notebook ini."

• "Tambahkan sel ke notebook ini yang memetakan distribusi kolom 'age'."

• "Buat notebook yang memuat bigquery-public-data.ml_datasets.census_adult_income ke dalam DataFrame pandas, lalu jalankan."

• "Buat kernel bernama 'forecast' dengan pandas dan prophet."

• "Pastikan setiap notebook dalam direktori ini adalah notebook yang valid."

• "Buat kueri tabel bigquery-public-data.ml_datasets.census_adult_income untuk menemukan jumlah orang dengan kelompok pendapatan >50K."

Menggunakan magic cell %%agy

Agar Antigravity CLI menulis kode untuk sel di notebook Anda, lakukan hal berikut:

1. Pada baris pertama sel baru di notebook Python, masukkan %%agy.
2. Pada baris berikutnya di sel yang sama, jelaskan kode yang Anda inginkan.
3. Jalankan sel.

Antigravity CLI akan menambahkan sel baru di bawah dengan kode tersebut. Tinjau kode sebelum Anda menjalankannya.

Magic cell %%agy dirancang khusus untuk membuat kode. Tidak seperti antarmuka terminal, cell magic tidak dapat meminta persetujuan Anda, sehingga secara otomatis menolak tindakan apa pun yang memerlukan persetujuan, seperti menjalankan perintah shell.

Magic cell %%agy tersedia setiap kali Antigravity CLI diaktifkan.

Menyetujui tindakan alat

Secara default, Antigravity CLI di Agent Platform Workbench meminta persetujuan Anda sebelum melakukan tindakan apa pun, seperti mengedit file, menjalankan perintah shell, atau mengambil URL. Tinjau setiap tindakan yang diusulkan sebelum Anda menyetujuinya.

Setelan default ini melindungi dari injeksi perintah. Notebook, skrip, atau halaman web yang dibaca Antigravity CLI dapat berisi petunjuk tersembunyi yang mencoba membuat agen menjalankan perintah yang tidak Anda inginkan, seperti mengirim data Anda ke alamat eksternal. Antigravity CLI berjalan dengan kredensial instance Anda, sehingga mewajibkan persetujuan memberi Anda kesempatan untuk melihat dan menghentikan tindakan tersebut sebelum dijalankan.

Oleh karena itu, opsi untuk melewati perintah persetujuan dinonaktifkan untuk Antigravity CLI di instance Agent Platform Workbench.

Mengontrol akses ke Antigravity CLI

Anda dapat mengontrol akses ke Antigravity CLI di Agent Platform Workbench dengan menggunakan metode berikut:

• Administrator dapat menetapkan kunci metadata instance enable-antigravity ke false. Kartu Antigravity CLI, keterampilan notebook, plugin, dan magic cell %%agy kemudian akan dihapus pada awal instance berikutnya. Perintah agy tetap terinstal. Untuk mencegah panggilan model, gunakan metode berikut.

• Administrator dapat menyiapkan kebijakan organisasi untuk membatasi penggunaan model tertentu di tingkat organisasi, folder, atau project. Lihat Mengontrol akses ke model Model Garden.

• Dengan tidak memberikan izin aiplatform.endpoints.predict, administrator dapat memblokir beberapa identitas agar tidak dapat menggunakan endpoint model untuk inferensi.

Langkah berikutnya

• Pelajari lebih lanjut Gemini Enterprise Agent Platform.

• Untuk mempelajari cara menetapkan metadata instance, lihat Mengelola fitur melalui metadata.