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 Workflow Builder kepada pengguna lain dalam organisasi Anda.

Dengan berbagi agen, Anda dapat:

• Membagikan agen aktif kepada pengguna dan grup di organisasi Anda.
• Menyiapkan jadwal eksekusi kustom atau pemicu berbasis peristiwa.
• Melacak eksekusi pratinjau dan eksekusi otomatis.
• Menduplikasi agen alur kerja yang dibagikan 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 sumber data dan file terkait. 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, lalu buka halaman Galeri Agen.

   Halaman Galeri Agen akan muncul dan menampilkan semua agen bawaan dan agen kustom.

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

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

3. Di header kanan atas kanvas Workflow Builder, klik Bagikan.

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

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

5. Klik Selesai.

   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 tersebut, agen akan dibagikan kepada orang-orang yang ada 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 berbagi agen 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 kepada Google Grup—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 Izinkan 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 Google Cloud konsol, buka halaman Gemini Enterprise > Apps.

   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 dibagikan kepada pengguna berikut.
   • Opsional: Ubah daftar akses untuk menambahkan atau menghapus akun pengguna, Google Grup, 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 eksekusi 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 akan diluncurkan dalam tata letak desainer hanya baca, yang menampilkan grafik node aktif. Catatan: Jika agen bersama ditangguhkan atau dinonaktifkan, kanvas Workflow Builder tidak akan dirender, tetapi Anda tetap dapat melihat eksekusinya.

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

   • Klik Pratinjau di header kanan atas kanvas Workflow Builder.
   • Jalankan pratinjau. Jika eksekusi pratinjau gagal karena konektor yang digunakan oleh alur kerja tidak diotorisasi, klik Aktifkan Konektor di bawah pesan error untuk menyelesaikan alur OAuth.

Menyiapkan pemicu Anda sendiri

Pemicu pada agen bersama bersifat khusus untuk pengguna. Anda dapat mengonfigurasi jadwal eksekusi kustom 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 Workflow Builder, klik judul agen, lalu pilih Siapkan pemicu.

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

   • Jadwal: Pilih Jalankan sesuai jadwal dan konfigurasi kapan agen akan berjalan untuk Anda (seperti frekuensi dan zona waktu).
   • Peristiwa: Pilih Jalankan pada peristiwa aplikasi dan konfigurasi filter peristiwa untuk menentukan kapan agen akan berjalan untuk Anda. Misalnya, untuk pemicu peristiwa Google Drive, Anda dapat memfilter menurut kolom seperti Pemilik (seperti ID Google seperti 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 otorisasi konektor di editor kanvas Workflow Builder saat diminta.

7. Klik Simpan. Pemicu akan 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 eksekusi Anda

Untuk melihat eksekusi Anda, 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 bersama.
3. Di kanvas Workflow Builder, klik tab Eksekusi.
4. Klik eksekusi tertentu untuk melihat log eksekusi dan pelacakan langkah demi langkah.

Untuk mengetahui informasi selengkapnya, lihat Eksekusi agen alur kerja.

Membuat salinan agen alur kerja bersama

Agen bersama bersifat hanya baca untuk pengguna bersama, kecuali untuk konfigurasi pemicunya. Jika ingin mengedit dan menyesuaikan langkah-langkah alur kerja agen bersama, Anda dapat membuat salinannya 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 Workflow Builder, 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 alur kerjanya, 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 eksekusi: 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 memperbarui versi aktif agen alur kerja, semua pengguna bersama akan otomatis menjalankan versi aktif baru pada eksekusi berikutnya.

• Jika agen dinonaktifkan atau ditangguhkan, kanvas Workflow Builder tidak akan dirender dan pengguna bersama tidak dapat menjalankan agen, tetapi mereka tetap dapat melihat histori eksekusi dan log sesi sebelumnya di galeri Eksekusi. Jika agen tidak dibagikan, dinonaktifkan, atau dihapus, pengguna bersama 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 kirimkan kepada 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 me mantau eksekusi agen alur kerja.