Menyiapkan penyimpanan data Google Drive

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

  • 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 berakhiran @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 Anda.

  • Pastikan semua dokumen dapat diakses, baik dengan menempatkannya di drive bersama yang dimiliki oleh domain atau dengan menetapkan kepemilikan kepada pengguna di domain.

  • 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 smart Google Workspace.

  • Mengizinkan aplikasi OAuth (Khusus Administrator): 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.

Membuat penyimpanan data Google Drive

Untuk membuat penyimpanan data Google Drive, lakukan langkah-langkah berikut:

  1. Di konsol Google Google Cloud , buka halaman Gemini Enterprise.

    Gemini Enterprise

  2. Pilih atau buat project Google Cloud .

  3. Di menu navigasi, klik Penyimpanan data.

  4. Klik Buat penyimpanan data.

  5. Di bagian Sumber, telusuri Google Drive, lalu klik Pilih.

  6. 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

    1. Di kolom ID Drive Bersama, kolom ID Folder, atau keduanya, masukkan ID yang ingin Anda filter.
    2. Untuk setiap kolom, pilih Sertakan untuk menelusuri hanya ID yang ditentukan, atau Kecualikan untuk menghilangkannya dari penelusuran. Konfigurasikan mode Sertakan atau mode Kecualikan untuk setiap kolom, tetapi tidak keduanya.
    3. 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_filter dan daftar pengecualian ditetapkan di bagian admin_exclusion_filter. Untuk setiap jenis filter, isi daftar di bagian admin_filter atau di bagian admin_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:
      • us untuk multi-region AS
      • eu untuk multi-region Uni Eropa
      • global untuk lokasi Global
      Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
    • LOCATION: multi-region penyimpanan data Anda: global atau us.
    • COLLECTION_ID: ID unik penyimpanan data.
    • COLLECTION_DISPLAY_NAME: nama tampilan penyimpanan data.
    • FILTER_TYPE: jenis filter, baik admin_filter untuk penyertaan atau admin_exclusion_filter untuk pengecualian. Isi daftar di bagian admin_filter atau di bagian admin_exclusion_filter, tetapi tidak keduanya.
    • FILTER_KEY: entitas Drive yang akan difilter, baik SharedDriveIds maupun FolderIds.
    • FILTER_VALUE_1, FILTER_VALUE_2: ID folder bersama atau ID folder yang akan difilter.

  7. Di bagian Tindakan, pilih tindakan dari daftar untuk mengaktifkannya bagi konektor Google Drive.

    Untuk mengelola daftar tindakan, lihat Mengelola tindakan.

  8. Klik Lanjutkan.

  9. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Data connector name, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasi Setelan enkripsi:
      • Pilih Kunci enkripsi yang dikelolaGoogle atau Kunci Cloud KMS.
      • Jika Anda memilih Cloud KMS key:
        • Dalam daftar Key management type, pilih jenis yang sesuai.
        • Di daftar Cloud KMS key, pilih kunci.
      Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

  10. 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.

  11. Opsional: Di bagian Sensitive Data Protection policy, lampirkan kebijakan Sensitive Data Protection yang ada untuk memeriksa dan melakukan de-identifikasi data yang diambil Gemini Enterprise melalui penyimpanan data ini. Jika organisasi Anda tidak memerlukan kebijakan Perlindungan Data Sensitif, Anda dapat melewati langkah ini.

  12. 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:

  1. Buka konektor dalam daftar penyimpanan data dan pantau statusnya hingga berubah menjadi Aktif.
  2. Saat status penyimpanan data berubah dari Membuat menjadi Aktif, 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:

  1. Gemini Enterprise mengirimkan kueri penelusuran Anda ke Google Drive API.

  2. 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 temukan saat bekerja dengan 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 Izin Ditolak 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 tergabung dalam organisasi yang sama dengan penyimpanan data Google Workspace. Hapus penyimpanan data Google Workspace dari mesin atau hubungi dukungan jika penyimpanan data pengguna dan Google Workspace dimaksudkan untuk berada di organisasi yang berbeda.
403 Izin Ditolak Akses Workspace untuk Agentspace dinonaktifkan oleh administrator organisasi. Administrator Google Workspace telah menonaktifkan akses ke data Google Workspace untuk Gemini Enterprise. Hubungi administrator Google Workspace Anda untuk mengaktifkan akses.
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 membuat kueri data Google Drive, lihat Masalah penelusuran umum.

Langkah berikutnya