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 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 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 cerdas Google Workspace.

  • Izinkan 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 Source, telusuri Google Drive, lalu klik Select.

  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 drive 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 Nama konektor data, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai 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.
      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 Sensitive Data Protection, Anda dapat melewati langkah ini.

  12. Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkannya di halaman Data Stores.

Untuk memverifikasi status penyimpanan data, lakukan tindakan berikut:

  1. Buka konektor di daftar penyimpanan data dan pantau statusnya hingga berubah menjadi Active.
  2. 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:

  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 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 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 Permission Denied 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 mengkueri data Google Drive, lihat Masalah penelusuran umum.

Langkah berikutnya