Membagikan agen alur kerja

Akses awal — Agen alur kerja

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

Bagikan agen alur kerja yang telah Anda buat dan luncurkan menggunakan Agent Designer kepada pengguna lain dalam organisasi Anda.

Dengan berbagi agen, Anda dapat:

• Bagikan agen aktif kepada pengguna dan grup di organisasi Anda.
• Siapkan jadwal proses kustom atau pemicu berbasis peristiwa.
• Lacak eksekusi pratinjau dan proses otomatis.
• Duplikasikan agen alur kerja bersama untuk menyesuaikan langkah-langkahnya.

Bergantung pada konfigurasi kontrol fitur aplikasi Anda, Anda mungkin memerlukan administrator untuk meninjau dan menyetujui permintaan Anda sebelum Anda dapat membagikan agen.

Perhatian: Saat Anda membagikan agen, Anda juga membagikan akses ke semua file dan sumber data terkaitnya. Pengguna dapat mengajukan kueri kepada agen tentang konten sumber ini, meskipun mereka tidak memiliki akses langsung ke file atau sumber data.

Misalnya, jika Anda mengupload file rahasia ke bagian pengetahuan agen, lalu membagikan agen tersebut, setiap pengguna yang memiliki akses dapat mengajukan pertanyaan kepada agen tentang konten file tersebut.

Membagikan agen alur kerja

Untuk membagikan agen alur kerja, lakukan hal berikut:

Aplikasi

1. Buka aplikasi Gemini Enterprise Anda dan buka halaman Galeri Agen.

   Halaman Galeri Agen akan muncul dan menampilkan semua agen bawaan dan agen yang dibuat khusus.

2. Di bagian Agen Anda, cari agen yang ingin Anda bagikan.

   Catatan: Anda dapat membagikan agen yang dalam status draft, tetapi pengguna lain tidak dapat menjalankannya hingga diaktifkan.

3. Di header kanan atas kanvas Agent Designer, klik Bagikan.

4. Masukkan alamat email pengguna atau Grup Google yang ingin Anda ajak berbagi agen.

   Catatan: Anda dapat membagikan agen Anda ke alamat email pengguna individual. Berbagi dengan Google Grup tidak diaktifkan untuk pengguna akhir. Administrator aplikasi Gemini Enterprise atau pengguna mana pun dengan peran Admin Discovery Engine (discoveryengine.admin) dapat mengaktifkan berbagi grup di tingkat aplikasi Gemini Enterprise.

5. Klik Done.

   Catatan: Jika administrator aplikasi Anda telah mengaktifkan peninjauan administrator untuk berbagi agen, permintaan berbagi akan dikirim ke administrator aplikasi untuk ditinjau dan disetujui. Setelah administrator aplikasi menyetujui permintaan, agen akan dibagikan kepada pengguna dalam daftar akses. Anda dapat mengedit permintaan berbagi kapan saja untuk menambahkan atau menghapus pengguna, atau membatalkan permintaan.

Kontrol peninjauan administrator

Secara default, pemilik agen dapat membagikan agen mereka kepada pengguna mana pun dalam organisasi mereka tanpa persetujuan dari administrator aplikasi. Namun, administrator aplikasi dapat mengubah konfigurasi kontrol fitur aplikasi untuk mewajibkan peninjauan dan persetujuan administrator untuk agen berbagi di aplikasi.

Secara default, pemilik agen tidak dapat membagikan agen mereka kepada grup. Namun, administrator aplikasi Gemini Enterprise dapat memilih untuk membuat agen dapat dibagikan dengan Grup Google—dengan atau tanpa persetujuan administrator.

Proses berbagi

Hanya pembagian awal agen yang memerlukan peninjauan dan persetujuan administrator. Revisi agen berikutnya tidak memerlukan persetujuan ulang.

Berbagi agen mengikuti proses dua langkah saat peninjauan administrator diaktifkan:

1. Pemilik agen membagikan agen kepada satu atau beberapa pengguna atau Google Grup.

2. Administrator aplikasi meninjau permintaan berbagi dan menyetujui atau menolaknya.

Meninjau permintaan berbagi

Administrator aplikasi bertanggung jawab untuk meninjau dan mengelola permintaan berbagi agen.

Catatan:

• Bagian ini hanya berlaku jika fitur Aktifkan berbagi agen tanpa persetujuan administrator dinonaktifkan di kontrol fitur aplikasi.
• Hanya administrator aplikasi dengan peran IAM Admin Gemini Enterprise yang dapat meninjau dan menyetujui permintaan berbagi.

Konsol

Untuk meninjau permintaan berbagi sebagai administrator aplikasi, lakukan hal berikut:

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

   Gemini Enterprise

2. Klik nama aplikasi yang berisi agen.

3. Di menu navigasi aplikasi, klik Agen.

4. Temukan agen dengan tindakan Tinjau permintaan berbagi di kolom Izin pengguna.

   

5. Klik Tinjau permintaan berbagi.

6. Di panel Permintaan berbagi:

   • Tinjau daftar akses di bagian Diminta untuk berbagi dengan pengguna berikut.
   • Opsional: Ubah daftar akses untuk menambahkan atau menghapus akun pengguna, Grup Google, atau kumpulan identitas WIF.

7. Untuk menyetujui permintaan dan memberikan akses, klik Setujui dan aktifkan.

8. Untuk menolak permintaan, klik Tolak.

Menggunakan agen bersama

Saat pemilik agen membagikan agen alur kerja kepada Anda, Anda dapat mengakses dan melihat pratinjau konfigurasi grafiknya. Meskipun grafik alur kerja bersifat hanya baca untuk pengguna bersama, Anda dapat menjalankan pratinjau secara manual, mengonfigurasi setelan pemicu Anda sendiri, melihat histori proses Anda sendiri, atau membuat salinan agen.

Aplikasi

1. Buka aplikasi web Gemini Enterprise Anda di browser.
2. Di menu navigasi aplikasi web, klik Agen.
3. Buka bagian Dibagikan kepada saya > Dari organisasi Anda.

4. Klik agen alur kerja bersama yang ingin Anda lihat. Agen diluncurkan dalam tata letak desainer hanya baca, yang menampilkan grafik node live. Catatan: Jika agen bersama ditangguhkan atau dinonaktifkan, kanvas Agent Designer tidak akan dirender, tetapi Anda masih dapat melihat prosesnya.

5. Opsional: Untuk melakukan uji coba manual alur kerja agen:

   • Klik Pratinjau di header kanan atas kanvas Agent Designer.
   • Jalankan pratinjau. Jika uji coba pratinjau gagal karena konektor yang digunakan oleh alur kerja tidak diizinkan, klik Aktifkan Konektor di bawah pesan error untuk menyelesaikan alur OAuth.

Menyiapkan pemicu Anda sendiri

Pemicu pada agen bersama bersifat khusus per pengguna. Anda dapat mengonfigurasi jadwal atau filter peristiwa untuk menjalankan agen bersama secara otomatis.

Untuk menyiapkan pemicu Anda sendiri, lakukan hal berikut:

Aplikasi

1. Buka aplikasi web Gemini Enterprise Anda di browser.
2. Di menu navigasi aplikasi web, klik Agen > Galeri.
3. Buka bagian Dibagikan kepada saya > Dari organisasi Anda, lalu klik agen alur kerja bersama yang ingin Anda siapkan pemicunya.

4. Akses konfigurasi pemicu:

   • Pilih menu Tindakan > Siapkan pemicu.
   • Atau, buka agen alur kerja di kanvas editor Agent Designer, klik judul agen, lalu pilih Siapkan pemicu.

5. Anda dapat mengonfigurasi pemicu menggunakan salah satu mode berikut:

   • Jadwalkan: Pilih Jalankan sesuai jadwal dan konfigurasi kapan agen berjalan untuk Anda (seperti frekuensi dan zona waktu).
   • Peristiwa: Pilih Jalankan di peristiwa aplikasi dan konfigurasi filter peristiwa untuk menentukan kapan agen berjalan untuk Anda. Misalnya, untuk pemicu peristiwa Google Drive, Anda dapat memfilter menurut kolom seperti Pemilik (seperti ID Google janedoe), Nama, Jenis MIME, Waktu diubah, atau Folder induk. Anda memilih operator (seperti berisi atau sama dengan), memasukkan nilai, dan menggabungkan beberapa aturan menggunakan kondisi AND atau OR.

6. Jika alur kerja menggunakan konektor yang memerlukan autentikasi (misalnya, konektor yang digunakan dalam langkah agen, bukan pemicunya sendiri), aktifkan dan beri otorisasi konektor di editor kanvas Agent Designer saat diminta.

7. Klik Simpan. Pemicu disimpan dan menjalankan agen secara otomatis. Anda dapat memicu agen secara manual untuk melihat pratinjau apa yang akan terjadi saat pemicu jadwal atau peristiwa menjalankan agen ini. Jika Anda ingin agen berhenti berjalan, pilih Jangan jalankan pada peristiwa aplikasi atau Jangan jalankan sesuai jadwal dari jendela Siapkan pemicu.

Melihat operasi Anda

Untuk melihat proses, lakukan hal berikut:

Aplikasi

1. Di menu navigasi aplikasi web, klik Agen.
2. Buka bagian Dibagikan kepada saya > Dari organisasi Anda, lalu klik agen alur kerja yang dibagikan.
3. Di kanvas Agent Designer, klik tab Runs.
4. Klik eksekusi tertentu untuk melihat log eksekusi dan rekaman aktivitas langkah demi langkah.

Untuk mengetahui informasi selengkapnya, lihat Jalannya agen alur kerja.

Membuat salinan agen alur kerja bersama

Agen bersama bersifat hanya baca untuk pengguna bersama, kecuali konfigurasi pemicunya. Jika ingin mengedit dan menyesuaikan langkah-langkah alur kerja agen bersama, Anda dapat membuat salinan di ruang kerja Anda sendiri.

Untuk membuat duplikat agen bersama yang dapat diedit, lakukan hal berikut:

Aplikasi

1. Buka aplikasi web Gemini Enterprise Anda di browser.
2. Di menu navigasi aplikasi web, klik Agen > Galeri.
3. Buka bagian Dibagikan kepada saya > Dari organisasi Anda, lalu klik agen alur kerja bersama yang ingin Anda salin.
4. Di kanvas editor Agent Designer, klik judul agen, lalu pilih Buat salinan. Salinan akan ditambahkan ke daftar Agen Anda.

Dependensi agen bersama

Jika agen Anda mengimpor dan mereferensikan agen lain (sub-agen) dalam langkah-langkah alurnya, perhatikan hal berikut:

• Persyaratan akses: Saat Anda membagikan agen induk, atau saat Anda mengimpor agen ke agen Anda, pastikan semua pengguna dalam daftar akses Anda juga memiliki akses ke semua sub-agen yang diimpor.
• Kegagalan menjalankan: Jika pengguna menjalankan agen tanpa akses ke sub-agen yang diimpor, eksekusi akan gagal dengan pesan yang meminta mereka untuk meminta akses dari pemilik.

Pertimbangan

• Jika pemilik agen mengaktifkan versi baru atau mengupdate versi aktif agen alur kerja, semua pengguna bersama akan otomatis menjalankan versi aktif baru pada eksekusi berikutnya.

• Jika agen dinonaktifkan atau ditangguhkan, kanvas Agent Designer tidak dirender dan pengguna yang dibagikan tidak dapat menjalankan agen, tetapi mereka masih dapat melihat histori eksekusi dan log sesi sebelumnya di galeri Eksekusi. Jika agen tidak dibagikan, dinonaktifkan, atau dihapus, pengguna yang diajak berbagi akan kehilangan semua akses, termasuk ke histori eksekusi dan log sesi sebelumnya.

• Tindakan yang mengubah data eksternal memerlukan persetujuan human-in-the-loop (HITL), kecuali untuk email atau acara kalender yang Anda kirim ke diri Anda sendiri.

Langkah berikutnya

• Pelajari cara membuat agen alur kerja.
• Pelajari cara mengedit agen alur kerja.
• Pelajari cara mengelola versi agen alur kerja.
• Pelajari cara memantau eksekusi agen alur kerja.