Mengonfigurasi Canvas

Halaman ini menjelaskan cara administrator dapat menyiapkan dan mengonfigurasi Canvas di Gemini Enterprise untuk pengguna mereka.

Canvas tersedia secara umum di region global, AS, dan Uni Eropa. Fitur ini tersedia untuk pengguna Gemini Enterprise Business Edition, Standard Edition, dan Plus Edition.

Sebelum memulai

Canvas dinonaktifkan secara default. Anda dapat meninjau dan menguji Canvas sebelum memilih untuk mengaktifkannya bagi pengguna.

Untuk mengaktifkan Canvas bagi pengguna Anda, selesaikan penyiapan berikut:

• Aktifkan tombol fitur
• Menambahkan izin Canvas ke peran IAM kustom

Mengaktifkan Canvas di aplikasi Gemini Enterprise

Agar pengguna dapat mengakses fitur Canvas, administrator Gemini Enterprise harus mengaktifkan tombol Aktifkan canvas di setelan pengelolaan fitur aplikasi web. Untuk mengetahui informasi selengkapnya, lihat Mengelola fitur aplikasi web.

Menambahkan izin Canvas ke peran IAM kustom

Pastikan pengguna memiliki izin yang diperlukan untuk Canvas:

• Peran bawaan: Pengguna yang mengakses Gemini Enterprise dengan peran standar seperti roles/discoveryengine.user tidak perlu melakukan perubahan apa pun, karena izin yang diperlukan disertakan dalam peran bawaan.

• Peran khusus: Untuk pengguna yang mengakses Gemini Enterprise menggunakan peran IAM khusus, Anda harus menambahkan izin immersiveArtifacts ke peran khusus tersebut. Tanpa izin ini, pengguna tidak dapat menggunakan Canvas. Canvas memerlukan izin berikut:

  • discoveryengine.immersiveArtifacts.create
  • discoveryengine.immersiveArtifacts.delete
  • discoveryengine.immersiveArtifacts.export
  • discoveryengine.immersiveArtifacts.get
  • discoveryengine.immersiveArtifacts.list
  • discoveryengine.immersiveArtifacts.navigate
  • discoveryengine.immersiveArtifacts.update

  Karena izin yang diperlukan untuk Canvas masih dalam pratinjau, Anda tidak dapat menambahkannya menggunakan konsol Google Cloud . Sebagai gantinya, gunakan gcloud CLI. Misalnya, untuk menambahkan izin ini ke peran kustom level project yang ada, jalankan perintah berikut:

  gcloud iam roles update ROLE_ID \
    --project=PROJECT_ID \
    --add-permissions=discoveryengine.immersiveArtifacts.create,discoveryengine.immersiveArtifacts.delete,discoveryengine.immersiveArtifacts.export,discoveryengine.immersiveArtifacts.get,discoveryengine.immersiveArtifacts.list,discoveryengine.immersiveArtifacts.navigate,discoveryengine.immersiveArtifacts.update
  

  Catatan: Karena izin ini masih dalam pratinjau, Anda akan melihat peringatan yang diharapkan dari gcloud CLI yang menyatakan bahwa izin ini berada dalam tahap peluncuran alpha dan mungkin tidak stabil untuk digunakan dalam peran kustom. Peringatan ini sudah diperkirakan dan tidak mencegah izin diterapkan.

  Untuk mengetahui informasi selengkapnya tentang cara mengelola peran IAM Gemini Enterprise, lihat Kontrol akses dengan IAM.

Batasan

Kanvas tidak didukung di aplikasi seluler. Fitur ini hanya tersedia di aplikasi web.

Penggunaan kuota

Kueri Canvas dan kueri chat aplikasi Gemini Enterprise reguler dihitung dengan cara yang sama dan menggunakan kuota yang sama.

Aplikasi Gemini Enterprise menampilkan pesan error Batas penggunaan tercapai saat Anda memulai percakapan dengan asisten atau menggunakan fitur Gemini Enterprise dalam salah satu skenario berikut:

• Project Anda telah mencapai batas pembelanjaan bulanan.
• Project Anda melebihi batas kuota gabungannya untuk fitur tertentu dan administrator Gemini Enterprise Anda belum mengaktifkan penggunaan berlebih.

Error ini hanya memengaruhi fitur yang mencapai batasnya. Anda dapat terus menggunakan fitur lain yang memiliki kuota tersisa.