Saat melakukan percakapan dengan asisten Gemini Enterprise, pengguna dapat melampirkan file menggunakan pemilih file. Asisten mendukung tiga sumber file: File lokal, file dari Google Drive, dan file dari Microsoft OneDrive. Halaman ini menjelaskan cara administrator mengonfigurasi perilaku ini.
Jika Anda ingin pengguna akhir memilih file dari Google Drive dan OneDrive, Anda dapat mengontrol cara pengguna akhir login dengan menggunakan kembali konfigurasi penyimpanan data yang Anda siapkan saat mengonfigurasi penyimpanan data Google Drive dan penyimpanan data OneDrive. Hal ini memberi Anda kontrol atas hal berikut:
- Aplikasi login yang digunakan pemilih. Pemilih dapat menggunakan kembali aplikasi Microsoft Entra (sebelumnya Azure AD) atau Google yang Anda konfigurasi di konektor, bukan aplikasi default yang dikelola Google.
- Tenant Microsoft Entra yang digunakan pemilih OneDrive. Pemilih OneDrive dapat membuat pengguna login ke tenant Microsoft Entra tertentu.
Untuk pengalaman pengguna akhir dalam melampirkan dan melakukan percakapan tentang file, lihat Mengupload dan melakukan percakapan tentang file.
Cara kerja pemilih file
Jika Anda mengonfigurasi penyimpanan data Google Drive dan OneDrive agar menggunakan konfigurasi otorisasi yang sama untuk pemilih file, pemilih file akan menggunakan setelan yang sama untuk mengautentikasi pengguna. Tabel berikut merangkum dua kontrol dan pemilih yang terpengaruh.
| Kontrol | Fungsi | Berlaku untuk |
|---|---|---|
| Aplikasi login kustom | Untuk mengautentikasi pengguna saat mereka melampirkan file ke asisten menggunakan pemilih file, Gemini Enterprise dapat menggunakan konfigurasi Microsoft Entra ID atau Google Identity yang ada di penyimpanan data Anda, bukan aplikasi default yang dikelola Google. | Google Drive dan OneDrive |
| Penegakan tenant | Pemilih OneDrive mengharuskan pengguna login ke tenant Microsoft Entra tertentu (https://login.microsoftonline.com/{your-tenant}/...), bukan endpoint login bersama (/common/), sehingga pengguna dari tenant lain tidak dapat melakukan autentikasi. Tenant dibaca dari
konektor OneDrive yang terpasang. |
Khusus OneDrive |
Administrator melampirkan konektor ke aplikasi untuk mengonfigurasi perilaku ini.
Saat Anda menetapkan penyedia konfigurasi, aturan berikut berlaku:
- Satu penyedia per jenis konektor. Anda hanya dapat melampirkan satu penyedia konfigurasi OneDrive dan satu penyedia konfigurasi Google Drive ke aplikasi dalam satu waktu. Menandai konektor kedua dari jenis yang sama sebagai penyedia akan ditolak dengan error argumen tidak valid.
- Penyedia harus berupa konektor yang mendukung tindakan. Penyedia konfigurasi harus berupa konektor OneDrive atau Google Drive yang mendukung tindakan atau akses gabungan. Konektor khusus penyerapan tidak dapat menjadi penyedia konfigurasi. Untuk mengetahui informasi selengkapnya, lihat Mengelola tindakan.
Sebelum memulai
Konfirmasi hal berikut sebelum Anda mengonfigurasi pemilih file:
- Akses administrator.
Berikan peran Discovery Engine Editor (
roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:- Di konsol Google Cloud , buka halaman IAM.
- Temukan akun pengguna, lalu klik edit Edit.
- Berikan peran
Discovery Engine Editorkepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.
- Aplikasi login OneDrive kustom. Pastikan Anda memiliki aplikasi Microsoft Entra ID yang Anda kontrol, termasuk client ID, rahasia klien, dan ID tenant-nya, serta akun OneDrive dalam tenant tersebut untuk pengujian. Untuk mengetahui informasi selengkapnya, lihat Register an application with the Microsoft identity platform.
- Penyimpanan data yang dikonfigurasi. Konfigurasikan penyimpanan data OneDrive atau penyimpanan data Google Drive. Saat mengonfigurasi penyimpanan data, Anda mengonfigurasi setelan autentikasi yang mencakup client ID dan rahasia klien, serta tenant ID untuk penyimpanan data OneDrive. Untuk mengetahui informasi selengkapnya, lihat:
- Penyimpanan data terlampir. Lampirkan penyimpanan data OneDrive atau penyimpanan data Google Drive ke aplikasi Gemini Enterprise Anda. Untuk mengetahui informasi selengkapnya, lihat Menghubungkan penyimpanan data ke aplikasi.
Menggunakan aplikasi login Anda sendiri
Secara default, pemilih menggunakan aplikasi yang dikelola Google untuk login. Anda dapat membuat pemilih menggunakan Microsoft Entra ID atau Google Identity Anda sendiri dengan menetapkan satu konektor sebagai penyedia konfigurasi pemilih.
Jika Anda sudah memiliki penyimpanan data OneDrive atau Google Drive yang dikonfigurasi, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise.
Pilih atau buat project Google Cloud .
Di menu navigasi, klik Penyimpanan data.
Telusuri penyimpanan data Anda, lalu klik nama penyimpanan data tersebut.
Klik Lihat/Edit parameter.
Pilih opsi Picker Config Provider.
Klik Simpan.
Mengembalikan perubahan untuk menggunakan aplikasi yang dikelola Google
Untuk kembali menggunakan aplikasi default yang dikelola Google untuk autentikasi pemilih file, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise.
Pilih project Google Cloud Anda.
Di menu navigasi, klik Penyimpanan data.
Klik nama penyimpanan data Anda.
Klik Lihat/Edit parameter.
Kosongkan kolom Picker Config Provider.
Klik Simpan.
Pengalaman pengguna akhir
Setelah Anda mengonfigurasi pemilih, pengguna akhir akan memiliki pengalaman berikut:
- Untuk OneDrive, pengguna akan diminta untuk login ke tenant Microsoft organisasi Anda. Akun dari tenant lain akan ditolak.
- Login menggunakan aplikasi apa pun yang Anda konfigurasi: aplikasi yang dikelola Google secara default, atau aplikasi Anda sendiri jika Anda menetapkan penyedia konfigurasi.
- Setelah login pertama berhasil, koneksi akan diingat untuk pemilihan file berikutnya.
Untuk mengetahui informasi selengkapnya tentang pengalaman pengguna akhir, lihat Mengupload dan melakukan percakapan tentang file.
Pemecahan masalah
| Gejala | Kemungkinan penyebab | Resolusi |
|---|---|---|
Menandai konektor sebagai **Picker Config Provider** akan gagal dengan
Cannot enable picker_config_provider on data connector '...'
because another connector in the same engine is already the picker config
provider: '...'. An engine can have at most one picker_config_provider
connector; disable it on the other connector first. |
Konektor lain di mesin yang sama sudah menjadi penyedia konfigurasi pemilih. Mesin hanya dapat memiliki maksimal satu. | Hapus parameter **Picker Config Provider** di konektor lain, lalu coba lagi. |
Login OneDrive gagal dengan AADSTS50020: User account
'user@domain.com' from identity provider '...' does not exist in tenant
'...' |
Akun pengguna berada di tenant Microsoft Entra yang berbeda dengan tenant yang dikonfigurasi pada konektor. Endpoint login khusus tenant menolak akun. | Penegakan tenant berfungsi sebagaimana mestinya. Minta pengguna login dengan akun di tenant yang dikonfigurasi, atau perbarui ID tenant konektor. |
| OneDrive masih meminta endpoint login bersama. | Tenant belum dikonfigurasi, atau perubahan belum diterapkan. | Konfirmasi ID tenant konektor. Perubahan konfigurasi dapat memerlukan waktu hingga sekitar 3 menit untuk diterapkan; tunggu, lalu coba lagi. |
Langkah berikutnya
- Siapkan konektor Microsoft OneDrive.
- Siapkan konektor Google Drive.
- Pelajari pengalaman pengguna akhir di Mengupload dan memulai percakapan tentang file.