Menyiapkan penyimpanan data Microsoft SharePoint

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

Sebelum memulai

Pastikan hal berikut sebelum Anda menyiapkan koneksi gabungan Microsoft SharePoint:

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

    1. Di konsol Google Cloud , 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

    • URI Instance

  3. Konfigurasikan izin Microsoft API dengan izin admin Microsoft SharePoint.

Membuat penyimpanan data Microsoft SharePoint

Untuk membuat penyimpanan data Microsoft SharePoint, lakukan hal berikut:

  1. Di konsol 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 Microsoft SharePoint, lalu klik Select.

  6. Di bagian Data:

    1. Di bagian Connector mode, pilih Federated search atau Penyerapan data sebagai mode koneksi.

    2. Klik Lanjutkan.

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

      1. Berikan detail autentikasi berikut sesuai kebutuhan:
        • Client ID: ID unik aplikasi yang terdaftar di Microsoft Entra ID organisasi Anda.
        • Rahasia klien: Kunci rahasia yang dibuat selama proses pendaftaran aplikasi OAuth 2.0 di Microsoft Entra ID.
        • ID Tenant: ID unik untuk organisasi Anda di pusat admin Microsoft Entra.
        • Instance URI: URL dasar untuk instance Microsoft SharePoint Anda (misalnya, https://{your-domain}.sharepoint.com).
        • Microsoft SharePoint 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 sovereign cloud Microsoft 365 US Government (GCC High atau DoD).

        Untuk mengetahui informasi selengkapnya, lihat Mendapatkan kredensial klien.

      • Jika Anda memilih Penyerapan data dengan metode autentikasi Kredensial gabungan, salin ID subjek dan gunakan untuk menambahkan kredensial gabungan untuk penyerapan data.

        • ID subjek: ID unik akun layanan yang ingin Anda gunakan.

      • Jika Anda memilih Penelusuran gabungan, klik Login dan selesaikan login pihak ketiga.

    4. Klik Lanjutkan.

    5. Jika Anda memilih Federated search, bagian Destinations akan muncul. Masukkan URL dasar untuk situs.

    6. Klik Lanjutkan.

    7. Di bagian Advanced options, pilih Microsoft 365 Cloud Environment Anda:

      • Jika Anda terhubung ke instance Microsoft 365 US Government, pilih opsi yang sesuai: GCC, GCC High, atau DoD.
      • Jika tidak, pertahankan nilai default, Global.

    8. Jika Anda memilih Federated search, di bagian Advanced options, Anda dapat mempersempit cakupan penelusuran dan tindakan dengan menentukan situs Microsoft SharePoint atau jalur tertentu 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 atau API Google Cloud :

      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 Site filter:
        • Pilih jenis filter: Sertakan dalam penelusuran atau Kecualikan dari penelusuran.
        • Di kolom Site URL filter, masukkan URL situs Microsoft SharePoint yang tepat untuk difilter, dalam format https://{your-tenant}.sharepoint.com/sites/{your-site-name}.

          Catatan: Masukkan URL situs yang tepat. Subjalur, folder, atau pustaka dokumen tidak didukung di kolom khusus ini.

      2. Di bagian Filter jalur:
        • Pilih jenis filter: Sertakan dalam penelusuran atau Kecualikan dari penelusuran.
        • Di kolom Path filter, masukkan jalur SharePoint 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 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, us, atau eu
      • COLLECTION_ID: ID unik penyimpanan data.
      • COLLECTION_DISPLAY_NAME: nama tampilan penyimpanan data.
      • CLIENT_ID: client ID untuk autentikasi SharePoint.
      • CLIENT_SECRET: rahasia klien untuk autentikasi SharePoint.
      • INSTANCE_URI: URI instance untuk SharePoint.
      • TENANT_ID: ID tenant untuk SharePoint.
      • FILTER_TYPE: jenis filter yang ditambahkan ke penyimpanan data Microsoft SharePoint 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 yang akan difilter untuk FILTER_KEY yang ditentukan.

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

  7. Klik Lanjutkan.

    1. 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 enter setelah setiap kunci.
          4. Klik Simpan.
        2. Untuk mengonfigurasi jadwal sinkronisasi, lakukan hal berikut:
          1. Dalam daftar Frekuensi sinkronisasi, pilih frekuensi sinkronisasi.
            • Untuk menjadwalkan sinkronisasi penuh data entitas dan identitas secara terpisah, luaskan menu di bagian Sinkronisasi penuh, lalu pilih Opsi kustom.
          2. Dalam daftar Frekuensi sinkronisasi inkremental, pilih frekuensi sinkronisasi inkremental. Untuk mengetahui informasi selengkapnya, lihat Jadwal sinkronisasi.

  8. Klik Lanjutkan.

  9. Di bagian Actions:

    1. Jika Anda memilih Penelusuran gabungan:
      1. Dari Select Microsoft SharePoint actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi konektor.

    2. Jika Anda memilih Penyerapan data:

      1. Di bagian Authentication settings, konfigurasikan autentikasi berdasarkan mode koneksi yang Anda pilih.

        1. Berikan detail autentikasi berikut sesuai kebutuhan:

          • Client ID: ID unik aplikasi yang terdaftar di Microsoft Entra ID organisasi Anda.
          • Rahasia Klien: Kunci rahasia yang dibuat selama proses pendaftaran aplikasi OAuth 2.0 di Microsoft Entra ID.
          • ID Tenant: ID unik untuk organisasi Anda di pusat admin Microsoft Entra.
          • Instance URI: URL dasar untuk instance Microsoft SharePoint Anda (misalnya, https://{your-domain}.sharepoint.com).

          Untuk mengetahui informasi selengkapnya, lihat Mendapatkan kredensial klien.

      2. Klik Lanjutkan.

      3. Di bagian Destinations, masukkan URL dasar untuk situs.

      4. Klik Lanjutkan.

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

  10. Klik Lanjutkan.

    Untuk mengelola daftar tindakan, lihat Mengelola tindakan.

  11. Jika alur pembuatan penyimpanan data menampilkan bagian Advanced options, Anda dapat mencentang kotak Enable Static IP Addresses di dalamnya. Hal ini memastikan penyimpanan data menggunakan kumpulan alamat IP tetap untuk traffic keluar, yang cocok untuk dimasukkan ke daftar yang diizinkan di sistem sumber. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi egress IP statis.

  12. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Nama konektor data Anda, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasikan Setelan enkripsi:
      • Opsional: Jika Anda belum mengonfigurasi kunci satu region, klik Buka halaman setelan 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:
        • 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.

  13. Klik Lanjutkan.

  14. Di bagian Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

  15. Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkannya 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 SharePoint siap digunakan.

Untuk konektor penyerapan yang dibuat dengan Microsoft SharePoint, status penyimpanan data bertransisi dari Creating ke Running setelah sinkronisasi dimulai. Statusnya kemudian berubah menjadi Active setelah penyerapan selesai, yang menandakan bahwa penyimpanan data telah dikonfigurasi sepenuhnya. Bergantung pada volume data, penyerapan mungkin memerlukan waktu beberapa jam.

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

Mengaktifkan sinkronisasi real-time untuk penyerapan data

Sinkronisasi real-time hanya menyinkronkan entitas dokumen dan tidak menyinkronkan data yang terkait dengan entitas identitas. Tabel berikut menunjukkan peristiwa dokumen yang didukung dengan sinkronisasi real-time.

Entity Microsoft SharePoint Buat Perbarui Hapus Perubahan izin
Lampiran
Komentar
Acara
File
Halaman

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

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

    Gemini Enterprise

  2. Di menu navigasi, klik Penyimpanan Data.

  3. Klik nama penyimpanan data Microsoft SharePoint yang ingin Anda aktifkan sinkronisasi real-time-nya.

  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 Aktifkan sinkronisasi real-time.

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

  8. Klik Simpan.

    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 dari penggunaan penyimpanan data gabungan.

Eksekusi kueri

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

  • Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke Microsoft API.
  • Gemini Enterprise menggabungkan hasil tersebut dengan hasil dari sumber data lain yang terhubung 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 akan 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