Menyiapkan penyimpanan data Microsoft OneDrive

Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Microsoft OneDrive ke Gemini Enterprise.

Sebelum memulai

Pastikan hal berikut sebelum Anda menyiapkan koneksi Microsoft OneDrive.

  1. Berikan peran Editor Discovery Engine (roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:

    1. Di Google Cloud konsol, buka halaman IAM.

      Buka IAM

    2. Temukan akun pengguna, lalu klik edit Edit.
    3. Berikan peran Discovery Engine Editor kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

  2. Daftarkan Gemini Enterprise sebagai aplikasi OAuth 2.0 di Microsoft Entra ID dan dapatkan kredensial berikut:

    • Client ID

    • Rahasia klien

    • ID Tenant

  3. Konfigurasi izin aplikasi Microsoft API dengan izin administrator Microsoft OneDrive.

Membuat penyimpanan data Microsoft OneDrive

Untuk membuat penyimpanan data Microsoft OneDrive, lakukan langkah-langkah berikut:

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

    Gemini Enterprise

  2. Pilih atau buat a Google Cloud project.

  3. Di menu navigasi, klik Data stores.

  4. Klik Buat penyimpanan data.

  5. Di bagian Source, telusuri Microsoft OneDrive, lalu klik Select.

  6. Di bagian Data:

    1. Di bagian Connector mode, pilih Data ingestion atau Federated search sebagai mode koneksi.

    2. Klik Continue.

    3. Di bagian Authentication settings, konfigurasi autentikasi berdasarkan mode koneksi yang Anda pilih.

      1. Berikan detail autentikasi berikut:
        • Client ID: ID unik aplikasi yang terdaftar di Microsoft Entra ID organisasi Anda.
        • Client secret: Kunci rahasia yang dibuat selama proses pendaftaran aplikasi OAuth 2.0 di Microsoft Entra ID.

        • Tenant ID: ID unik untuk organisasi Anda di pusat admin Microsoft Entra. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan kredensial klien.

        • Microsoft OneDrive Environment Type: Pilih lingkungan yang menghosting tenant Microsoft 365 Anda:

          • Pilih Standard (default) jika Anda terhubung ke Microsoft 365 komersial standar atau Government Community Cloud (GCC).
          • Pilih US Government jika Anda terhubung ke Microsoft 365 US Government sovereign cloud (GCC High atau DoD).

      • Jika Anda memilih Data ingestion dengan metode autentikasi Federated credentials, salin Subject identifier dan gunakan untuk menambahkan kredensial gabungan untuk penyerapan data.

        • Subject identifier: ID unik akun layanan yang akan Anda gunakan.

      • Jika Anda memilih Federated search, klik Login dan selesaikan proses login Microsoft.

    4. Klik Continue.

    5. Jika Anda memilih Federated search, lakukan hal berikut:

      1. Di bagian Destinations, masukkan URL dasar untuk situs Microsoft OneDrive Anda.

      2. Di bagian Advanced options,

        1. Pilih Microsoft 365 Cloud Environment Anda:
          • Jika Anda terhubung ke instance Microsoft 365 US Government, pilih opsi yang cocok: GCC, GCC High, atau DoD.
          • Jika tidak, pertahankan nilai default, Global.
        2. Masukkan Azure Tenant, ID tenant yang Anda dapatkan saat membuat aplikasi Entra.

        3. Anda dapat menyempurnakan cakupan penelusuran dan tindakan dengan menentukan jalur Microsoft OneDrive yang akan disertakan atau dikecualikan. Anda hanya dapat mengubah atau mengambil data dalam jalur yang disertakan. Permintaan data di luar cakupan akan gagal atau tidak menampilkan hasil.

          Anda dapat menambahkan filter ke penyimpanan data menggunakan konsol Google Cloud atau API:

          Konsol

          Catatan: Saat memasukkan beberapa situs, pisahkan setiap URL dengan koma. Anda juga dapat menyalin dan menempelkan daftar URL langsung dari file CSV.

          1. Di bagian Path filter:
            • Pilih jenis filter: Include in search atau Exclude from search.
            • Di kolom Path filter, masukkan jalur OneDrive lengkap.

              Catatan: Kolom ini mendukung subjalur, folder, dan library dokumen, dalam format https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/. Konten apa pun di jalur yang ditentukan akan difilter.

          REST

          Untuk menambahkan filter saat membuat penyimpanan data, panggil metode setUpDataConnector.

          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": "sharepoint_federated_search",
            "params": {
            "client_id": "CLIENT_ID",
            "client_secret": "CLIENT_SECRET",
            "instance_uri": "INSTANCE_URI",
            "tenant_id": "TENANT_ID",
            "FILTER_TYPE": {
                "FILTER_KEY": [
                "FILTER_VALUE1",
                "FILTER_VALUE2"
                ]
            }
            },
            "entities": [
            {
                "entityName": "file"
            }
            ],
            "refreshInterval": "7200s",
            "connectorType": "THIRD_PARTY_FEDERATED",
            "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 Amerika Serikat
            • 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, us, atau eu
          • COLLECTION_ID: ID unik penyimpanan data.
          • COLLECTION_DISPLAY_NAME: nama tampilan penyimpanan data.
          • CLIENT_ID: ID klien untuk autentikasi Microsoft OneDrive.
          • CLIENT_SECRET: rahasia klien untuk autentikasi Microsoft OneDrive.
          • INSTANCE_URI: URI instance untuk Microsoft OneDrive.
          • TENANT_ID: ID tenant untuk Microsoft OneDrive.
          • FILTER_TYPE: jenis filter yang ditambahkan ke penyimpanan data Microsoft OneDrive Anda. Untuk mengetahui informasi selengkapnya, lihat Jenis filter.
          • FILTER_KEY: kunci untuk filter, yang sesuai dengan kolom dalam data Anda. Untuk mengetahui informasi selengkapnya, lihat Kunci filter.
          • FILTER_VALUES: nilai atau nilai yang akan difilter untuk FILTER_KEY yang ditentukan.

        Untuk mengetahui detail selengkapnya tentang jenis filter dan menambahkan filter, lihat Menambahkan filter ke penyimpanan data Microsoft OneDrive.

    6. Jika Anda memilih Penyerapan data, di bagian Advanced options, lakukan hal berikut:

      1. Opsional: Untuk mengizinkan sekumpulan alamat IP statis di sistem Anda, centang kotak Enable Static IP Addresses. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi egress IP statis.
      2. Opsional: Di kolom Max QPS, masukkan kueri maksimum per detik untuk menerapkan batas frekuensi pada kueri yang dikirim konektor ke instance Microsoft OneDrive.
      3. Opsional: Untuk mencoba mendekripsi semua file yang dienkripsi dengan perlindungan informasi Microsoft Purview, centang kotak Decrypt files encrypted with Microsoft Purview information protection.

    7. Klik Continue.

    8. Di bagian Entities to search (jika Anda memilih Federated search) atau Entities to sync (jika Anda memilih penyerapan data):

      1. Pilih semua entity yang diperlukan.
      2. Jika Anda memilih Federated search, lanjutkan ke langkah berikutnya.
      3. Jika Anda memilih Penyerapan data, lanjutkan dengan langkah-langkah berikut:
        1. Opsional: Untuk menyinkronkan project tertentu, lakukan hal berikut:
          1. Klik Filter.
          2. Untuk memfilter entity dari indeks, centang kotak Exclude from the index, atau untuk memastikan entity disertakan dalam indeks, centang kotak Include to the index.
          3. Masukkan kunci. Tekan tombol Enter setelah setiap kunci.
          4. Klik Save.
        2. Untuk mengonfigurasi jadwal sinkronisasi, lakukan hal berikut:
          1. Di daftar Sync frequency, pilih frekuensi sinkronisasi.
            • Untuk menjadwalkan sinkronisasi penuh data entity dan identitas secara terpisah, luaskan menu di bagian Full sync , lalu pilih Custom options.
          2. Di daftar Incremental sync frequency, pilih frekuensi sinkronisasi inkremental. Untuk mengetahui informasi selengkapnya, lihat Jadwal sinkronisasi.

  7. Klik Continue.

  8. Di bagian Actions:

    1. Jika Anda memilih Federated search:
      1. Dari Select Microsoft OneDrive actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi konektor.

    2. Jika Anda memilih Penyerapan data:

      1. Di bagian Authentication settings, konfigurasi autentikasi berdasarkan mode koneksi yang Anda pilih. Berikan detail autentikasi berikut:

        • Client ID: ID unik aplikasi yang terdaftar di Microsoft Entra ID organisasi Anda.
        • Client Secret: Kunci rahasia yang dibuat selama proses pendaftaran aplikasi OAuth 2.0 di Microsoft Entra ID.
        • Tenant ID: ID unik untuk organisasi Anda di pusat admin Microsoft Entra.

        Untuk mengetahui informasi selengkapnya, lihat Mendapatkan kredensial klien.

      2. Klik Login dan login ke Microsoft OneDrive untuk memverifikasi akun Anda.

      3. Klik Continue.

      4. Di bagian Advanced settings, masukkan Azure Tenant, ID tenant yang Anda dapatkan saat membuat aplikasi Entra.

      5. Di bagian Destinations, masukkan URL dasar untuk situs Microsoft OneDrive Anda.

      6. Dari Select Microsoft OneDrive actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi konektor.

  9. Klik Continue.

    Untuk melihat dan mengelola daftar tindakan, lihat Melihat dan mengelola tindakan.

  10. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Your data connector name, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasi Encryption settings:
      • Opsional: Jika Anda belum mengonfigurasi kunci satu region, klik Go to settings page untuk melakukannya. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan kunci satu region untuk konektor pihak ketiga.
      • Pilih Google-managed encryption key atau Cloud KMS key.
      • Jika Anda memilih Cloud KMS key:
        • Di 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.

  11. Klik Continue.

  12. Di bagian Billing, pilih General pricing atau Configurable pricing. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

  13. Klik Create. Gemini Enterprise membuat penyimpanan data Anda dan menampilkan penyimpanan data Anda di halaman Data Stores.

Di halaman Data Stores, klik nama penyimpanan data Anda untuk melihat statusnya. Setelah status penyimpanan data berubah dari Creating menjadi Active, konektor Microsoft OneDrive siap digunakan.

Untuk konektor penyerapan yang dibuat dengan Microsoft OneDrive, status penyimpanan data akan bertransisi dari Creating menjadi Running setelah inisiasi sinkronisasi. Kemudian, status akan berubah menjadi Active setelah penyerapan selesai, yang menandakan bahwa penyimpanan data telah sepenuhnya dikonfigurasi. Bergantung pada volume data, penyerapan mungkin memerlukan waktu beberapa jam.

Setelah membuat penyimpanan data, buat aplikasi, hubungkan ke penyimpanan data Microsoft OneDrive, dan izinkan Gemini Enterprise untuk mengakses Microsoft OneDrive sebelum menjalankan kueri apa pun.

Mengaktifkan sinkronisasi real-time untuk penyerapan data

Untuk mengaktifkan sinkronisasi real-time untuk penyimpanan data Anda, ikuti langkah-langkah berikut.

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

    Gemini Enterprise

  2. Di menu navigasi, klik Data Stores.

  3. Klik nama penyimpanan data Microsoft OneDrive yang sinkronisasi real-timenya ingin Anda aktifkan.

  4. Di halaman Data penyimpanan data, tunggu hingga Connector state berubah menjadi Active.

  5. Di kolom Real-time sync, klik View/edit.

  6. Untuk mengaktifkan sinkronisasi real-time, klik tombol Enable real-time sync.

  7. Di kolom Client secret, masukkan nilai. Nilai ini digunakan untuk memverifikasi peristiwa webhook Microsoft OneDrive. Sebaiknya gunakan string yang terdiri dari 20 karakter.

  8. Klik Save.

    Tunggu hingga kolom Real-time sync berubah menjadi Running.

Penanganan data dan eksekusi kueri

Bagian ini menjelaskan cara Gemini Enterprise mengelola kueri Anda dan implikasi privasi penggunaan penyimpanan data gabungan.

Eksekusi kueri

Setelah Anda mengizinkan Microsoft OneDrive dan mengirim kueri penelusuran ke Gemini Enterprise:

  • Gemini Enterprise mengirim kueri penelusuran Anda langsung ke Microsoft API.
  • Gemini Enterprise menggabungkan hasil dengan hasil dari sumber data terhubung lainnya dan menampilkan hasil penelusuran yang komprehensif.

Penanganan data

Saat menggunakan penelusuran gabungan pihak ketiga, aturan penanganan data berikut berlaku:

  • String kueri Anda dikirim ke backend penelusuran pihak ketiga (Microsoft API).
  • Pihak ketiga ini dapat mengaitkan kueri dengan identitas Anda.
  • Jika beberapa sumber data penelusuran gabungan diaktifkan, kueri mungkin dikirim ke semua sumber data tersebut.
  • Setelah data mencapai sistem pihak ketiga, data tersebut akan diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

Langkah berikutnya