Membagikan agen dari konsol Google Cloud

Halaman ini menjelaskan cara membagikan agen kepada pengguna di organisasi Anda dan cara administrator dapat mentransfer kepemilikan agen yang dibagikan. Sebagai administrator, Anda dapat membagikan agen yang tersedia (buatan Google, buatan karyawan, dan buatan kustom) kepada masing-masing pengguna, grup, grup Workforce Identity Pool, atau semua pengguna di organisasi Anda, dan mentransfer kepemilikan agen buatan karyawan yang dibagikan kepada diri Anda sendiri atau pengguna lain. Untuk mengetahui informasi selengkapnya tentang berbagai jenis agen yang tersedia di Gemini Enterprise, lihat Ringkasan agen.

Catatan: Untuk membagikan agen buatan karyawan, Anda harus memiliki satu atau beberapa agen yang dibuat menggunakan Workflow Builder di aplikasi web Gemini Enterprise. Untuk mengetahui informasi tentang cara membuat agen menggunakan Workflow Builder, lihat Membuat agen menggunakan Workflow Builder.

Sebelum memulai

Sebelum dapat membagikan agen, Anda harus memenuhi persyaratan berikut:

1. Anda harus memiliki aplikasi web Gemini Enterprise yang sudah ada. Untuk membuat aplikasi baru, lihat Membuat aplikasi.

2. Untuk membagikan agen kustom, Anda harus mendaftarkan atau menambahkan agen kustom ke Gemini Enterprise menggunakan salah satu opsi berikut:

   • Mendaftarkan dan mengelola agen A2A
   • Mendaftarkan dan mengelola agen ADK yang dihosting di Agent Runtime di Gemini Enterprise Agent Platform
   • Menambahkan dan mengelola agen A2A dari Google Cloud Marketplace
   • Mendaftarkan dan mengelola agen Dialogflow

Membagikan agen

Untuk membagikan agen, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

Buka Gemini Enterprise

1. Pilih project Anda.

2. Klik aplikasi Anda dari kolom Nama. Pembaruan menu navigasi.

3. Klik Agents dari menu navigasi.

4. Klik Nama tampilan agen yang ingin Anda bagikan.

5. Klik tab User permissions, dan halaman Permissioned users akan ditampilkan.

6. Klik Tambahkan pengguna. Dialog Add user permissions roles to agent akan ditampilkan.

7. Konfigurasikan detail izin:

   1. Pilih salah satu opsi berikut di bagian Member type:

      • Pengguna: Pengguna akhir individu. Agar jenis anggota ini berfungsi, Anda harus menyertakan peran IAM yang benar. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

      • Grup: Kumpulan pengguna akhir. Agar jenis keanggotaan ini berfungsi, Anda harus menyertakan peran IAM yang benar. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

      • Akun utama: Satu identitas dalam Workforce Identity Pool (principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID).

      • Workforce Identity Pool: Grup workforce pool, atribut kustom, atau semua pengguna di Workforce Identity Pool (principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/...).

      • Semua pengguna: Semua pengguna di organisasi.

      Jenis keanggotaan yang ditampilkan bergantung pada penyedia identitas yang digunakan aplikasi Anda. Untuk aplikasi yang menggunakan Google Identity, jenis keanggotaan Pengguna dan Grup akan ditampilkan. Untuk aplikasi yang menggunakan Workforce Identity Federation, jenis keanggotaan Principal dan Workforce Identity Pool akan ditampilkan.

      Tips: Jika Anda menggunakan Workforce Identity Federation dengan penyedia identitas pihak ketiga seperti Microsoft Entra ID atau Okta, konfigurasikan penyediaan System for Cross-domain Identity Management (SCIM) untuk workforce identity pool Anda. Setelah SCIM dikonfigurasi, dialog Tambahkan pengguna dan Transfer kepemilikan akan otomatis melengkapi pengguna dan grup serta mengisi SUBJECT_ID dan GROUP_ID yang tepat dan peka huruf besar/kecil untuk Anda. Pelengkapan otomatis berbasis SCIM memerlukan workforce identity pool khusus untuk setiap project Google Cloud , dan pemetaan atribut SCIM harus menghasilkan subjek yang sama dengan pemetaan google.subject pool. Pengguna dan grup hanya muncul di pelengkapan otomatis setelah penyedia identitas Anda menyediakannya melalui SCIM. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi Workforce Identity Federation dan Contoh pemetaan untuk konsistensi subjek.

   2. Masukkan identifikasi anggota yang unik, lalu pilih peran:

      Jenis anggota	Deskripsi
      User	Masukkan alamat email di kolom Anggota. Pilih peran di kolom Tetapkan peran.
      Group	Masukkan alamat email di kolom Anggota. Pilih peran di kolom Tetapkan peran.
      Akun utama	Masukkan ID akun utama subjek tunggal (//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID atau principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID) di kolom Member. Pilih peran di kolom Tetapkan peran.
      Workforce Identity Pool	Masukkan ID set akun utama (//iam.googleapis.com/locations/global/workforcePools/POOL_ID/... atau principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/...) di kolom Member. Pilih peran di kolom Tetapkan peran. Untuk contoh set akun utama, lihat Set akun utama.
      Semua pengguna	Pilih peran di kolom Tetapkan peran.

8. Klik Simpan.

Set akun utama

Berikut adalah contoh ID utama dan set utama yang dapat Anda tentukan saat berbagi dengan pengguna dan grup Workforce Identity Federation. Jika penyediaan SCIM dikonfigurasi untuk workforce identity pool Anda, dialog Add user akan menyarankan pengguna dan grup saat Anda mengetik dan mengisi ID ini untuk Anda; jika tidak, masukkan ID tersebut persis seperti yang ditampilkan, termasuk huruf besar/kecil SUBJECT_ID:

Akun utama atau set akun utama	Deskripsi
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID	Identitas tunggal dalam workforce identity pool (pilih jenis keanggotaan Principal).
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID	Semua identitas workforce dalam grup (pilih jenis anggota Workforce Identity Pool).
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	Semua workforce identity dengan nilai atribut tertentu (pilih jenis anggota Workforce Identity Pool).
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/*	Semua identitas dalam workforce identity pool (pilih jenis anggota Workforce Identity Pool).

Ganti placeholder berikut dengan nilai dalam contoh kode:

• GROUP_ID: ID grup tertentu dari Penyedia Identitas (IdP) eksternal, yang memungkinkan Anda memberikan akses ke semua anggota grup tersebut.
• POOL_ID: ID unik untuk workforce identity pool yang Anda buat di Google Cloud.
• SUBJECT_ID: ID subjek unik (google.subject) untuk satu identitas dalam workforce identity pool. SUBJECT_ID peka huruf besar/kecil dan harus sama persis dengan kapitalisasi yang dinyatakan oleh penyedia identitas Anda (misalnya, dalam pernyataan SAML atau token OIDC).
• ATTRIBUTE_NAME: nama atribut kustom yang ditentukan pengguna yang telah Anda petakan dari Penyedia Identitas (IdP) eksternal.
• ATTRIBUTE_VALUE: nilai spesifik dari ATTRIBUTE_NAME yang digunakan untuk membatasi akses.

Catatan: Untuk memberikan akses ke satu pengguna Workforce Identity Federation, bukan grup atau pool, pilih Principal sebagai jenis anggota dan gunakan format subjek tunggal principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID (atau hapus awalan principal: di konsol Google Cloud ). Pastikan SUBJECT_ID (google.subject) sama persis dengan kapitalisasi yang dinyatakan oleh penyedia identitas Anda.

Mentransfer kepemilikan agen

Sebagai administrator, Anda dapat mentransfer kepemilikan agen bersama kepada pengguna lain di organisasi Anda atau kepada diri Anda sendiri. Kemampuan ini berguna dalam skenario seperti:

• Karyawan yang keluar: Mentransfer agen yang dibuat oleh karyawan yang keluar dari organisasi ke anggota tim yang aktif untuk memastikan pemeliharaan yang tidak terganggu.
• Serah terima kontraktor: Menyerahkan agen yang dibuat oleh pekerja sementara atau kontrak kepada staf purnawaktu.
• Restrukturisasi tim: Menetapkan ulang tanggung jawab agen seiring berkembangnya peran atau project.

Pertimbangan dan batasan

Sebelum mentransfer kepemilikan agen, perhatikan pertimbangan dan batasan berikut:

• Izin administrator: Hanya administrator dengan peran Gemini Enterprise Admin (roles/discoveryengine.agentspaceAdmin) atau peran Discovery Engine Admin (roles/discoveryengine.admin) yang dapat mentransfer kepemilikan agen. Pemilik agen saat ini tidak dapat mentransfer kepemilikan kecuali jika mereka juga merupakan administrator.
• Khusus agen bersama: Anda hanya dapat mentransfer kepemilikan agen yang sudah dibagikan. Di halaman Agents di konsol Google Cloud , kolom Sharing agen harus menampilkan Enabled. Agen pribadi (tidak dibagikan) tidak dapat ditransfer.
• Pemilik tunggal: Setiap agen memiliki tepat satu pemilik. Saat kepemilikan ditransfer, penerima yang dipilih akan menjadi pemilik tunggal agen.
• Akses pemilik sebelumnya: Saat kepemilikan ditransfer, pemilik sebelumnya akan didemosi menjadi pengguna di agen dengan peran agentUser. Mereka tetap memiliki izin untuk mengkueri dan menjalankan agen, tetapi tidak dapat lagi mengedit konfigurasi atau setelan agen.
• Jenis agen yang didukung: Transfer kepemilikan didukung untuk agen buatan karyawan (agen low-code dan alur kerja yang dibuat di aplikasi web).
• Agen dengan jadwal atau pemicu: Jika agen yang ditransfer memiliki pemicu jadwal atau pemicu peristiwa, operasi transfer akan menandainya sebagai jadwal atau peristiwa yang dinonaktifkan. Pemilik baru harus mengaktifkan pemicu jadwal atau peristiwa sebelum dapat menggunakan agen.

Mentransfer kepemilikan agen

Untuk mentransfer kepemilikan agen, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Buka Gemini Enterprise

2. Pilih project Anda.

3. Klik aplikasi Anda dari kolom Nama. Pembaruan menu navigasi.

4. Klik Agents dari menu navigasi.

5. Klik Nama tampilan agen bersama.

6. Klik tab User permissions. Daftar Pengguna yang diberi izin akan ditampilkan.

7. Klik Transfer kepemilikan. Dialog Transfer kepemilikan akan terbuka.

8. Di bagian Transfer kepemilikan ke, pilih salah satu opsi berikut:

   • Saya sendiri: Transfer kepemilikan agen ke akun administrator Anda saat ini. Opsi ini dinonaktifkan jika Anda sudah memiliki agen.
   • Pengguna lain: Mentransfer kepemilikan kepada pengguna lain di organisasi Anda.

9. Jika Anda memilih Pengguna lain, tentukan pemilik baru:

   • Google Identity dan Cloud Identity: Masukkan alamat email pengguna di kolom Email pemilik baru (misalnya, [e-mail]).
   • Akun Workforce Identity Federation (WIF): Masukkan ID akun utama identitas tunggal di kolom New owner principal:

   //iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   Atau, Anda dapat menyertakan awalan principal::

   principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   Ganti kode berikut:

   • POOL_ID: ID unik workforce identity pool Anda.
   • SUBJECT_ID: ID subjek pengguna di workforce identity pool.
   Catatan: ID utama Workforce Identity Federation peka huruf besar/kecil. Pastikan ID sama persis dengan huruf besar/kecil yang dikonfigurasi dalam pemetaan google.subject penyedia identitas Anda. Jika penyediaan SCIM dikonfigurasi untuk workforce identity pool Anda, kolom New owner principal akan menyarankan pengguna saat Anda mengetik dan mengisi ID untuk Anda. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi Workforce Identity Federation.

10. Klik Transfer kepemilikan.

    Pemilik agen diperbarui. Pemilik sebelumnya dipertahankan sebagai pengguna yang diberi izin dengan peran agentUser.

    Catatan: Jika agen yang ditransfer memiliki pemicu jadwal atau pemicu peristiwa, operasi transfer akan menandainya sebagai jadwal atau peristiwa yang dinonaktifkan. Pemilik baru harus mengaktifkan pemicu sebelum dapat menggunakan agen.