Menyiapkan Gemini Code Assist Standard dan Enterprise

Sebelum dapat menggunakan Gemini Code Assist Standard atau Enterprise, tim Anda harus melakukan langkah-langkah penyiapan yang dijelaskan dalam dokumen ini:

Catatan: Administrator biasanya melakukan langkah 1-4.

1. Beli langganan Gemini Code Assist Standard atau Enterprise.

2. Tetapkan lisensi kepada pengguna di organisasi Anda.

3. Aktifkan Gemini for Google Cloud API di project Google Cloud.

4. Memberikan peran Identity and Access Management di project Google Cloud.

5. Pengguna organisasi Anda menginstal plugin Gemini Code Assist untuk menggunakan Gemini Code Assist Standard atau Enterprise di IDE. Langkah ini tidak diperlukan untuk pengguna Gemini CLI atau pengguna Gemini di Android Studio.

Membeli langganan Gemini Code Assist

Untuk mengetahui daftar fitur yang tersedia di setiap edisi, lihat Fitur yang didukung.

Untuk pelanggan baru Gemini Code Assist dengan akun penagihan yang belum pernah memiliki langganan Gemini Code Assist, kami akan otomatis menerapkan kredit yang setara dengan hingga 50 lisensi gratis untuk bulan pertama, terlepas dari edisi Gemini Code Assist. Perhatikan bahwa Anda tidak dapat menambah jumlah kredit gratis setelah kredit lisensi gratis awal dialokasikan. Selain itu, Anda tidak dapat mengubah edisi Gemini Code Assist dalam bulan pertama.

Jika Anda memiliki kontrak yang sudah ada dengan Google Cloud, hubungi tim penjualan kami sebelum membeli langganan.

Catatan: Anda harus memiliki izin Identity and Access Management di akun penagihan untuk membeli langganan Gemini.consumerprocurement.orders.place Izin consumerprocurement.orders.place disertakan dalam peran IAM roles/billing.admin atau peran roles/consumerprocurement.orderAdmin. Atau, Anda dapat menambahkan izin ke peran khusus.

1. Buka halaman Admin untuk Gemini.

   Buka Admin untuk Gemini

   Halaman Admin untuk Gemini akan terbuka.

2. Pilih Dapatkan Gemini Code Assist.

   Perhatikan bahwa jika Anda tidak memiliki izin consumerprocurement.orders.place yang diperlukan, tombol ini akan dinonaktifkan. Jika langganan Gemini Code Assist sudah ada untuk akun penagihan yang terkait dengan project, tombol ini akan ditampilkan sebagai Kelola Gemini Code Assist dan memungkinkan Anda mengedit langganan.

   Halaman Dapatkan langganan Gemini Code Assist akan terbuka.

3. Di Select Gemini Code Assist subscription Edition, pilih edisi Gemini Code Assist. Pilih Bandingkan Edisi Gemini Code Assist untuk melihat daftar detail fitur yang tersedia untuk setiap edisi.

   Kemudian, pilih Lanjutkan.

4. Di Configure subscription, isi kolom untuk mengonfigurasi langganan, termasuk hal berikut:

   • Nama langganan.
   • Jumlah lisensi dalam langganan. Perhatikan bahwa jika Anda membeli edisi Enterprise, Anda harus membeli minimal 10 lisensi.
   • Periode langganan (bulanan atau tahunan). Dengan langganan tahunan, Anda akan mendapatkan tarif diskon yang ditagih setiap bulan, bukan pembayaran satu kali.

   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 kondisi berikut terpenuhi:

   • Pengguna telah memilih project yang terkait dengan akun penagihan langganan.
   • Pengguna memiliki izin IAM cloudaicompanion.licences.selfAssign pada project yang dipilih.

   Setelah menyiapkan Gemini Code Assist, Anda dapat memilih untuk menetapkan lisensi secara manual.

5. Untuk mengonfirmasi langganan, pilih Lanjutkan.

6. Jika Anda menyetujui persyaratannya, pilih I agree to the terms of this purchase, lalu pilih Confirm subscription.

7. Pilih Berikutnya: Kelola Penetapan Lisensi Gemini.

Langganan kini dibeli untuk Gemini Code Assist Standard atau Enterprise. Sekarang Anda perlu mengelola penetapan lisensi Gemini di organisasi Anda.

Menetapkan lisensi

Sebelum menggunakan lisensi Gemini Code Assist, pengguna harus memiliki peran Pengguna Gemini untuk Google Cloud atau izin serupa di project tempat API sudah diaktifkan.

Untuk pelanggan baru Gemini Code Assist dengan akun penagihan yang belum pernah memiliki langganan Gemini Code Assist, kami akan otomatis menerapkan kredit yang setara dengan hingga 50 lisensi gratis untuk bulan pertama, terlepas dari edisi Gemini Code Assist. Perhatikan bahwa Anda tidak dapat menambah jumlah kredit gratis setelah kredit lisensi gratis awal dialokasikan. Selain itu, Anda tidak dapat mengubah edisi Gemini Code Assist dalam bulan pertama.

Secara default, langganan baru disiapkan untuk penetapan lisensi otomatis. Pengguna di organisasi Anda akan otomatis diberi lisensi saat mereka menggunakan Gemini Code Assist dalam IDE yang didukung, asalkan semua kondisi berikut terpenuhi:

• Pengguna telah memilih project yang terkait dengan akun penagihan langganan.
• Pengguna memiliki izin IAM cloudaicompanion.licences.selfAssign pada 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.

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 API untuk Google Cloud 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 project Cloud

Bagian ini menjelaskan langkah-langkah yang diperlukan untuk mengaktifkan Gemini for Google Cloud API di project Cloud. Gemini Code Assist memerlukan project Cloud untuk mengelola akses API, kuota, dan penagihan. Oleh karena itu, Anda perlu mengaktifkan Gemini for Google Cloud API di project Cloud pilihan Anda sebelum pengguna dapat mengakses Gemini Code Assist.

Konsol

1. Untuk mengaktifkan Gemini for Google Cloud API, buka halaman Gemini for Google Cloud.

   Buka Gemini untuk Google Cloud

2. Di pemilih project, pilih project.

3. Klik Enable.

   Halaman diperbarui dan menampilkan status Diaktifkan. Gemini kini tersedia di project Cloud yang dipilih untuk semua pengguna yang memiliki peran IAM yang diperlukan.

gcloud

Untuk menggunakan lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI.

1. Di menu pemilih project, pilih project.

2. Aktifkan Gemini for Google Cloud API untuk Gemini menggunakan perintah gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Jika Anda ingin mengaktifkan Gemini for Google Cloud API di project Cloud lain, tambahkan parameter --project:

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   Ganti PROJECT_ID dengan 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.
   

Gemini untuk Google Cloud kini tersedia di project Cloud 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, pengguna di balik firewall juga perlu mengizinkan lalu lintas 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 telah dikonfigurasi dengan benar.
• cloudaicompanion.googleapis.com: endpoint Gemini for Google Cloud API 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 file settings.json Anda.
• 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.com dan lh5.googleusercontent.com: digunakan untuk mendapatkan foto pengguna.

Menentukan alamat IP untuk domain default Google Cloud

Untuk mengaktifkan konektivitas dari IDE Anda 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 domain Google Cloud, 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 project Google Cloud

Bagian ini menjelaskan langkah-langkah yang diperlukan untuk memberikan peran IAM Pengguna Gemini untuk Google Cloud dan Konsumen Penggunaan Layanan kepada pengguna.

Konsol

1. Untuk memberikan peran IAM yang diperlukan untuk menggunakan Gemini, buka halaman IAM & Admin.

   Buka IAM & Admin

2. Klik Berikan akses, lalu masukkan nama pengguna yang ingin Anda beri akses ke Gemini.

3. Di panel Berikan akses, klik Tambahkan peran lain.

4. Di Assign roles, pilih Gemini for Google Cloud User.

5. Klik Add roles, lalu pilih Service Usage Consumer.

6. Klik Simpan.

gcloud

Untuk menggunakan lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI.

1. Di menu pemilih project, pilih project.

2. 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 Cloud Anda—misalnya,1234567890.
   • PRINCIPAL: ID untuk akun utama—misalnya, user:[e-mail].

   Outputnya adalah daftar binding kebijakan yang mencakup hal berikut:

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

3. Ulangi 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 untuk Google Cloud di konsol Google Cloud dalam project yang ditentukan. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Gemini untuk Google Cloud.

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

1. Untuk membuka tampilan Ekstensi di VS Code, klik Ekstensi atau tekan Ctrl/Cmd+Shift+X.

2. Telusuri Gemini Code Assist.

3. Klik Instal.

4. Jika diminta, mulai ulang VS Code.

   Setelah ekstensi 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

1. Klik settings IDE and Project Settings > Plugins.
2. Di tab Marketplace, telusuri Gemini Code Assist.
3. Klik Instal untuk menginstal plugin.
4. Setelah penginstalan selesai, klik Restart IDE.

5. 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:

• Ringkasan fitur kode
• Ringkasan fitur Chat

Mulai dengan panduan berikut:

• Membuat Kode dengan Gemini Code Assist
• Mulai percakapan dengan Gemini Code Assist

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 project Google Cloud. 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 project Google Cloud tanpa 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. Untuk informasi selengkapnya, lihat Menyiapkan Gemini Code Assist Standard dan Enterprise untuk project.

Jika Anda lebih suka mengikuti panduan Mengode 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.

Luncurkan VS Code

Atau, ikuti langkah-langkah berikut:

1. Luncurkan IDE Anda.

2. Di panel aktivitas, klik Gemini Code Assist.

3. Di panel chat Gemini Code Assist, klik Login ke Google Cloud.

4. Saat diminta untuk mengizinkan Gemini Code Assist membuka situs eksternal, klik Open.

5. Ikuti petunjuk untuk login ke Akun Google Anda.

6. Saat ditanya apakah Anda mendownload Gemini Code Assist dari Google, klik Sign In.

   Catatan: Jika upaya login Anda terus mengalami waktu tunggu habis, lihat masalah umum Upaya login terus mengalami waktu tunggu habis untuk mengetahui informasi selengkapnya tentang pemecahan masalah.

   Anda kini terhubung ke Google Cloud.

   Selanjutnya, untuk memilih project Google Cloud yang telah mengaktifkan Gemini for Google Cloud API, ikuti langkah-langkah berikut:

7. Di status bar Gemini Code Assist, klik Gemini Code Assist.

   

8. Di menu Gemini Code Assist, pilih Select Gemini Code project.

9. Pilih project Google Cloud yang mengaktifkan Gemini API for Google Cloud.

   Gemini Code Assist Standard atau Enterprise siap digunakan.

   

IntelliJ

Untuk login ke Akun Google Anda, ikuti langkah-langkah berikut:

1. Di panel aktivitas, klik spark Gemini Code Assist.

2. Klik Login ke Google. Atau, Anda dapat mengklik Salin link dan menempelkan URL ke browser Anda.

3. Di halaman yang terbuka di browser web, pilih Akun Google Anda.

4. 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 project Google Cloud dengan mengikuti langkah-langkah berikut:

5. 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.

6. Pada dialog Select Google Cloud Project, telusuri dan pilih project Google Cloud Anda, lalu klik OK.

7. 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 untuk memberikan peran IAM yang telah ditentukan sebelumnya, 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.user
  • roles/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 memerlukan izin berikut agar Anda dapat mengakses Gemini Code Assist Standard dan Enterprise:

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.completeCode
  • cloudaicompanion.instances.completeTask
  • cloudaicompanion.instances.generateCode
  • cloudaicompanion.instances.generateText
  • cloudaicompanion.instances.exportMetrics
  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • serviceusage.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.get
  • consumerprocurement.orders.licensePools.*
  • consumerprocurement.orders.licensePools.update
  • consumerprocurement.orders.licensePools.get
  • consumerprocurement.orders.licensePools.assign
  • consumerprocurement.orders.licensePools.unassign
  • consumerprocurement.orders.licensePools.enumerateLicensedUsers

Perhatikan juga bahwa agar izin sebelumnya berfungsi, Gemini untuk Google Cloud API harus diaktifkan di project Google Cloud yang sama tempat Anda menetapkan setiap izin.

Mengubah saluran rilis project Google Cloud

Kami merilis fitur Gemini Code Assist di berbagai saluran rilis, baik Tersedia Secara 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 Gemini untuk Google Cloud.
• Pelajari cara Gemini untuk Google Cloud menggunakan data Anda.
• Pelajari cara mengakses dan mengelola kontrol administrator Gemini Code Assist Standard dan Enterprise.
• Pelajari cara mengonfigurasi penyesuaian kode untuk Gemini Code Assist Enterprise.
• Mengonfigurasi Kontrol Layanan VPC untuk Gemini Code Assist Standard dan Enterprise.