Menyiapkan Gemini Cloud Assist di Penagihan Cloud

Untuk menyiapkan Gemini Cloud Assist di Penagihan Cloud, lakukan langkah-langkah berikut:

  1. Aktifkan Gemini for Google Cloud API di project Google Cloud. Administrator biasanya melakukan langkah ini.

  2. Di project Google Cloud, berikan peran Identity and Access Management (IAM) kepada pengguna yang sama yang mengakses laporan Penagihan Cloud. Administrator biasanya melakukan langkah ini.

  3. Untuk pengguna yang memerlukan akses ke laporan Penagihan Cloud dan Gemini Cloud Assist di Penagihan Cloud, berikan peran IAM di akun Penagihan Cloud yang ditautkan ke project tempat Gemini untuk Google Cloud API diaktifkan. Administrator biasanya melakukan langkah ini.

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.

    Untuk pengguna Cloud Billing yang memiliki izin tingkat akun penagihan di akun Penagihan Cloud, sebaiknya gunakan project administrasi FinOps untuk menampung API.

  3. Klik Aktifkan.

    Halaman akan diperbarui dan menampilkan status API Enabled.

gcloud

  1. Di konsol Google Cloud, aktifkan Cloud Shell.

    Aktifkan Cloud Shell

  2. Di menu pemilih project, pilih project.

    Untuk pengguna Cloud Billing yang memiliki izin tingkat akun penagihan di akun Penagihan Cloud, sebaiknya gunakan project administrasi FinOps untuk menampung API.

  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.
    

Setelah Anda mengaktifkan Gemini for Google Cloud API di project Google Cloud yang ditentukan, Gemini Cloud Assist kini tersedia untuk semua pengguna yang memiliki peran IAM yang diperlukan di project yang ditentukan.

Memberikan peran IAM dalam project Google Cloud

Bagian ini menjelaskan langkah-langkah untuk memberikan izin project yang diperlukan agar dapat menggunakan Gemini Cloud Assist. Di project Google Cloud tempat Anda mengaktifkan Gemini untuk Google Cloud API, berikan peran IAM berikut kepada pengguna (akun utama) di project tersebut:

  • Pengguna Gemini untuk Google Cloud
  • Service Usage Consumer

Konsol

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

    Buka IAM & Admin

  2. Di kolom Principal, temukan principal yang aksesnya ke Gemini ingin Anda aktifkan, 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. Di konsol Google Cloud, aktifkan Cloud Shell.

    Aktifkan 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 Service Usage Consumer:

    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 (prinsipal) yang diberi peran ini dapat mengakses fitur Gemini untuk Google Cloud di konsol Google Cloud dalam project yang ditentukan. Jika pengguna project juga memiliki akses untuk melihat Laporan Penagihan Cloud, mereka dapat menggunakan Gemini Cloud Assist di Laporan Penagihan Cloud untuk mendapatkan bantuan AI guna membuat laporan biaya dan meringkas insight utama dari laporan biaya. Untuk mengetahui informasi selengkapnya, lihat ringkasan Gemini Cloud Assist di Penagihan Cloud.

Tugas penyiapan IAM lanjutan untuk project

Alih-alih menggunakan konsol Google Cloud atau gcloud CLI untuk memberikan peran IAM yang telah ditentukan sebelumnya pada project, 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 kustom untuk izin project yang Anda buat memerlukan izin berikut untuk mengakses Gemini untuk Google Cloud:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • serviceusage.services.use

Memberikan peran IAM di akun Penagihan Cloud

Untuk pengguna yang memerlukan akses ke laporan Penagihan Cloud, Anda harus memberikan izin di akun Penagihan Cloud yang memadai untuk mengakses halaman Laporan. Untuk menggunakan Gemini Cloud Assist dalam laporan penagihan, berikan akses ke akun Penagihan Cloud yang ditautkan ke project tempat Gemini untuk Google Cloud API diaktifkan.

Langkah selanjutnya