Kontrol akses

Beberapa anggota tim sering kali berkolaborasi dalam membuat agen dan layanan untuk mengakses agen. Dengan menggunakan peran, Anda dapat mengontrol akses dan izin yang diberikan kepada prinsipal.

Anda dapat mengonfigurasi akses menggunakan konsol Dialogflow CX (kunjungi dokumentasi, buka konsol) atau dengan menggunakan konsol Google Cloud (kunjungi dokumentasi, buka konsol) dengan Identity and Access Management (IAM). Konsol Google Cloud digunakan untuk memberikan peran IAM kepada akun utama, sedangkan konsol Dialogflow CX digunakan untuk memberikan peran agen Agen Percakapan (Dialogflow CX) kepada akun utama. Peran agen Agen Percakapan (Dialogflow CX) adalah peran standar yang praktis dan ditentukan oleh Agen Percakapan (Dialogflow CX) yang membatasi akses ke satu agen atau resource turunan dari agen tertentu.

Ada beberapa situasi saat Anda harus menggunakan Konsol Google Cloud:

• Peran Project Owner IAM secara default diberikan kepada pengguna yang membuat project yang memiliki agen. Pemilik ini memiliki akses penuh ke semua agen dalam project. Jika ingin mengubah pemilik project, Anda harus menggunakan konsol Google Cloud.
• Hanya akses tingkat agen yang dapat dikonfigurasi melalui konsol Dialogflow CX. Jika ingin mengonfigurasi akses tingkat project, Anda harus menggunakan konsol Google Cloud.
• Sebagian peran IAM memiliki peran agen Agen Percakapan (Dialogflow CX) yang sesuai. Jika ingin memberikan peran tingkat project atau tingkat agen yang tidak ada di konsol Dialogflow CX, Anda harus menggunakan konsol Google Cloud.
• Jika Anda membuat agen penyimpanan data dengan antarmuka pengguna Vertex AI Conversation, Anda harus menggunakan konsol Google Cloud.

Jika menggunakan API, Anda mungkin juga memiliki satu atau beberapa aplikasi yang mengirim permintaan ke agen. Dalam hal ini, Anda dapat mengontrol akses dengan akun layanan.

Mengontrol akses dengan konsol Dialogflow CX

Konsol Dialogflow CX memungkinkan Anda menerapkan peran agen yang praktis yang dikonfigurasi untuk berbagi tingkat agen. Peran ini berkorelasi dengan peran IAM dengan kondisi IAM yang membatasi akses ke agen tertentu atau subset resource turunan agen.

Untuk mengakses konfigurasi peran agen dari konsol Dialogflow CX, Anda harus diberi peran Project IAM Admin untuk project terkait. Peran ini diberikan dari konsol Google Cloud.

Catatan: Konsol Dialogflow CX hanya akan menampilkan akun utama dengan peran khusus dan kondisi khusus agen ini. Jika Anda telah menggunakan konsol Google Cloud untuk menambahkan akun utama dengan peran atau kondisi apa pun, akun tersebut tidak akan muncul di konsol Dialogflow CX.

Peran agen Agen Percakapan (Dialogflow CX)	Ringkasan	Peran IAM
Admin	Memberikan akses penuh untuk membuat, memperbarui, membuat kueri, mendeteksi intent, dan menghapus agen dari konsol atau API.	Dialogflow > Dialogflow API Admin
Pembaca	Memberikan akses baca untuk mengkueri (bukan mendeteksi intent) agen dari konsol atau API.	Dialogflow > Dialogflow API Reader
Klien	Memberikan akses untuk mendeteksi intent dari konsol atau API.	Dialogflow > Dialogflow API Client
Intent Admin	Memberikan akses untuk membuat, memperbarui, menghapus, atau membuat kueri intent agen dari konsol atau API.	Dialogflow > Dialogflow Intent Admin
Admin Jenis Entitas	Memberikan akses untuk membuat, memperbarui, menghapus, atau membuat kueri jenis entity agen dari konsol atau API.	Dialogflow > Dialogflow Entity Type Admin
Admin Webhook	Memberikan akses untuk membuat, memperbarui, menghapus, atau membuat kueri webhook agen dari konsol atau API.	Dialogflow > Dialogflow Webhook Admin
Test Case Admin	Memberikan akses untuk membuat, memperbarui, menghapus, atau membuat kueri kasus pengujian agen dari konsol atau API.	Dialogflow > Dialogflow Test Case Admin
Editor alur	Memberikan akses untuk memperbarui, membuat kueri alur tertentu, serta membuat, memperbarui, menghapus, atau membuat kueri resource alur (halaman, grup rute, dan versi) dari konsol atau API.	Dialogflow > Editor Dialogflow Flow
Editor lingkungan	Memberikan akses untuk memperbarui, membuat kueri lingkungan tertentu, serta membuat, memperbarui, menghapus, atau membuat kueri resource lingkungan (eksperimen) dari konsol atau API.	Dialogflow > Editor Lingkungan Dialogflow

Opsi berbagi dapat ditemukan di setelan agen. Untuk membuka setelan berbagi agen:

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Klik Setelan Agen.
5. Klik tab Bagikan.

Menambahkan akun utama

1. Klik Tambahkan.
2. Masukkan alamat email untuk pengguna, grup, atau akun layanan.
3. Pilih Pengguna, Grup, atau Akun Layanan untuk jenis email.
4. Peran Dialogflow Reader ditambahkan secara default, yang diperlukan agar pengguna dapat mengakses konsol Dialogflow CX.
5. Klik Tambahkan peran di bagian Tetapkan peran.
6. Pilih jenis peran di bagian Jenis.
7. Untuk peran Flow Editor dan Environment Editor, pilih alur atau lingkungan tertentu atau biarkan opsi default Semua.
8. Secara opsional, tetapkan tanggal habis masa berlaku untuk peran.
9. Klik Simpan.

Mengubah peran akun utama

1. Klik akun utama dalam daftar.
2. Perbarui peran untuk akun utama ini di pop-up.
3. Klik Simpan.

Menghapus akun utama

1. Temukan akun utama dalam daftar.
2. Klik tombol hapus untuk akun utama.
3. Klik Ok.

Catatan: Setelah Anda menerapkan perubahan peran akun utama, mungkin ada penundaan sebelum perubahan diterapkan.

Mengontrol akses dengan konsol Google Cloud

Anda dapat mengontrol akses dengan setelan IAM. Lihat panduan memulai IAM untuk petunjuk mendetail tentang cara menambahkan, mengedit, dan menghapus izin.

Untuk mengakses setelan di bawah, buka halaman IAM di konsol Google Cloud.

Menambahkan akun pengguna atau layanan ke project

Anda dapat memberikan izin kepada pengguna atau akun layanan dengan memberikan peran kepada mereka di project Google Cloud Anda. Pengguna ditambahkan dengan memberikan alamat email mereka. Akun layanan juga ditambahkan dengan memberikan alamat email terkait. Anda perlu menambahkan akun layanan jika ingin menggunakan satu akun layanan untuk beberapa project. Untuk menemukan alamat email yang terkait dengan akun layanan Anda, lihat halaman Service Accounts IAM di konsol Google Cloud.

Untuk menambahkan akun utama:

1. Klik tombol tambahkan di bagian atas halaman.
2. Masukkan alamat email kepala sekolah.
3. Pilih peran.
4. Klik Simpan.

Ubah izin

1. Klik tombol edit untuk akun utama.
2. Pilih peran lain.
3. Klik Simpan.

Menghapus akun utama

1. Klik tombol hapus untuk akun utama.

Menambahkan kondisi untuk membatasi akses ke satu agen

Saat menambahkan atau mengedit akun utama, Anda dapat membuat kondisi IAM yang membatasi akses ke satu agen.

Catatan: Berikan peran agen ke email pengguna untuk akses konsol CX secara langsung di konsol Dialogflow CX.

Contoh:

{
    "expression": "resource.name.startsWith(\"projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID\")",
    "title": "For Conversational Agents (Dialogflow CX) Agent AGENT_ID"
}

Kondisi ini memberi Anda akses dasar ke agen tertentu. Misalnya, akun layanan dengan kondisi ini hanya dapat memanggil API Agen Percakapan (Dialogflow CX) untuk mengakses agen yang ditentukan dalam kondisi untuk project, tetapi tidak dapat mengakses agen lain dalam project.

Untuk menambahkan kondisi ini ke peran yang diberikan kepada akun utama:

1. Pilih akun utama.
2. Klik tombol edit untuk akun utama.
3. Klik Add condition.
4. Di kolom Title, masukkan For Conversational Agents (Dialogflow CX) Agent AGENT_ID dan ganti AGENT_ID dengan ID agen Anda.
5. Anda dapat menambahkan deskripsi apa pun.
6. Pilih Editor kondisi untuk membuat kondisi.
7. Tambahkan ekspresi resource.name.startsWith("projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID"), ganti AGENT_ID dengan ID agen Anda dan PROJECT_ID dengan project ID Anda.
8. Klik Simpan.

Peran IAM

Tabel berikut mencantumkan peran IAM umum yang relevan dengan Agen Percakapan (Dialogflow CX). Ringkasan izin dalam tabel menggunakan istilah berikut:

• Akses penuh: Izin untuk mengubah akses, membuat, menghapus, mengedit, dan membaca resource apa pun.
• Akses edit: Izin untuk membuat, menghapus, mengedit, dan membaca resource apa pun.
• Akses sesi: Izin untuk memanggil metode untuk resource khusus runtime selama percakapan seperti mendeteksi intent, memperbarui konteks, memperbarui entity sesi, atau interaksi percakapan Agent Assist.
• Akses baca: Izin untuk membaca resource apa pun.

Catatan: Untuk mengubah akses agen, Anda memerlukan peran yang memberikan akses penuh ke agen. Untuk menghapus agen, Anda memerlukan peran yang memberikan akses penuh atau akses edit ke agen.

Catatan: Simulator konsol memanggil metode detectIntent API selama percakapan. Metode ini melakukan operasi tulis pada status sesi. Untuk menggunakan konsol atau memanggil metode detectIntent/streamingDetectIntent API, Anda memerlukan peran yang memberikan akses penuh, akses edit, atau akses sesi.

Peran IAM	Ringkasan Izin	Detail Izin
Project > Owner	Berikan kepada pemilik project yang memerlukan akses penuh ke semua resource Google Cloud dan Agen Percakapan (Dialogflow CX): Akses penuh ke semua resource project Google Cloud menggunakan konsol atau API Google Cloud. Akses penuh ke agen menggunakan konsol Dialogflow CX. Dapat mendeteksi intent menggunakan API.	Lihat definisi peran dasar IAM.
Project > Editor	Berikan kepada editor project yang memerlukan akses edit ke semua resource Google Cloud dan Agen Percakapan (Dialogflow CX): Mengedit akses ke semua resource project Google Cloud menggunakan Konsol Google Cloud atau API. Edit akses ke agen menggunakan konsol Dialogflow CX. Dapat mendeteksi intent menggunakan API.	Lihat definisi peran dasar IAM.
Project > Viewer	Berikan kepada pelihat project yang memerlukan akses baca ke semua resource Google Cloud dan Agen Percakapan (Dialogflow CX): Akses baca ke semua resource project Google Cloud menggunakan Konsol Google Cloud atau API. Akses baca ke agen menggunakan konsol atau API Dialogflow CX, tidak dapat menggunakan simulator. Tidak dapat mendeteksi intent menggunakan API.	Lihat definisi peran dasar IAM.
Project > IAM Admin	Berikan kepada admin IAM project yang memerlukan akses edit ke konfigurasi peran agen Agen Percakapan (Dialogflow CX).	Lihat definisi peran pengelola resource IAM.
Project > Browser	Berikan kepada browser project yang memerlukan akses baca untuk menjelajahi hierarki project, termasuk folder, organisasi, dan kebijakan IAM: Akses baca ke hierarki project Google Cloud. Tidak ada akses ke agen yang menggunakan konsol Dialogflow CX. Tidak dapat mendeteksi intent menggunakan API.	Lihat Definisi peran project IAM.
Dialogflow > Dialogflow API Admin	Berikan kepada admin API Agen Percakapan (Dialogflow CX) yang memerlukan akses penuh ke resource khusus Agen Percakapan (Dialogflow CX): Akses penuh ke semua resource Agen Percakapan (Dialogflow CX) menggunakan konsol atau API Google Cloud. Akses penuh ke agen menggunakan konsol Dialogflow CX. Dapat mendeteksi intent menggunakan API.	Lihat Definisi peran IAM Dialogflow.
Dialogflow > Dialogflow API Client	Berikan kepada klien API Agen Percakapan (Dialogflow CX) yang melakukan panggilan intent deteksi menggunakan API: Akses sesi ke resource Agen Percakapan (Dialogflow CX) runtime menggunakan simulator atau API Agen Percakapan (Dialogflow CX). Akses terbatas ke agen yang menggunakan konsol Dialogflow CX. Dapat mendeteksi intent menggunakan API.	Lihat Definisi peran IAM Dialogflow.
Dialogflow > Dialogflow CX console Agent Editor	Berikan kepada editor konsol Dialogflow CX yang mengedit agen yang ada: Akses penuh ke semua resource Agen Percakapan (Dialogflow CX) menggunakan konsol Google Cloud. Edit akses ke sebagian besar data agen menggunakan konsol Dialogflow CX. Dapat mendeteksi intent menggunakan API.	Lihat Definisi peran IAM Dialogflow.
Dialogflow > Dialogflow API Reader	Berikan kepada klien Dialogflow API yang melakukan panggilan hanya baca khusus Agen Percakapan (Dialogflow CX) menggunakan API: Akses baca ke semua resource Agen Percakapan (Dialogflow CX) menggunakan konsol atau API Google Cloud. Akses baca ke agen menggunakan konsol Dialogflow CX, tidak dapat menggunakan simulator. Tidak dapat mendeteksi intent menggunakan API.	Lihat Definisi peran IAM Dialogflow.
Discovery Engine Admin	Berikan kepada pengguna yang membuat agen penyimpanan data dengan antarmuka pengguna Agen Vertex AI.	Lihat Definisi peran lainnya.

OAuth

Jika menggunakan library klien Google untuk mengakses Agen Percakapan (Dialogflow CX), Anda tidak perlu menggunakan OAuth secara langsung, karena library ini menangani penerapan untuk Anda. Namun, jika Anda menerapkan klien Anda sendiri, Anda mungkin perlu menerapkan alur OAuth Anda sendiri. Akses ke Conversational Agents (Dialogflow CX) API memerlukan salah satu cakupan OAuth berikut:

• https://www.googleapis.com/auth/cloud-platform (akses ke semua resource project)
• https://www.googleapis.com/auth/dialogflow (akses ke resource Agen Percakapan (Dialogflow CX))

Permintaan yang melibatkan akses Cloud Storage

Beberapa Agen Percakapan (Dialogflow CX) meminta objek akses di Cloud Storage untuk membaca atau menulis data. Saat Anda memanggil salah satu permintaan ini, Agen Percakapan (Dialogflow CX) akan mengakses data Cloud Storage atas nama pemanggil. Artinya, autentikasi permintaan Anda harus memiliki izin untuk mengakses Agen Percakapan (Dialogflow CX) serta objek Cloud Storage.

Saat menggunakan library klien Google dan peran IAM, lihat panduan kontrol akses Cloud Storage untuk mengetahui informasi tentang peran Cloud Storage.

Saat menerapkan klien Anda sendiri dan menggunakan OAuth, Anda harus menggunakan cakupan OAuth berikut:

• https://www.googleapis.com/auth/cloud-platform (akses ke semua resource project)

Kontrol akses konsol Builder Agen

Lihat panduan kontrol akses untuk Vertex AI Agent Builder dan Discovery Engine.

Peran kustom untuk akses alat playbook

Anda dapat memberikan kontrol akses terperinci untuk alat playbook dengan menggunakan izin dan peran kustom.

Anda dapat mencantumkan izin yang tersedia dengan membuka alat penelusuran izin dan menelusuri dialogflow.tools.

Dengan izin tersebut, Anda dapat membuat peran khusus.