Menyiapkan Gemini Cloud Assist

Catatan: Penggunaan penawaran Pratinjau Gemini Cloud Assist ini tunduk pada Google Cloud Perjanjian, termasuk Persyaratan Penawaran Pra-GA dari Google Cloud Persyaratan Layanan Khusus, sebagaimana dilengkapi dengan persyaratan untuk Program Penguji Tepercaya Google Cloud Gemini.

Gemini Cloud Assist membantu Anda mendesain, mengoperasikan, dan mengoptimalkan aplikasi dan infrastruktur cloud dengan panduan AI kontekstual. Sebelum anggota tim dapat menggunakan fitur ini, administrator harus menyelesaikan penyiapan awal untuk project atau folder.

Menyiapkan Gemini Cloud Assist untuk sebuah project

Perhatian: Gemini Cloud Assist dapat menyimpan data di pusat dataGoogle Cloud mana pun secara global. Anda tidak boleh mengaktifkan Gemini Cloud Assist API untuk project yang memiliki persyaratan residensi data atau kunci enkripsi yang dikelola pelanggan.

Langkah-langkah berikut menjelaskan cara menyiapkan Gemini Cloud Assist untuk sebuah project.

Konsol

1. Buka halaman Admin untuk Gemini.

   Buka Gemini untuk Google Cloud

2. Dari pemilih project di bagian atas halaman, pilih resource project Anda.

3. Pilih Get Gemini Cloud Assist.

4. Dalam dialog Get Gemini Cloud Assist, lakukan hal berikut:

   1. Pilih panah peluas yang ada di bagian Required & recommended APIs.

   2. Dalam daftar Recommended APIs, pilih API tambahan yang ingin Anda aktifkan untuk meningkatkan performa Gemini Cloud Assist.

   3. Opsional: Pilih Bantu Google meningkatkan kualitas Cloud Assist dengan membagikan perintah dan jawaban Anda.

   4. Pilih Enable Gemini Cloud Assist at no cost.

5. Klik Simpan.

6. Berikan peran IAM yang diperlukan untuk menggunakan Gemini Cloud Assist.

   1. Buka halaman IAM & Admin.

      Buka IAM & Admin

   2. Di kolom Principal, temukan akun utama yang ingin Anda beri akses ke Gemini Cloud Assist, lalu klik Edit principal di baris tersebut.

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

   4. Di Select a role, pilih Gemini Cloud Assist User.

   5. Klik Add another role, lalu pilih Cloud Asset Viewer.

   6. Jika akun utama ingin mendapatkan bantuan terkait produk yang belum dapat diakses, Anda mungkin perlu memberinya peran IAM tambahan dengan mengklik Add another role dan memilih peran tambahan. Lihat Persyaratan IAM untuk menggunakan Gemini Cloud Assist untuk mengetahui tabel peran IAM yang memungkinkan pengalaman Gemini Cloud Assist yang optimal untuk berbagai produk.

   7. Jika project Anda adalah bagian dari organisasi yang menggunakan batasan kustom, tinjau izin yang diperlukan untuk chat untuk memastikan bahwa chat Gemini Cloud Assist tidak diblokir.

7. (Opsional) Konfigurasi setelan untuk project.

gcloud

1. Di konsol Google Cloud , aktifkan Cloud Shell.

   Aktifkan Cloud Shell

2. Aktifkan Gemini Cloud Assist API menggunakan perintah gcloud services enable:

   gcloud services enable geminicloudassist.googleapis.com
   

   Langkah ini juga mengaktifkan Gemini for Google Cloud API, yang juga diperlukan untuk menggunakan Gemini Cloud Assist.

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

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

   Ganti PROJECT_ID dengan ID project tempat Anda mengaktifkan Gemini Cloud Assist.

   Outputnya mirip dengan hal berikut ini:

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

3. Aktifkan API lain yang diperlukan menggunakan perintah gcloud services enable seperti yang Anda lakukan untuk mengaktifkan Gemini Cloud Assist API:

   gcloud services enable cloudasset.googleapis.com designcenter.googleapis.com appoptimize.googleapis.com apphub.googleapis.com --project PROJECT_ID
   

4. (Opsional) Aktifkan API yang direkomendasikan menggunakan perintah gcloud services enable seperti yang Anda lakukan untuk mengaktifkan Gemini Cloud Assist API.

5. Memberikan peran IAM dalam project Google Cloud . Untuk mengetahui informasi selengkapnya, lihat Memberikan satu peran dan gcloud projects add-iam-policy-binding.

   1. Berikan peran roles/geminicloudassist.user:

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

      Ganti kode berikut:

      • PROJECT_ID: ID project Google 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/geminicloudassist.user
      

   2. Ulangi langkah sebelumnya untuk peran roles/cloudasset.viewer.

   3. Jika akun utama ingin mendapatkan bantuan terkait produk yang belum dapat diakses, Anda mungkin perlu memberinya peran IAM tambahan. Lihat Persyaratan IAM untuk menggunakan Gemini Cloud Assist untuk mengetahui tabel peran IAM yang memungkinkan pengalaman Gemini Cloud Assist yang optimal untuk berbagai produk.

   4. Jika project Anda adalah bagian dari organisasi yang menggunakan batasan kustom, tinjau izin yang diperlukan untuk chat untuk memastikan bahwa chat Gemini Cloud Assist tidak diblokir.

6. (Opsional) Konfigurasi setelan untuk project.

API

Petunjuk ini menggunakan cURL untuk memanggil metode API.

1. Aktifkan Gemini Cloud Assist API menggunakan metode services.enable:

   curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:enable"
   

   Ganti PROJECT_ID dengan ID project tempat Anda mengaktifkan Gemini Cloud Assist.

   Jika berhasil, perintah ini akan menampilkan long-running operation, yang menyertakan kolom name. Anda dapat menggunakan nilai di kolom name untuk memeriksa status operasi.

   Catatan: Mengaktifkan layanan geminicloudassist.googleapis.com juga mengaktifkan layanan cloudaicompanion.googleapis.com, yang diperlukan untuk menggunakan Gemini Cloud Assist.

2. Aktifkan API tambahan yang diperlukan berikut menggunakan metode services.enable seperti yang Anda lakukan untuk mengaktifkan Gemini Cloud Assist API:

   • cloudasset.googleapis.com
   • designcenter.googleapis.com
   • appoptimize.googleapis.com
   • apphub.googleapis.com

3. (Opsional) Aktifkan API yang direkomendasikan menggunakan metode services.enable seperti yang Anda lakukan untuk mengaktifkan Gemini Cloud Assist API.

4. Berikan peran IAM untuk project Google Cloud terkait.

   1. Buat file JSON yang berisi informasi berikut:

        {
          "options": {
            "requestedPolicyVersion": 3
          }
        }
      

   2. Ambil kebijakan IAM yang ada untuk project menggunakan metode projects.getIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
          -H "Authorization: Bearer $(gcloud auth print-access-token)" \
          -H "Content-Type: application/json" \
          "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"
      

      Ganti kode berikut:

      • JSON_FILE_NAME: jalur untuk file JSON yang Anda buat di langkah sebelumnya.

      • PROJECT_ID: ID untuk project.

      Jika berhasil, respons akan menampilkan kebijakan IAM project.

   3. Salin kebijakan IAM project ke file JSON kosong, dan tambahkan informasi berikut ke konten yang ada:

        {
          "role": "roles/geminicloudassist.user",
          "members": [
            "PRINCIPAL"
          ]
        },
        {
          "role": "roles/cloudasset.viewer",
          "members": [
            "PRINCIPAL"
          ]
        }
      

      Ganti PRINCIPAL dengan ID untuk akun utama yang Anda beri akses Gemini Cloud Assist.

   4. Terapkan kebijakan IAM yang telah diperbarui ke project menggunakan metode projects.setIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
          -H "Authorization: Bearer $(gcloud auth print-access-token)" \
          -H "Content-Type: application/json" \
          "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"
      

      Ganti kode berikut:

      • JSON_FILE_NAME: jalur untuk file JSON yang Anda buat di langkah sebelumnya.

      • PROJECT_ID: ID untuk project.

      Jika berhasil, respons akan menampilkan kebijakan IAM project yang telah diperbarui.

   5. Jika akun utama ingin mendapatkan bantuan terkait produk yang belum dapat diakses, Anda mungkin perlu memberinya peran IAM tambahan. Lihat Persyaratan IAM untuk menggunakan Gemini Cloud Assist untuk mengetahui tabel peran IAM yang memungkinkan pengalaman Gemini Cloud Assist yang optimal untuk berbagai produk.

   6. Jika project Anda adalah bagian dari organisasi yang menggunakan batasan kustom, tinjau izin yang diperlukan untuk chat untuk memastikan chat Gemini Cloud Assist tidak diblokir.

5. (Opsional) Konfigurasi setelan untuk project.

Menyiapkan Gemini Cloud Assist untuk folder

Langkah-langkah berikut menjelaskan cara menyiapkan Gemini Cloud Assist untuk folder menggunakan konsol Google Cloud . Anda tidak dapat menggunakan Google Cloud CLI atau API untuk menyiapkan Gemini Cloud Assist untuk folder.

1. Mengaktifkan API yang diperlukan dan direkomendasikan.

   1. Buka halaman Admin untuk Gemini.

      Buka Admin untuk Gemini

   2. Dari pemilih project di bagian atas halaman, pilih resource folder Anda.

   3. Pilih Enable Cloud Assist APIs.

      Dialog Enable API for existing projects within folder akan muncul.

   4. Dalam dialog Enable API for existing projects within a folder, pilih panah peluas yang ada di bagian Required & recommended APIs.

   5. Dalam daftar Recommended APIs, pilih API opsional yang ingin Anda aktifkan.

   6. Opsional: Pilih Bantu Google meningkatkan kualitas Cloud Assist dengan membagikan perintah dan jawaban Anda.

   7. Pilih Enable Gemini Cloud Assist at no cost.

      Langkah ini mengaktifkan API yang diperlukan dan direkomendasikan yang dipilih untuk semua project dalam folder. Jika Anda menginginkan pengecualian untuk beberapa project dalam folder, Anda dapat memblokir pengaktifan API dengan menetapkan batasan kebijakan organisasi Batasi Penggunaan Layanan Resource pada project tersebut. Untuk mengetahui informasi selengkapnya, lihat Membatasi penggunaan resource.

2. Berikan peran IAM berikut atau buat peran khusus dengan izin yang setara di folder:

   • Pengguna Gemini Cloud Assist
   • Cloud Asset Viewer

   Jika akun utama ingin mendapatkan bantuan terkait produk yang belum dapat diakses, Anda mungkin perlu memberinya peran IAM tambahan. Lihat Persyaratan IAM untuk menggunakan Gemini Cloud Assist untuk mengetahui tabel peran IAM yang memungkinkan pengalaman Gemini Cloud Assist yang optimal untuk berbagai produk.

3. Jika folder Anda adalah bagian dari organisasi yang menggunakan batasan kustom, tinjau izin yang diperlukan untuk chat untuk memastikan chat Gemini Cloud Assist tidak diblokir.

4. Jika Anda menggunakan Gemini Cloud Assist dengan aplikasi, Anda juga harus mengaktifkan pengelolaan aplikasi di tingkat folder. Langkah ini akan membuat project pengelolaan yang harus Anda tautkan ke akun penagihan.

   1. Kembali ke halaman Admin untuk Gemini.

      Buka Admin untuk Gemini

   2. Pilih Enable App Management.

      Halaman setelan IAM & Admin akan muncul.

   3. Pilih Enable di bagian App-enablement pada halaman.

      Dialog Enable application APIs on this folder akan muncul.

   4. Pilih Aktifkan.

      Status bar akan menampilkan progres pengaktifan API. Halaman setelan IAM & Admin akan dimuat ulang setelah pengaktifan API selesai.

   5. Pilih Kelola penagihan.

      Halaman Akun tertaut akan muncul.

   6. Pilih akun penagihan dari daftar, lalu pilih Set account.

5. Berikan peran IAM yang Anda berikan ke folder di langkah 2, atau buat peran khusus dengan izin yang setara ke project pengelolaan yang dibuat di langkah sebelumnya.

   Temukan project pengelolaan untuk folder:

   1. Kembali ke halaman Admin untuk Gemini.

      Buka Admin untuk Gemini

   2. Dari pemilih project di bagian atas halaman, pilih resource folder Anda.

   3. Pilih Kelola Setelan Gemini Cloud Assist.

      Dialog Manage Gemini Cloud Assist akan muncul.

   4. Catat Project pengelolaan.

6. (Opsional) Konfigurasi setelan untuk project dalam folder.

Penting: Project yang ditambahkan ke folder ini pada masa mendatang tidak akan otomatis mengaktifkan Gemini Cloud Assist. Untuk project tersebut, Anda harus mengaktifkan Gemini Cloud Assist untuk project setelah membuat project.

Langkah berikutnya

• Pelajari harga Gemini Cloud Assist.
• Pelajari cara menggunakan panel Cloud Assist di konsol Google Cloud .
• Pelajari cara mengonfigurasi setelan tambahan untuk Gemini Cloud Assist.