Kontrol akses dengan IAM

Beberapa anggota tim biasanya berkolaborasi dalam membangun agen dan layanan mengakses agen. Dengan menggunakan peran, Anda dapat mengontrol akses dan izin yang diberikan kepada akun utama.

Anda dapat mengonfigurasi akses menggunakan Google Cloud konsol dengan Identity and Access Management (IAM). Konsol Google Cloud digunakan untuk memberikan peran IAM ke akun utama. Lihat mulai cepat IAM untuk mengetahui petunjuk mendetail tentang cara menambahkan, mengedit, dan menghapus izin.

Untuk mengakses setelan, 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 terkaitnya. 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 IAM Service Accounts di konsol Google Cloud .

Menambahkan akun utama

Untuk menambahkan akun utama, lakukan hal berikut:

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

Ubah izin

Untuk mengubah izin, lakukan hal berikut:

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

Menghapus akun utama

Untuk menghapus akun utama, klik untuk akun utama.

Peran IAM

Peran berikut tersedia untuk mengakses CX Agent Studio.

Admin Gemini Enterprise untuk Pengalaman Pelanggan (ces.googleapis.com/admin)

Peran ini memberikan akses penuh ke resource.

Peran dasar:

• ces.googleapis.com/viewer
• ces.googleapis.com/client
• contactcenterinsights.googleapis.com/admin

Izin tambahan:

• ces.googleapis.com/operations.delete
• ces.googleapis.com/operations.cancel
• ces.googleapis.com/apps.create
• ces.googleapis.com/apps.update
• ces.googleapis.com/apps.delete
• ces.googleapis.com/apps.import
• ces.googleapis.com/apps.export
• ces.googleapis.com/apps.runEvaluation
• ces.googleapis.com/agents.create
• ces.googleapis.com/agents.update
• ces.googleapis.com/agents.updateCallbacks
• ces.googleapis.com/agents.updateInstructions
• ces.googleapis.com/agents.updateTools
• ces.googleapis.com/agents.updateGeneral
• ces.googleapis.com/agents.delete
• ces.googleapis.com/examples.create
• ces.googleapis.com/examples.update
• ces.googleapis.com/examples.delete
• ces.googleapis.com/tools.create
• ces.googleapis.com/tools.update
• ces.googleapis.com/tools.delete
• ces.googleapis.com/guardrails.create
• ces.googleapis.com/guardrails.update
• ces.googleapis.com/guardrails.delete
• ces.googleapis.com/toolsets.create
• ces.googleapis.com/toolsets.update
• ces.googleapis.com/toolsets.delete
• ces.googleapis.com/deployments.create
• ces.googleapis.com/deployments.update
• ces.googleapis.com/deployments.delete
• ces.googleapis.com/conversations.delete
• ces.googleapis.com/evaluations.create
• ces.googleapis.com/evaluations.update
• ces.googleapis.com/evaluations.delete
• ces.googleapis.com/evaluationResults.delete
• ces.googleapis.com/evaluationDatasets.create
• ces.googleapis.com/evaluationDatasets.update
• ces.googleapis.com/evaluationDatasets.delete
• ces.googleapis.com/evaluationRuns.delete
• ces.googleapis.com/scheduledEvaluationRuns.create
• ces.googleapis.com/scheduledEvaluationRuns.update
• ces.googleapis.com/scheduledEvaluationRuns.delete
• ces.googleapis.com/appVersions.create
• ces.googleapis.com/appVersions.delete
• ces.googleapis.com/appVersions.restore
• ces.googleapis.com/omnichannels.create
• ces.googleapis.com/omnichannels.update
• ces.googleapis.com/omnichannels.delete
• ces.googleapis.com/apps.createTagBinding
• ces.googleapis.com/apps.deleteTagBinding
• ces.googleapis.com/apps.listTagBindings
• ces.googleapis.com/apps.listEffectiveTags
• ces.googleapis.com/assistantSessions.create
• ces.googleapis.com/routes.create
• ces.googleapis.com/routes.update
• ces.googleapis.com/routes.delete
• ces.googleapis.com/endpointConfigs.create
• ces.googleapis.com/endpointConfigs.update
• ces.googleapis.com/endpointConfigs.delete
• ces.googleapis.com/sipDomains.create
• ces.googleapis.com/sipDomains.update
• ces.googleapis.com/sipDomains.delete
• ces.googleapis.com/securitySettings.update

Pelihat Gemini Enterprise untuk Pengalaman Pelanggan (ces.googleapis.com/viewer)

Peran ini memberikan akses hanya baca ke resource.

Peran dasar:

• contactcenterinsights.googleapis.com/viewer

Izin tambahan:

• cloudresourcemanager.googleapis.com/projects.get
• cloudresourcemanager.googleapis.com/projects.list
• ces.googleapis.com/operations.list
• ces.googleapis.com/operations.get
• ces.googleapis.com/locations.list
• ces.googleapis.com/locations.get
• ces.googleapis.com/apps.list
• ces.googleapis.com/apps.get
• ces.googleapis.com/agents.list
• ces.googleapis.com/agents.get
• ces.googleapis.com/examples.list
• ces.googleapis.com/examples.get
• ces.googleapis.com/tools.list
• ces.googleapis.com/tools.get
• ces.googleapis.com/guardrails.list
• ces.googleapis.com/guardrails.get
• ces.googleapis.com/toolsets.list
• ces.googleapis.com/toolsets.get
• ces.googleapis.com/deployments.list
• ces.googleapis.com/deployments.get
• ces.googleapis.com/conversations.list
• ces.googleapis.com/conversations.get
• ces.googleapis.com/appVersions.list
• ces.googleapis.com/appVersions.get
• ces.googleapis.com/evaluations.list
• ces.googleapis.com/evaluations.get
• ces.googleapis.com/evaluationResults.list
• ces.googleapis.com/evaluationResults.get
• ces.googleapis.com/evaluationDatasets.list
• ces.googleapis.com/evaluationDatasets.get
• ces.googleapis.com/evaluationRuns.list
• ces.googleapis.com/evaluationRuns.get
• ces.googleapis.com/scheduledEvaluationRuns.list
• ces.googleapis.com/scheduledEvaluationRuns.get
• ces.googleapis.com/changelogs.list
• ces.googleapis.com/changelogs.get
• ces.googleapis.com/omnichannels.get
• ces.googleapis.com/omnichannels.list
• ces.googleapis.com/apps.listTagBindings
• ces.googleapis.com/apps.listEffectiveTags
• ces.googleapis.com/assistantSessions.list
• ces.googleapis.com/assistantSessions.get
• ces.googleapis.com/routes.list
• ces.googleapis.com/routes.get
• ces.googleapis.com/endpointConfigs.list
• ces.googleapis.com/endpointConfigs.get
• ces.googleapis.com/sipDomains.list
• ces.googleapis.com/sipDomains.get
• ces.googleapis.com/securitySettings.get

Klien Gemini Enterprise untuk Pengalaman Pelanggan (ces.googleapis.com/client)

Tindakan ini memberikan akses kueri ke agen.

Izin:

• ces.googleapis.com/sessions.runSession
• ces.googleapis.com/sessions.bidiRunSession
• ces.googleapis.com/tools.execute

Editor Aplikasi Gemini Enterprise untuk Pengalaman Pelanggan (ces.googleapis.com/appEditor)

Kontrol penuh atas setelan tingkat aplikasi. Mengelola pencatatan log global, konfigurasi audio/suara, bucket penyimpanan, dan versi aplikasi.

Peran dasar:

• ces.googleapis.com/viewer

Izin tambahan:

• ces.googleapis.com/apps.create
• ces.googleapis.com/apps.update
• ces.googleapis.com/apps.delete
• ces.googleapis.com/apps.import
• ces.googleapis.com/apps.export
• ces.googleapis.com/apps.runEvaluation
• ces.googleapis.com/apps.createTagBinding
• ces.googleapis.com/apps.deleteTagBinding
• ces.googleapis.com/appVersions.create
• ces.googleapis.com/appVersions.delete
• ces.googleapis.com/appVersions.restore

Editor Agen Gemini Enterprise untuk Pengalaman Pelanggan (ces.googleapis.com/agentEditor)

Kontrol penuh atas struktur, alur, petunjuk, dan callback node Agen. Dapat menambahkan/menghapus alat dari agen (tetapi tidak dapat membuat alat baru).

Peran dasar:

• ces.googleapis.com/viewer
• ces.googleapis.com/client

Izin tambahan:

• ces.googleapis.com/agents.create
• ces.googleapis.com/agents.update
• ces.googleapis.com/agents.updateCallbacks
• ces.googleapis.com/agents.updateInstructions
• ces.googleapis.com/agents.updateTools
• ces.googleapis.com/agents.updateGeneral
• ces.googleapis.com/agents.delete
• ces.googleapis.com/examples.create
• ces.googleapis.com/examples.update
• ces.googleapis.com/examples.delete

Editor Alat Pengalaman Pelanggan Gemini Enterprise (ces.googleapis.com/toolsEditor)

Kontrol penuh atas Alat, Kumpulan Alat, dan Integrasi.

Peran dasar:

• ces.googleapis.com/viewer
• ces.googleapis.com/client

Izin tambahan:

• ces.googleapis.com/tools.create
• ces.googleapis.com/tools.update
• ces.googleapis.com/tools.delete
• ces.googleapis.com/toolsets.create
• ces.googleapis.com/toolsets.update
• ces.googleapis.com/toolsets.delete

Editor Batas Keamanan Gemini Enterprise untuk Pengalaman Pelanggan (ces.googleapis.com/guardrailsEditor)

Kontrol penuh atas setelan keselamatan dan batas.

Peran dasar:

- ces.googleapis.com/viewer
- ces.googleapis.com/client

Izin tambahan:

- ces.googleapis.com/guardrails.create
- ces.googleapis.com/guardrails.update
- ces.googleapis.com/guardrails.delete

Editor Evaluasi Gemini Enterprise untuk Pengalaman Pelanggan (ces.googleapis.com/evalsEditor)

Kontrol penuh atas Set data evaluasi, eksekusi, dan hasil.

Peran dasar:

• ces.googleapis.com/viewer
• ces.googleapis.com/client

Izin tambahan:

• ces.googleapis.com/evaluations.create
• ces.googleapis.com/evaluations.update
• ces.googleapis.com/evaluations.delete
• ces.googleapis.com/evaluationResults.delete
• ces.googleapis.com/evaluationDatasets.create
• ces.googleapis.com/evaluationDatasets.update
• ces.googleapis.com/evaluationDatasets.delete
• ces.googleapis.com/evaluationRuns.delete
• ces.googleapis.com/scheduledEvaluationRuns.create
• ces.googleapis.com/scheduledEvaluationRuns.update
• ces.googleapis.com/scheduledEvaluationRuns.delete

Editor Setelan Keamanan Gemini Enterprise untuk Pengalaman Pelanggan (ces.googleapis.com/securitySettingsEditor)

Kontrol penuh atas Setelan Keamanan tingkat project.

Peran dasar:

• ces.googleapis.com/viewer

Izin tambahan:

• ces.googleapis.com/securitySettings.update

Editor Deployment Gemini Enterprise untuk Pengalaman Pelanggan (ces.googleapis.com/deploymentEditor)

Kemampuan untuk mengelola lingkungan dan men-deploy Versi Aplikasi tertentu ke lingkungan tersebut.

Peran dasar:

• ces.googleapis.com/viewer

Izin tambahan:

• ces.googleapis.com/deployments.create
• ces.googleapis.com/deployments.update
• ces.googleapis.com/deployments.delete

Customer Experience Insights

CX Agent Studio terintegrasi dengan CX Insights, dan Anda harus memberikan izin CX Insights berikut kepada prinsipal yang mengakses CX Agent Studio:

• contactcenterinsights.googleapis.com/conversations.get
• contactcenterinsights.googleapis.com/conversations.list

Izin ini secara otomatis disertakan oleh peran turunan ces.googleapis.com/admin dan ces.googleapis.com/viewer. Namun, jika Anda menentukan peran khusus, pastikan untuk menyertakan izin ini dalam definisi peran khusus.

Atau, Anda dapat memberikan salah satu peran CX Insights berikut kepada principal yang relevan:

• contactcenterinsights.googleapis.com/viewer: Memberikan akses hanya baca ke percakapan
• contactcenterinsights.googleapis.com/admin: Memberikan akses penuh ke percakapan

Selain peran, Anda mungkin perlu mengikuti langkah-langkah untuk penyiapan mesin penemuan.

Permintaan yang melibatkan akses Cloud Storage

Beberapa permintaan CX Agent Studio mengakses objek di Cloud Storage untuk membaca atau menulis data. Saat Anda memanggil salah satu permintaan ini, CX Agent Studio mengakses data Cloud Storage atas nama pemanggil. Artinya, autentikasi permintaan Anda harus memiliki izin untuk mengakses CX Agent Studio 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)

Menambahkan kondisi untuk membatasi akses ke satu aplikasi agen

Saat menambahkan atau mengedit akun utama, Anda dapat membuat binding peran bersyarat yang membatasi akses ke satu aplikasi agen.

Kondisi berikut memberikan akses ke aplikasi agen tertentu serta resource level teratas dalam project yang diperlukan oleh aplikasi agen:

resource.name == "projects/PROJECT_ID" ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/apps/APP_ID") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/operations") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/sipDomains") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/omnichannels") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/dataStores") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/routes") ||
resource.name.startsWith("projects/PROJECT_ID/locations/LOCATION_ID/endpointConfigs")

Untuk memiliki akses ke Customer Experience Insights, Anda harus memberikan peran Customer Experience Insights selain pemberian bersyarat.