Membagikan agen kustom

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara membagikan agen Agent-to-Agent (A2A), Agent Development Kit (ADK), dan Dialogflow yang Anda daftarkan dengan Gemini Enterprise, serta agen yang ditambahkan dari Google Cloud Marketplace. Agen A2A yang Anda tambahkan dari Google Cloud Marketplace juga dijelaskan agar pengguna mengetahui cara mengakses agen ini dari aplikasi web Gemini Enterprise.

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. 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 Vertex AI Agent Engine
   • Menambahkan dan mengelola agen A2A dari Google Cloud Marketplace
   • Mendaftarkan dan mengelola agen Dialogflow

Membagikan agen kustom kepada pengguna

Anda dapat mengontrol siapa yang memiliki akses ke agen kustom yang terdaftar di Gemini Enterprise.

Untuk membagikan agen, ikuti langkah-langkah berikut:

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

   Buka Gemini Enterprise

2. Pilih project Anda.

3. Klik aplikasi Anda dari kolom Name. Menu navigasi diperbarui.

4. Klik Agen dari menu navigasi.

5. Klik Nama tampilan agen yang ingin Anda bagikan.

6. Klik tab Izin pengguna, dan halaman Pengguna yang diberi izin akan ditampilkan.

7. Klik Tambahkan pengguna. Dialog Tambahkan peran izin pengguna ke agen akan ditampilkan.

8. Konfigurasi detail izin:

   1. Pilih salah satu opsi berikut di bagian Jenis anggota:

      • 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 anggota ini berfungsi, Anda harus menyertakan peran IAM yang benar. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

      • Kumpulan akun utama: Semua identitas dalam grup workload identity pool, yang mencakup grup eksternal yang tidak dikelola oleh Google.

      • Semua pengguna: Semua pengguna di organisasi.

   2. Masukkan identifikasi unik anggota, 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.
      Kumpulan identitas tenaga kerja	Masukkan Principal identifier 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.

9. Klik Simpan.

Kumpulan akun utama

Berikut adalah contoh set utama yang dapat Anda tentukan untuk jenis anggota Kumpulan identitas tenaga kerja:

Set utama	Deskripsi
principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID	Semua identitas workforce dalam grup.
principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	Semua identitas workforce dengan nilai atribut tertentu.
principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/*	Semua identitas dalam workforce identity pool.
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP_ID	Grup workload identity pool.
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	Semua identitas dalam workload identity pool dengan atribut tertentu.
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*	Semua identitas dalam workload identity pool.

Ganti placeholder berikut dengan nilai dalam contoh kode:

• PROJECT_NUMBER: nomor yang digunakan di jalur resource untuk mengidentifikasi project Google Cloud tertentu.
• 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 workload identity pool yang Anda buat di Google Cloud.
• ATTRIBUTE_NAME: nama yang ditentukan pengguna untuk atribut kustom yang telah Anda petakan dari Penyedia Identitas (IdP) eksternal.
• ATTRIBUTE_VALUE: nilai spesifik ATTRIBUTE_NAME yang digunakan untuk membatasi akses.