Halaman ini menjelaskan cara menyiapkan Gemini Code Assist Standard dan Enterprise.
Sebelum dapat menggunakan layanan yang tersedia bagi pengguna dengan lisensi Gemini Code Assist Standard atau Enterprise, tim Anda perlu melakukan langkah-langkah penyiapan yang dijelaskan dalam dokumen ini:
Aktifkan Gemini for Google Cloud API di Google Cloud project.
Memberi peran Identity and Access Management (IAM) dalam Google Cloud project.
Pengguna organisasi Anda menyiapkan layanan yang ingin mereka gunakan.
Untuk menggunakan Gemini Code Assist Standard atau Enterprise di IDE, pengguna harus menginstal plugin Gemini Code Assist, yang didokumentasikan di halaman ini.
Untuk menggunakan penyesuaian kode Gemini Code Assist, pengguna harus merujuk ke Mengonfigurasi penyesuaian kode Gemini Code Assist.
Untuk menggunakan Gemini CLI, pengguna harus mengikuti petunjuk penginstalan Gemini CLI, lalu mereka harus mengautentikasi dengan menetapkan Google Cloud project.
Untuk menggunakan Gemini di Android Studio, pengguna harus membaca Mulai menggunakan Gemini di Android Studio untuk bisnis.
Membeli langganan Gemini Code Assist
Untuk membeli langganan Gemini Code Assist baru, hubungi Google Cloud penjualan. Untuk mengetahui daftar fitur yang tersedia di setiap edisi Gemini Code Assist, lihat Fitur yang didukung.
Jika sudah memiliki langganan Gemini Code Assist, Anda dapat mengelola dan memperbaruinya melalui konsol Google Cloud .
Menetapkan lisensi
Setelah langganan dibeli untuk Gemini Code Assist Standard atau Enterprise, Anda dapat mengelola penetapan lisensi Gemini Code Assist di organisasi menggunakan konsol Google Cloud .
Sebelum menggunakan lisensi Gemini Code Assist, pengguna harus memiliki peran Pengguna Gemini untuk Google Cloud atau izin serupa di project tempat API sudah diaktifkan.
Secara default, langganan baru disiapkan untuk penetapan lisensi otomatis. Pengguna di organisasi Anda otomatis diberi lisensi saat mereka menggunakan Gemini Code Assist dalam IDE yang didukung, asalkan semua persyaratan berikut terpenuhi:
- Pengguna telah memilih project yang terkait dengan akun penagihan langganan.
- Pengguna memiliki izin IAM
cloudaicompanion.licenses.selfAssigndi project yang dipilih.
Jika lisensi tidak aktif selama 30 hari, lisensi tersebut akan otomatis ditetapkan kepada pengguna lain di organisasi Anda yang memenuhi kondisi sebelumnya.
Jika semua lisensi yang tersedia dalam langganan telah ditetapkan, pengguna yang mencoba mengakses Gemini Code Assist tanpa lisensi akan menerima pesan error yang menunjukkan bahwa lisensi diperlukan.
Setelah menyiapkan Gemini Code Assist, Anda dapat melihat penetapan lisensi dengan membuka halaman Admin untuk Gemini, memilih akun penagihan, mengklik Kelola Langganan Gemini Code Assist, lalu memilih tab Pengelolaan lisensi. Jika memerlukan kontrol yang lebih baik atas penetapan lisensi, Anda juga dapat menggunakan tab ini untuk beralih dari pengelolaan lisensi otomatis ke pengelolaan lisensi manual.
Gemini for Google Cloud API harus diaktifkan di satu atau beberapa project yang terkait dengan akun penagihan ini. Pengguna tidak akan melihat Gemini Code Assist hingga Anda mengaktifkannya di setidaknya satu project.
Mengaktifkan Gemini for Google Cloud API di sebuah Google Cloud project
Bagian ini menjelaskan langkah-langkah yang diperlukan untuk mengaktifkan Gemini for Google Cloud API di Google Cloud project. Gemini Code Assist memerlukan Google Cloud project untuk mengelola akses API, kuota, dan penagihan. Oleh karena itu, Anda harus mengaktifkan Gemini for Google Cloud API di Google Cloud project pilihan Anda sebelum pengguna dapat mengakses Gemini Code Assist.
Konsol
Untuk mengaktifkan Gemini for Google Cloud API, buka halaman Gemini untuk Google Cloud.
Di pemilih project, pilih project.
Klik Enable.
Halaman diperbarui dan menampilkan status Diaktifkan. Gemini kini tersedia di project Google Cloud yang dipilih untuk semua pengguna yang memiliki peran IAM yang diperlukan.
gcloud CLI
-
Di konsol Google Cloud , aktifkan Cloud Shell.
Di menu pemilih project, pilih project.
Aktifkan Gemini for Google Cloud API untuk Gemini menggunakan perintah
gcloud services enable:gcloud services enable cloudaicompanion.googleapis.comJika Anda ingin mengaktifkan Gemini for Google Cloud API di project Google Cloud lain, tambahkan parameter
--project:gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_IDGanti
PROJECT_IDdengan project ID Google Cloud Anda.Outputnya mirip dengan hal berikut ini:
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete... Operation finished successfully.
Fitur Gemini kini tersedia di Google Cloud project yang ditentukan untuk semua pengguna yang memiliki peran IAM yang diperlukan.
Konfigurasi firewall untuk traffic API antara IDE dan Google
Selain mengaktifkan Gemini for Google Cloud API, pengguna di balik firewall juga perlu mengizinkan traffic untuk melewati API berikut:
oauth2.googleapis.com: digunakan untuk login ke Google Cloud.serviceusage.googleapis.com: digunakan untuk memeriksa apakah project Gemini Code Assist pengguna dikonfigurasi dengan benar.cloudaicompanion.googleapis.com: endpoint API Gemini Code Assist utama.cloudcode-pa.googleapis.com: API internal yang menyediakan fitur terkait IDE.cloudresourcemanager.googleapis.com: digunakan di IDE untuk pemilih project. Resource Manager API mungkin tidak diperlukan jika project dikonfigurasi secara eksplisit dalam filesettings.jsonAnda.people.googleapis.com: memberikan akses ke informasi tentang profil dan kontak.firebaselogging-pa.googleapis.com: API internal yang digunakan untuk mengirim telemetri produk, termasuk peristiwa terkait apakah saran diterima atau tidak.feedback-pa.googleapis.com: API internal yang digunakan untuk pengiriman masukan dalam IDE.apihub.googleapis.com: digunakan oleh fitur Cloud Code API Browser.lh3.googleusercontent.comdanlh5.googleusercontent.com: digunakan untuk mendapatkan foto pengguna.
Menentukan alamat IP untuk Google Cloud domain default
Untuk mengaktifkan konektivitas dari IDE ke Google Cloud API, firewall Anda harus mengizinkan traffic TCP keluar ke rentang alamat IP yang didokumentasikan secara publik oleh Google. Rentang ini dikelola secara dinamis oleh Google.
Untuk mengelola daftar rentang IP guna mengakses Google Cloud domain, Anda memiliki beberapa opsi:
- Gunakan daftar yang kami publikasikan atau otomatiskan skrip untuk mendapatkan rentang alamat IP Google.
- Gunakan IP Virtual private.googleapis.com.
- Gunakan Private Service Connect.
Opsional: Mengonfigurasi Kontrol Layanan VPC
Jika organisasi Anda memiliki perimeter layanan, Anda harus menambahkan resource berikut ke perimeter Anda:
- Gemini for Google Cloud API
- Gemini Code Assist API
Jika Anda menggunakan Gemini Code Assist Standard atau Enterprise dari luar perimeter layanan, Anda juga perlu mengubah kebijakan ingress untuk mengizinkan akses ke layanan tersebut.
Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi Kontrol Layanan VPC untuk Gemini.
Memberikan peran IAM dalam Google Cloud project
Bagian ini menjelaskan langkah-langkah yang diperlukan untuk memberikan peran IAM Pengguna Gemini untuk Google Cloud dan Konsumen Penggunaan Layanan kepada pengguna.
Konsol
Untuk memberikan peran IAM yang diperlukan untuk menggunakan Gemini, buka halaman IAM & Admin.
Klik Berikan akses, lalu masukkan nama pengguna yang ingin Anda beri akses ke Gemini.
Di panel Berikan akses, klik Tambahkan peran lain.
Di Tetapkan peran, pilih Gemini untuk Google Cloud User.
Klik Add roles, lalu pilih Service Usage Consumer.
Klik Simpan.
gcloud CLI
-
Di konsol Google Cloud , aktifkan Cloud Shell.
Di menu pemilih project, pilih project.
Berikan peran Pengguna Gemini untuk Google Cloud:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/cloudaicompanion.user
Ganti kode berikut:
PROJECT_ID: ID project Google Cloud Anda—misalnya,my-project-id.PRINCIPAL: ID untuk akun utama. Untuk akun pengguna, ID ini dalam formatuser:EMAIL_ADDRESS—misalnya,user:cloudysanfrancisco@gmail.com.
Outputnya adalah daftar binding kebijakan yang mencakup hal berikut:
- members: - user:PRINCIPAL role: roles/cloudaicompanion.userUlangi langkah sebelumnya untuk peran
roles/serviceusage.serviceUsageConsumer.
Untuk mengetahui informasi selengkapnya, lihat
Memberikan satu peran
dan
gcloud projects add-iam-policy-binding.
Semua pengguna yang telah diberi peran ini dapat mengakses fitur Gemini di konsol Google Cloud dalam project yang ditentukan. Untuk mengetahui informasi selengkapnya, lihat RingkasanGoogle Cloud dengan Gemini.
Menginstal plugin Gemini Code Assist
Pengguna organisasi Anda menginstal plugin Gemini Code Assist di IDE yang didukung pilihan mereka. Pengguna IDE JetBrains yang didukung harus mengikuti petunjuk IntelliJ.
VS Code
Untuk membuka tampilan Ekstensi di VS Code, klik
Ekstensi atau tekan Ctrl/Cmd+Shift+X.Telusuri
Gemini Code Assist.Klik Instal.
Jika diminta, mulai ulang VS Code.
Setelah berhasil diinstal, Gemini Code Assist akan muncul di panel aktivitas dan siap digunakan. Anda dapat mengonfigurasi lebih lanjut penginstalan Gemini Code Assist dengan menentukan preferensi menggunakan panel tugas aplikasi tingkat teratas: buka Code > Settings > Settings > Extensions, lalu telusuri
Gemini Code Assist.
IntelliJ
- Klik settings IDE and Project Settings > Plugins.
- Di tab Marketplace, telusuri
Gemini Code Assist. - Klik Instal untuk menginstal plugin.
- Setelah penginstalan selesai, klik Restart IDE.
Saat IDE dimulai ulang, Gemini Code Assist akan muncul di panel aktivitas Anda.
Sekarang pengguna siap menggunakan Gemini Code Assist Standard atau Enterprise di IDE mereka. Pelajari lebih lanjut fitur yang didukung:
Mulai dengan panduan berikut:
Daftar direktori tempat Gemini Code Assist menyimpan informasi dalam cache
Tabel berikut berisi daftar direktori tempat Gemini Code Assist menyimpan informasi ekstensi seperti token autentikasi:
Windows
%LOCALAPPDATA%/cloud-code%LOCALAPPDATA%/google-vscode-extension
macOS
~/Library/Application Support/cloud-code~/Library/Application Support/google-vscode-extension
Linux
~/.cache/cloud-code~/.cache/google-vscode-extension
Login ke Google dan pilih project Google Cloud
Setelah menginstal Gemini Code Assist di IDE, pengguna harus login ke Akun Google mereka. Jika ini adalah pertama kalinya mereka menggunakan Gemini Code Assist Standard atau Enterprise di IDE, mereka harus memilih Google Cloud project. Project ini sama dengan project yang digunakan untuk menyiapkan Gemini Code Assist, dan digunakan untuk mengelola akses API, kuota, dan penagihan.
VS Code
Jika Anda memilih Google Cloud project yang belum mengaktifkan Gemini for Google Cloud API, Anda akan menerima notifikasi yang memberi Anda opsi untuk mengaktifkan API dari IDE. Pilih Enable the API di jendela notifikasi untuk mengaktifkan API untuk project Anda.
Jika Anda lebih suka mengikuti panduan Menggunakan Kode dengan Gemini Code Assist langsung di IDE, klik Luncurkan VS Code dan ikuti langkah-langkah dalam panduan untuk terhubung ke Google Cloud dan mengaktifkan Gemini Code Assist Standard atau Enterprise.
Atau, ikuti langkah-langkah berikut:
Luncurkan IDE Anda.
Di panel aktivitas, klik Gemini Code Assist.
Di panel chat Gemini Code Assist, klik Login ke Google Cloud.
Saat diminta untuk mengizinkan Gemini Code Assist membuka situs eksternal, klik Open.
Ikuti petunjuk untuk login ke Akun Google Anda.
Saat ditanya apakah Anda mendownload Gemini Code Assist dari Google, klik Sign In.
Anda kini terhubung ke Google Cloud.
Selanjutnya, untuk memilih Google Cloud project yang telah mengaktifkan Gemini for Google Cloud API, ikuti langkah-langkah berikut:
Di status bar Gemini Code Assist, klik Gemini Code Assist.
Di menu Gemini Code Assist, pilih Select Gemini Code project.
Pilih project Google Cloud yang telah mengaktifkan Gemini for Google Cloud API.
Gemini Code Assist Standard atau Enterprise siap digunakan.
IntelliJ
Untuk login ke Akun Google Anda, ikuti langkah-langkah berikut:
Di panel aktivitas, klik spark Gemini Code Assist.
Klik Login ke Google. Atau, Anda dapat mengklik Salin link dan menempelkan URL ke browser Anda.
Di halaman yang terbuka di browser web, pilih Akun Google Anda.
Di layar yang meminta Anda untuk memastikan bahwa Anda mendownload aplikasi ini dari Google, klik Login.
Gemini Code Assist kini diizinkan untuk mengakses akun Anda.
Selanjutnya, jika ini pertama kalinya Anda menggunakan Gemini Code Assist Standard atau Enterprise di IDE, Anda harus memilih Google Cloud project dengan mengikuti langkah-langkah berikut:
Kembali ke IDE Anda. Di jendela alat Gemini Code Assist, jika Anda setuju untuk mengizinkan Google mengaktifkan API yang diperlukan untuk menggunakan Gemini Code Assist atas nama Anda untuk project yang dipilih, klik Select a GCP project untuk melanjutkan.
Dalam dialog Select Google Cloud Project, telusuri dan pilih project Google Cloud Anda, lalu klik OK.
Klik SELESAI.
Project Google Cloud Anda dipilih dengan Gemini Code Assist API yang diaktifkan. Anda siap menggunakan Gemini Code Assist Standard atau Enterprise di IDE Anda.
Tugas penyiapan lanjutan
Bagian berikut menjelaskan tugas penyiapan lanjutan yang dapat Anda lakukan untuk menyesuaikan Gemini Code Assist.
Pertimbangan IAM lanjutan
Daripada menggunakan konsol Google Cloud atau gcloud CLI untuk memberikan peran IAM standar, Anda dapat melakukan salah satu hal berikut:
Gunakan IAM REST API atau library klien IAM untuk memberikan peran.
Jika Anda menggunakan antarmuka ini, gunakan nama peran yang sepenuhnya memenuhi syarat:
roles/cloudaicompanion.userroles/serviceusage.serviceUsageConsumer
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Membuat dan memberikan peran khusus.
Peran khusus yang Anda buat harus memiliki izin berikut agar Anda dapat mengakses Gemini Code Assist Standard dan Enterprise:
cloudaicompanion.instances.completeCodecloudaicompanion.instances.completeTaskcloudaicompanion.instances.generateCodecloudaicompanion.instances.generateTextcloudaicompanion.instances.exportMetricscloudaicompanion.instances.queryEffectiveSettingcloudaicompanion.instances.queryEffectiveSettingBindingsserviceusage.services.enable
Menetapkan dan mengelola lisensi.
Peran khusus yang Anda buat memerlukan izin berikut agar Anda dapat menetapkan dan mengelola lisensi Gemini Code Assist:
consumerprocurement.orders.getconsumerprocurement.orders.licensePools.*consumerprocurement.orders.licensePools.updateconsumerprocurement.orders.licensePools.getconsumerprocurement.orders.licensePools.assignconsumerprocurement.orders.licensePools.unassignconsumerprocurement.orders.licensePools.enumerateLicensedUsers
Perhatikan juga bahwa agar izin sebelumnya dapat berfungsi, Gemini for Google Cloud API harus diaktifkan di project yang sama Google Cloud tempat Anda menetapkan setiap izin.
Mengubah Google Cloud saluran rilis project
Kami merilis fitur Gemini Code Assist di berbagai saluran rilis, baik Tersedia Umum maupun Pratinjau. Saat Anda menyiapkan Gemini Code Assist, project Anda akan otomatis disetel ke saluran rilis Tersedia Secara Umum.
Anda dapat mengubah saluran rilis Gemini Code Assist ke saluran Pratinjau atau kembali ke saluran Tersedia Secara Umum kapan saja.
Langkah berikutnya
- Pelajari lebih lanjut jenis bantuan AI generatif yang tersedia di Google Cloud.
- Pelajari cara mengakses dan mengelola kontrol administrator Gemini Code Assist Standard dan Enterprise.
- Pelajari cara mengonfigurasi logging multi-project.
- Konfigurasi Kontrol Layanan VPC untuk Gemini Code Assist Standard dan Enterprise.