Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Google Drive ke Gemini Enterprise. Koneksi ini memungkinkan Gemini Enterprise mengambil informasi langsung dari Google Drive. Karena data tidak disalin ke indeks Gemini Enterprise, Anda tidak perlu mengelola penyimpanan data.
Sebelum memulai
Untuk menyiapkan lingkungan Google Drive sebelum membuat penyimpanan data, lakukan hal berikut:
Anda harus login ke konsol Google Cloud dengan akun yang sama dengan yang Anda gunakan untuk instance Google Drive yang ingin Anda hubungkan. Gemini Enterprise menggunakan ID pelanggan Google Workspace Anda untuk terhubung ke Google Drive. Akun Google pribadi (akun konsumen yang diakhiri dengan
@gmail.com) tidak memiliki ID pelanggan dan tidak didukung.Untuk menerapkan kontrol akses sumber data dan mengamankan data di Gemini Enterprise, pastikan Anda telah mengonfigurasi penyedia identitas.
Pastikan semua dokumen dapat diakses, baik dengan menempatkannya di drive bersama yang dimiliki oleh domain atau dengan menetapkan kepemilikan kepada pengguna di domain.
Aktifkan akses Gemini Enterprise di Google Workspace: Di Google konsol Admin, administrator Google Workspace untuk organisasi tempat pengguna dan residensi data Google Drive Anda berada harus mengaktifkan Izinkan Gemini Enterprise mengakses data Google Workspace. Jika setelan ini dinonaktifkan, penelusuran Google Drive tidak akan menampilkan hasil di aplikasi web Gemini Enterprise (dan dapat menampilkan error
403 Permission Denied: Workspace access for Agentspace disabled by organization admin.di API). Untuk mengetahui petunjuknya, lihat Mengontrol akses Gemini Enterprise ke data Google Workspace.Aktifkan fitur cerdas: Di akun Google Workspace Anda, aktifkan Fitur cerdas di Google Workspace dan Fitur cerdas di produk Google Google lainnya. Untuk mengetahui detailnya, lihat Mengaktifkan atau menonaktifkan fitur cerdas Google Workspace.
Tambahkan aplikasi OAuth ke daftar yang diizinkan: Penyimpanan data Google Drive menggunakan aplikasi OAuth yang dikelola Googleuntuk mengakses data Anda. Jika organisasi Anda membatasi akses aplikasi OAuth, administrator Google Workspace Anda harus menambahkan aplikasi ini ke daftar yang diizinkan organisasi Anda. Untuk mengetahui detailnya, lihat Mengizinkan aplikasi OAuth yang dikelola Google.
Konfigurasikan akses lintas organisasi (jika ada): Secara default, Gemini Enterprise hanya mengizinkan pengguna menelusuri penyimpanan data Google Drive jika ID pelanggan Google Workspace pengguna cocok dengan organisasi penyimpanan data Google Drive dan project Google Cloud . Jika pengguna atau data Google Drive Anda termasuk dalam organisasi Google Workspace yang berbeda (misalnya, saat project Google Cloud Anda berada di satu domain dan pengguna login dari satu atau beberapa domain Google Workspace atau tenant pengujian terpisah), selesaikan langkah-langkah berikut:
- Hubungi Cloud Customer Care untuk menambahkan
ID pelanggan organisasi Google Workspace setiap pengguna (misalnya,
C01234567) ke daftar yang diizinkan untuk project Google Cloud Anda. - Minta administrator Google Workspace di setiap organisasi Google Workspace mengaktifkan Izinkan Gemini Enterprise mengakses data Google Workspace di konsol Admin Google organisasi tersebut. Mengaktifkan setelan ini hanya di organisasi project Google Cloud tidaklah cukup. Untuk mengetahui detailnya, lihat Mengontrol akses Gemini Enterprise ke data Google Workspace.
Selain itu, jika pengguna perlu menemukan dokumen yang dimiliki di luar organisasi mereka sendiri, aktifkan Sertakan dokumen lintas domain untuk aplikasi Anda. Anda dapat memilih opsi ini saat membuat aplikasi atau mengaktifkannya nanti di Kelola fitur aplikasi web.
- Hubungi Cloud Customer Care untuk menambahkan
ID pelanggan organisasi Google Workspace setiap pengguna (misalnya,
Membuat penyimpanan data Google Drive
Untuk membuat penyimpanan data Google Drive, lakukan langkah-langkah berikut:
Di konsol Google Google Cloud , buka halaman Gemini Enterprise.
Pilih atau buat project Google Cloud .
Di menu navigasi, klik Penyimpanan data.
Klik Buat penyimpanan data.
Di bagian Source, telusuri Google Drive, lalu klik Select.
Opsional: Di bagian Data, konfigurasikan filter yang mencakup konten Google Drive yang ditelusuri penyimpanan data. Untuk mengonfigurasi filter menggunakan konsol Google Cloud atau REST API, pilih salah satu opsi berikut:
Konsol
- Di kolom ID Drive Bersama, kolom ID Folder, atau keduanya, masukkan ID yang ingin Anda filter.
- Untuk setiap kolom, pilih Sertakan untuk menelusuri hanya ID yang ditentukan, atau Kecualikan untuk menghilangkannya dari penelusuran. Konfigurasikan mode Include atau mode Exclude untuk setiap kolom, tetapi tidak keduanya.
- Untuk menemukan ID folder atau ID drive bersama, buka folder atau drive bersama di Google Drive, lalu salin ID dari URL. URL
mengikuti format ini:
https://drive.google.com/drive/folders/ID. Contoh,https://drive.google.com/drive/folders/123456789012345678901.
REST API
Untuk membuat penyimpanan data dengan filter, panggil metode
setUpDataConnector.Daftar penyertaan ditetapkan di bagian
admin_filterdan daftar pengecualian ditetapkan di bagianadmin_exclusion_filter. Untuk setiap jenis filter, isi daftar di bagianadmin_filteratau di bagianadmin_exclusion_filter, tetapi tidak keduanya.curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \ -d '{ "collectionId": "COLLECTION_ID", "collectionDisplayName": "COLLECTION_DISPLAY_NAME", "dataConnector": { "dataSource": "google_drive", "params": { "FILTER_TYPE": { "FILTER_KEY": [ "FILTER_VALUE_1", "FILTER_VALUE_2" ] } }, "entities": [ { "entityName": "google_drive" } ], "connectorModes": [ "FEDERATED" ] } }'
Ganti kode berikut:
-
PROJECT_ID: ID project Anda. -
ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
-
LOCATION: multi-region penyimpanan data Anda:globalatauus. -
COLLECTION_ID: ID unik penyimpanan data. -
COLLECTION_DISPLAY_NAME: nama tampilan penyimpanan data. -
FILTER_TYPE: jenis filter, baikadmin_filteruntuk penyertaan atauadmin_exclusion_filteruntuk pengecualian. Isi daftar di bagianadmin_filteratau di bagianadmin_exclusion_filter, tetapi tidak keduanya. -
FILTER_KEY: entitas Drive yang akan difilter, baikSharedDriveIdsmaupunFolderIds. -
FILTER_VALUE_1,FILTER_VALUE_2: ID drive bersama atau ID folder yang akan difilter.
Di bagian Tindakan, pilih tindakan dari daftar untuk mengaktifkannya bagi konektor Google Drive.
Untuk mengelola daftar tindakan, lihat Mengelola tindakan.
Klik Lanjutkan.
Di bagian Configuration:
- Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
- Di kolom Data connector name, masukkan nama untuk konektor Anda.
- Jika Anda memilih
usataueusebagai lokasi, konfigurasikan Setelan enkripsi:- Pilih Google-managed encryption key atau Cloud KMS key.
- Jika Anda memilih Cloud KMS key:
- Dalam daftar Key management type, pilih jenis yang sesuai.
- Di daftar Cloud KMS key, pilih kunci.
Opsional: Di kolom Tag, masukkan ID stabil untuk penyimpanan data. ID ini digunakan di berbagai versi konektor dan menjadi tidak dapat diubah setelah penyimpanan data dibuat, jadi pilih nilai yang tidak perlu Anda ubah nanti.
Opsional: Di bagian Sensitive Data Protection policy, lampirkan Sensitive Data Protection content policy yang ada untuk memeriksa dan memblokir data sensitif yang diambil Gemini Enterprise melalui penyimpanan data ini. Untuk mengetahui informasi selengkapnya, lihat Melindungi data sensitif di sumber. Jika organisasi Anda tidak memerlukan kebijakan konten Sensitive Data Protection, Anda dapat melewati langkah ini.
Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkan penyimpanan data Anda di halaman Data Stores.
Untuk memverifikasi status penyimpanan data, lakukan tindakan berikut:
- Buka konektor di daftar penyimpanan data dan pantau statusnya hingga berubah menjadi Active.
- Saat status penyimpanan data berubah dari Creating menjadi Active, konektor Google Drive siap digunakan.
Setelah membuat penyimpanan data, buat aplikasi dan hubungkan ke penyimpanan data Google Drive sebelum menjalankan kueri.
Eksekusi kueri
Setelah Anda mengizinkan Google Drive, saat Anda memasukkan kueri penelusuran:
Gemini Enterprise mengirimkan kueri penelusuran Anda ke Google Drive API.
Gemini Enterprise menggabungkan hasil tersebut dengan hasil dari sumber lain dan menampilkannya.
Pesan error dan pemecahan masalah
Tabel berikut menjelaskan pesan error, termasuk kode error HTTP dan langkah-langkah pemecahan masalah yang disarankan, yang mungkin Anda temui saat menggunakan sumber data Google ini.
| Kode error | Pesan error | Deskripsi | Pemecahan masalah |
|---|---|---|---|
| 403 Permission Denied | Penelusuran menggunakan kredensial akun layanan tidak didukung untuk penyimpanan data Google Workspace. | Mesin yang ditelusuri memiliki penyimpanan data Google Workspace, dan kredensial yang diteruskan adalah kredensial akun layanan. Penelusuran menggunakan kredensial akun layanan di penyimpanan data Google Workspace tidak didukung. | Panggil penelusuran menggunakan kredensial pengguna, atau hapus penyimpanan data Google Workspace dari mesin. |
| 403 Permission Denied | Akun konsumen tidak didukung untuk penyimpanan data Google Workspace. | Penelusuran dipanggil menggunakan kredensial akun konsumen (@gmail.com), yang tidak didukung untuk penyimpanan data Google Workspace. | Hapus penyimpanan data Google Workspace dari mesin atau gunakan Akun Google terkelola. |
| 403 Permission Denied | ID pelanggan tidak cocok untuk penyimpanan data | Penelusuran hanya diizinkan untuk pengguna yang ID pelanggan Google Workspace-nya cocok dengan organisasi penyimpanan data Google Workspace dan project Google Cloud , kecuali jika ID pelanggan Google Workspace pengguna ada dalam daftar yang diizinkan untuk project tersebut. | Jika ketidakcocokan tidak disengaja, buat ulang penyimpanan data di project Google Cloud yang termasuk dalam organisasi yang sama dengan pengguna Google Workspace Anda, atau hapus penyimpanan data Google Workspace dari aplikasi. Jika pengguna dan penyimpanan data Google Workspace dimaksudkan untuk berada di organisasi yang berbeda, hubungi Cloud Customer Care untuk menambahkan setiap ID pelanggan Google Workspace pengguna ke daftar yang diizinkan untuk project Google Cloud Anda, pastikan administrator Google Workspace di setiap organisasi pengguna mengaktifkan akses Gemini Enterprise ke data Google Workspace. Selain itu, jika pengguna perlu menemukan dokumen yang dimiliki di luar organisasi mereka sendiri, aktifkan Sertakan dokumen lintas domain di Kelola fitur aplikasi web. |
| 403 Permission Denied | Akses Workspace untuk Agentspace dinonaktifkan oleh administrator organisasi. | Administrator Google Workspace di organisasi Google Workspace pengguna telah menonaktifkan akses ke data Google Workspace untuk Gemini Enterprise. Di aplikasi web Gemini Enterprise, error ini mungkin tidak ditampilkan secara langsung; sebagai gantinya, kueri tidak menampilkan file Google Drive yang cocok. | Hubungi administrator Google Workspace untuk organisasi Google Workspace pengguna guna mengaktifkan akses. Dalam penyiapan lintas organisasi, setelan ini harus diaktifkan di konsol Admin Google setiap organisasi Google Workspace yang penggunanya mengkueri Google Drive. |
| 400 Invalid Argument | Permintaan berisi argumen yang tidak valid. | Error ini terjadi jika nama konektor data dalam permintaan tidak memenuhi persyaratan penamaan. Verifikasi nama konektor data, pastikan panjangnya antara 1 hingga 63 karakter, diawali dengan huruf kecil, diakhiri dengan huruf kecil atau angka, dan hanya berisi huruf kecil, angka, tanda hubung, atau garis bawah. Misalnya, gunakan nama seperti cymbal-collection-123456789, bukan 123456789-cymbal-collection. |
|
Untuk masalah penelusuran umum yang Anda alami saat mengkueri data Google Drive, lihat Masalah penelusuran umum.
Langkah berikutnya
- Untuk menyediakan antarmuka pengguna untuk mengkueri data Anda, buat aplikasi dan hubungkan ke penyimpanan data Google Drive.
- Untuk menambahkan atau memperbarui filter folder dan drive bersama di penyimpanan data Anda, lihat Menambahkan filter ke penyimpanan data Google Drive.
- Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi Anda disiapkan, lihat Mendapatkan hasil penelusuran.
- Untuk mengaktifkan pemberitahuan bagi penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.
- Jika aplikasi Anda awalnya tidak dikonfigurasi untuk menyertakan dokumen lintas domain, aktifkan fitur Sertakan dokumen lintas domain di setelan Kelola fitur aplikasi web. Untuk mengetahui informasi selengkapnya, lihat Mengelola fitur aplikasi web.