Menyiapkan Gemini Code Assist

Sebelum dapat menggunakan Gemini Code Assist, tim Anda perlu melakukan langkah-langkah penyiapan yang dijelaskan dalam dokumen ini:

  1. Beli langganan Gemini Code Assist.

  2. Tetapkan lisensi untuk satu per satu pengguna di organisasi Anda.

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

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

  5. Pengguna organisasi Anda menginstal plugin Gemini Code Assist untuk menggunakan Gemini Code Assist di IDE.

Membeli langganan Gemini Code Assist

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

Gemini Code Assist Enterprise tersedia dengan harga $19 per bulan per pengguna dengan komitmen 12 bulan hingga 31 Maret 2025. Hubungi tim penjualan kami untuk memanfaatkan penawaran promosi ini.

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

Catatan: Anda harus memiliki izin Identity and Access Management (IAM) consumerprocurement.orders.place untuk membeli langganan Gemini. 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 Gemini untuk Google Cloud.

    Buka Gemini untuk Google Cloud

    Halaman Gemini untuk Google Cloud akan terbuka.

  2. Pilih Dapatkan Gemini Code Assist. Jika project Anda sudah memiliki Gemini Code Assist, teks ini akan menampilkan Kelola Gemini Code Assist.

    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 terperinci 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.
    • Perpanjangan otomatis langganan Anda setelah masa komitmen (bulanan atau tahunan) berakhir. Perpanjangan otomatis akan membuat langganan dan lisensi Anda tetap aktif. Jika langganan tidak diperpanjang secara otomatis, langganan akan berakhir saat masa berlaku saat ini berakhir, dan Anda harus melalui proses pembelian lagi dan menetapkan ulang lisensi.

  5. Untuk mengonfirmasi langganan, pilih Lanjutkan.

  6. Jika Anda menyetujui persyaratannya, pilih Saya setuju dengan persyaratan pembelian ini, lalu pilih Konfirmasi langganan.

  7. Pilih Berikutnya: Kelola Penetapan Lisensi Gemini.

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

Menetapkan lisensi

Sebelum menggunakan Gemini Code Assist, setiap pengguna di organisasi Anda memerlukan lisensi.

Konsol

Untuk menetapkan lisensi Gemini kepada setiap pengguna di konsol Google Cloud, Anda harus memiliki izin berikut:

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign

  1. Buka halaman Admin untuk Gemini.

    Buka Admin untuk Gemini

  2. Pilih langganan yang ingin diubah, lalu klik Ubah Langganan.

  3. Klik Tetapkan Lisensi. Dialog pemilihan pengguna akan muncul. Untuk menelusuri pengguna tertentu, masukkan namanya di kotak penelusuran.

  4. Pilih satu atau beberapa pengguna dari daftar, lalu klik Berikutnya.

  5. Pilih layanan Gemini yang lisensinya ingin Anda tetapkan.

  6. Klik Tetapkan Lisensi.

API

Untuk menetapkan lisensi Gemini dengan API, Anda harus memiliki izin consumerprocurement.licensePools.assign.

Metode HTTP: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

Ganti kode berikut:

  • BILLING_ACCOUNT_ID: ID akun penagihan
  • ORDER_ID: kebijakan IAM

Isi permintaan:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

Outputnya mirip dengan hal berikut ini:

{}

Respons akan kosong jika lisensi berhasil ditetapkan.

Sekarang Anda perlu mengaktifkan Gemini for Google Cloud API 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 untuk Google Cloud API di project Google Cloud

Bagian ini menjelaskan langkah-langkah yang diperlukan untuk mengaktifkan Gemini untuk Google Cloud API di project Google Cloud.

Konsol

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

    Buka Gemini untuk Google Cloud

  2. Di pemilih project, pilih project.

  3. Klik Aktifkan.

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

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. Di menu pemilih project, pilih project.

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

    gcloud services enable cloudaicompanion.googleapis.com

    Jika Anda ingin mengaktifkan Gemini untuk Google Cloud API di project Google Cloud yang berbeda, tambahkan parameter --project:

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

    Ganti PROJECT_ID dengan ID project 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 Google Cloud yang ditentukan untuk semua pengguna yang memiliki peran IAM yang diperlukan.

API yang diperlukan untuk pengguna di balik firewall

Selain mengaktifkan Gemini untuk Google Cloud API, pengguna di balik firewall mungkin juga perlu mengaktifkan 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 Gemini utama untuk Google Cloud API.
  • 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.
  • feedback-pa.googleapis.com: API internal yang digunakan untuk pengiriman masukan dalam IDE.
  • apihub.googleapis.com: digunakan oleh fitur Browser Cloud Code API.

Opsional: Mengonfigurasi Kontrol Layanan VPC

Jika organisasi Anda memiliki perimeter layanan, Anda harus menambahkan resource berikut ke perimeter:

  • Gemini untuk Google Cloud API
  • Gemini Code Assist API

Jika Anda menggunakan Gemini Code Assist dari luar perimeter layanan, Anda juga perlu mengubah kebijakan masuk untuk mengizinkan akses ke layanan tersebut.

Untuk 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 Gemini untuk Pengguna 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. Di kolom Principal, temukan principal yang ingin Anda berikan akses ke Gemini, lalu klik Edit principal di baris tersebut.

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

  4. Di Pilih peran, pilih Pengguna Gemini untuk Google Cloud.

  5. Klik Tambahkan peran lain, lalu pilih Service Usage Consumer.

  6. Klik Simpan.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. Di menu pemilih project, pilih project.

  3. Berikan peran Pengguna Gemini untuk Google Cloud:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/cloudaicompanion.user

    Ganti PRINCIPAL dengan ID untuk prinsipal. ID memiliki bentuk user|group|serviceAccount:email atau domain:domain—misalnya, user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com, atau domain:example.domain.com.

    Outputnya adalah daftar binding kebijakan yang mencakup hal berikut:

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

  4. Berikan peran Konsumen Penggunaan Layanan:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer

    Outputnya adalah daftar binding kebijakan yang mencakup hal berikut:

    - members:
  - user:PRINCIPAL
  role: 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 di IDE

Pengguna organisasi Anda menginstal Gemini Code Assist di IDE pilihan mereka. Untuk informasi selengkapnya, lihat referensi berikut:

Tugas penyiapan lanjutan

Alih-alih menggunakan konsol Google Cloud atau gcloud CLI untuk memberikan peran IAM yang telah ditentukan sebelumnya, Anda dapat melakukan salah satu hal berikut:

  • Gunakan REST API IAM 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.

    Setiap peran khusus yang Anda buat memerlukan izin berikut agar Anda dapat mengakses Gemini Code Assist:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable

  • Menetapkan dan mengelola lisensi.

    Setiap peran khusus yang Anda buat memerlukan izin berikut agar Anda dapat mengakses 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 for Google Cloud API harus diaktifkan di project Google Cloud yang sama tempat Anda menetapkan setiap izin.

Langkah selanjutnya