Menyimpan dan membagikan perintah

Dokumen ini menjelaskan cara menyimpan dan membagikan perintah di Vertex AI Studio. Dengan berbagi perintah, Anda dapat berkolaborasi dengan anggota tim, memastikan konsistensi, dan membuat pustaka perintah yang efektif untuk berbagai tugas.

Cara kerja berbagi adalah sebagai berikut:

  • Secara default, semua pengguna Vertex AI memiliki akses penuh ke semua perintah yang disimpan dalam project. Anda tidak perlu membagikan perintah tersimpan kepada pengguna lain dalam project, kecuali jika batasan organisasi atau project telah diterapkan pada perintah tersebut atau resource tertentu seperti set data.

  • Pengguna Vertex AI dapat membagikan perintah apa pun dalam project, bahkan perintah yang tidak dibuat atau disimpan oleh mereka.

  • Hanya pengguna Vertex AI yang dapat membagikan perintah. Jika pengguna eksternal diundang untuk berkolaborasi dalam perintah, dia tidak dapat membagikan perintah tersebut kepada pengguna lain.

  • Berbagi perintah dilakukan per perintah, bukan per project. Pengguna yang diundang hanya dapat mengakses perintah yang mengundang mereka untuk berkolaborasi. Mereka tidak memiliki akses ke perintah lain dalam project.

Sebelum memulai

Jika project belum mengaktifkan fitur berbagi perintah, minta administrator Anda untuk mengaktifkannya.

Untuk mengaktifkan berbagi perintah, administrator harus memiliki izin berikut:

  • Tingkat organisasi:

    • Izin untuk mengelola kebijakan penolakan (roles/iam.denyAdmin)

  • Level project:

    • Izin untuk mengelola peran khusus (roles/iam.roleAdmin)

    • Izin untuk menetapkan dan menghapus peran pada akun utama (roles/resourcemanager.projectIamAdmin)

    • Izin untuk mengelola akun layanan (roles/iam.serviceAccountAdmin)

    • Izin untuk mengelola tag (roles/resourcemanager.tagAdmin)

    • Izin untuk menggunakan tag (roles/resourcemanager.tagUser)

    • Izin untuk menggunakan resource Vertex AI ( roles/aiplatform.user)

Mengaktifkan berbagi perintah

Untuk mengaktifkan berbagi perintah:

  1. Di Vertex AI Studio, buka Prompt management atau Chat playground

    Buka Pengelolaan perintah

    Buka playground Chat

  2. Buka perintah tersimpan dan klik tombol Bagikan.

    Jika akun Anda memiliki izin untuk mengaktifkan berbagi, Anda akan melihat tombol Aktifkan.

    Tombol aktifkan berbagi perintah

    Jika akun Anda tidak memiliki izin untuk mengaktifkan berbagi, Anda akan melihat daftar peran yang diperlukan.

    Peran yang diperlukan untuk berbagi cepat

  3. Klik Enable.

    Sistem membuat akun layanan tingkat project, yang dikenal sebagai akun layanan berbagi perintah, di project Anda dengan izin yang diperlukan untuk berbagi perintah. Untuk mengetahui informasi selengkapnya, lihat Informasi keamanan.

Menyimpan perintah

Untuk menyimpan perintah untuk digunakan atau dibagikan nanti:

  1. Buka Vertex AI Studio.

    Buka Vertex AI Studio

  2. Tulis perintah baru atau buka perintah yang ada, lalu klik kirim Kirim.

  3. Klik tombol Simpan.

Membagikan perintah tersimpan

Setelah berbagi perintah diaktifkan, setiap pengguna Vertex AI dapat membagikan perintah tersimpan.

  1. Di Vertex AI Studio, buka Prompt management atau Chat playground

    Buka Pengelolaan perintah

    Buka playground Chat

  2. Buka perintah tersimpan dan klik tombol Bagikan.

    Jika berbagi perintah berhasil diaktifkan, Anda akan melihat jendela yang mirip dengan berikut ini:

    Jendela berbagi perintah

    Saat perintah dibagikan, penerima perintah yang dibagikan akan menerima notifikasi email yang mirip dengan berikut ini:

    Email berbagi perintah

Berhenti membagikan perintah

Untuk mencabut akses ke perintah:

  1. Buka perintah tersimpan dan klik tombol Bagikan.

  2. Di samping prinsipal, pilih Hapus, lalu klik Simpan.

    Berhenti berbagi dengan perintah

    Perhatikan bahwa menghapus perintah tersimpan akan otomatis menghapus akses bagi siapa pun yang diajak berbagi perintah tersebut.

Informasi keamanan

Saat Anda mengaktifkan berbagi perintah, Anda memberikan izin kepada layanan Vertex AI API untuk mengundang pengguna ke project Anda atas nama Anda. Secara khusus, Anda membuat akun layanan tingkat project, yang dikenal sebagai akun layanan berbagi perintah, di project Anda dengan izin berikut:

  • iam.roles.create
  • iam.roles.list
  • iam.roles.update
  • iam.roles.delete
  • resourcemanager.projects.setIamPolicy
  • resourcemanager.projects.getIamPolicy
  • cloudasset.assets.searchAllIamPolicies

Untuk memastikan bahwa hanya layanan Vertex AI API yang diizinkan untuk menggunakan akun layanan berbagi perintah, sistem akan otomatis membuat kebijakan penolakan saat berbagi perintah diaktifkan.

Langkah Berikutnya