Menyiapkan Gemini Cloud Assist

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

Sebelum dapat menggunakan Gemini Cloud Assist, administrator Anda harus melakukan langkah-langkah penyiapan yang dijelaskan dalam dokumen ini. Gemini Cloud Assist dapat disiapkan untuk a project atau a folder.

Menyiapkan Gemini Cloud Assist untuk sebuah project

Perhatian: Gemini Cloud Assist dapat menyimpan data di Google Cloud pusat data mana pun secara global. Anda sebaiknya tidak 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

Penting: Jika project Anda berada dalam perimeter layanan Kontrol Layanan VPC, Anda tidak dapat menggunakan Google Cloud petunjuk konsol untuk menyiapkan Gemini Cloud Assist. Mencoba melakukannya akan menghasilkan error, karena Google Cloud konsol mengharuskan App Optimize API juga diaktifkan, tetapi App Optimize API tidak didukung oleh Kontrol Layanan VPC. Sebagai gantinya, gunakan petunjuk gcloud CLI untuk menyiapkan Gemini Cloud Assist.

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 Dapatkan Gemini Cloud Assist.

4. Di dialog Dapatkan Gemini Cloud Assist, lakukan hal berikut:

   1. Pilih panah ekspander yang terdapat di bagian API yang diperlukan & direkomendasikan.

   2. Di daftar API yang Direkomendasikan, pilih API tambahan yang ingin Anda aktifkan untuk meningkatkan performa Gemini Cloud Assist.

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

   4. Pilih Aktifkan Gemini Cloud Assist tanpa biaya.

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 Akun utama, temukan akun utama yang ingin Anda beri akses ke Gemini Cloud Assist, lalu klik Edit akun utama di baris tersebut.

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

   4. Di Pilih peran, pilih Pengguna Gemini Cloud Assist.

   5. Klik Tambahkan peran lain , 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 Tambahkan peran lain 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 guna memastikan chat Gemini Cloud Assist tidak diblokir.

7. (Opsional) Konfigurasi setelan untuk project.

gcloud

1. Dikonsol 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 project lain Google Cloud , tambahkan parameter --project:

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

   Ganti PROJECT_ID dengan ID project yang akan Anda aktifkan 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
   

   Penting: Jika project Anda berada dalam perimeter layanan Kontrol Layanan VPC, kecualikan appoptimize.googleapis.com dari perintah, karena App Optimize API tidak didukung oleh Kontrol Layanan VPC.

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

5. Berikan peran IAM dalam a Google Cloud project. 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 Anda Google Cloud —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 guna memastikan 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 yang akan Anda aktifkan Gemini Cloud Assist.

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

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

2. Aktifkan API tambahan berikut yang diperlukan 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
   Penting: Jika project Anda berada dalam perimeter layanan Kontrol Layanan VPC, kecualikan appoptimize.googleapis.com dari grup API yang diaktifkan, karena App Optimize API tidak didukung oleh Kontrol Layanan VPC.

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

4. Berikan peran IAM untukproject 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 akan Anda beri akses Gemini Cloud Assist.

   4. Terapkan kebijakan IAM yang 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 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 guna memastikan chat Gemini Cloud Assist tidak diblokir.

5. (Opsional) Konfigurasi setelan untuk project.

Menyiapkan Gemini Cloud Assist untuk sebuah folder

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

1. Aktifkan 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 Aktifkan Cloud Assist API.

      Dialog Aktifkan API untuk project yang ada dalam folder akan muncul.

   4. Di dialog Aktifkan API untuk project yang ada dalam folder, pilih panah ekspander yang terdapat di bagian API yang diperlukan & direkomendasikan.

   5. Di daftar API yang Direkomendasikan, pilih API opsional yang ingin Anda aktifkan.

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

   7. Pilih Aktifkan Gemini Cloud Assist tanpa biaya.

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

2. Berikan peran IAM berikut atau buat peran kustom 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 guna 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 membuat project pengelolaan yang harus Anda tautkan ke akun penagihan.

   1. Kembali ke halaman Admin untuk Gemini.

      Buka Admin untuk Gemini

   2. Pilih Aktifkan Pengelolaan Aplikasi.

      Halaman setelan IAM &Admin akan muncul.

   3. Pilih Aktifkan di bagian Pengaktifan aplikasi di halaman.

      Dialog Aktifkan API aplikasi di folder ini akan muncul.

   4. Pilih Aktifkan.

      Status bar akan menampilkan progres pengaktifan API. Halaman setelan IAM &Admin akan diupdate saat pengaktifan API selesai.

   5. Pilih Kelola penagihan.

      Halaman Akun tertaut akan muncul.

   6. Pilih akun penagihan dari daftar, lalu pilih Tetapkan akun.

5. Berikan peran IAM yang Anda berikan ke folder di langkah 2, atau buat peran kustom 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 Kelola Gemini Cloud Assist akan muncul.

   4. Catat Project pengelolaan.

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

Penting: Project yang ditambahkan ke folder ini di 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 tentang harga Gemini Cloud Assist.
• Pelajari cara me nggunakan panel Cloud Assist di konsol Google Cloud .
• Pelajari cara mengonfigurasi setelan tambahan untuk Gemini Cloud Assist.