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 Editor Discovery Engine (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. Cari 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. Konfigurasi 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 Sumber, telusuri Microsoft SharePoint, lalu klik Pilih.

  6. Di bagian Data:

    1. Di bagian Mode konektor, pilih Penelusuran gabungan atau Penyerapan data sebagai mode koneksi.

    2. Klik Lanjutkan.

    3. Di bagian Setelan autentikasi, konfigurasi 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.
        • URI Instance: URL dasar untuk instance Microsoft SharePoint Anda (misalnya, https://{your-domain}.sharepoint.com).
        • Jenis Lingkungan Microsoft SharePoint: 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 Pemerintah AS jika Anda terhubung ke cloud kedaulatan 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 akan 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 cocok: GCC, GCC High, atau DoD.
      • Jika tidak, pertahankan default, Global.

    8. Jika Anda memilih Penelusuran gabungan, di bagian Opsi lanjutan, 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 Google Cloud konsol 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 filter Situs:
        • Pilih jenis filter: Sertakan dalam penelusuran atau Kecualikan dari penelusuran.
        • Di kolom Filter URL situs, 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 tertentu ini.

      2. Di bagian Filter jalur:
        • Pilih jenis filter: Sertakan dalam penelusuran atau Kecualikan dari penelusuran.
        • Di kolom Filter jalur, masukkan jalur SharePoint lengkap.

          Catatan: Kolom ini mendukung subjalur, folder, dan pustaka dokumen, dalam format https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/. Semua konten 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: ID klien 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 atau 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 Entitas yang akan ditelusuri (jika Anda memilih Penelusuran gabungan) atau Entitas yang akan disinkronkan (jika Anda memilih Penyerapan data):
      1. Pilih semua entitas yang diperlukan.
      2. Jika Anda memilih Penelusuran gabungan, 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 mengecualikan entity dari indeks, centang kotak Kecualikan dari indeks, atau untuk memastikan entity disertakan dalam indeks, centang kotak Sertakan ke indeks.
          3. Masukkan kunci. Tekan enter setelah setiap tombol.
          4. Klik Simpan.
        2. Untuk mengonfigurasi jadwal sinkronisasi, lakukan hal berikut:
          1. Dalam daftar Frekuensi sinkronisasi, pilih frekuensi sinkronisasi.
            • Untuk menjadwalkan sinkronisasi penuh terpisah dari data entitas dan identitas, 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 Tindakan:

    1. Jika Anda memilih Penelusuran gabungan:
      1. Dari Pilih tindakan Microsoft SharePoint yang akan diaktifkan, pilih tindakan dari kategori untuk mengaktifkannya bagi konektor.

    2. Jika Anda memilih Penyerapan data:

      1. Di bagian Setelan autentikasi, konfigurasi 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.
          • Client Secret: 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.
          • URI Instance: 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 Tujuan, masukkan URL dasar untuk situs.

      4. Klik Lanjutkan.

      5. Dari Pilih tindakan Microsoft SharePoint yang akan diaktifkan, 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 Opsi lanjutan, Anda dapat mencentang kotak Aktifkan Alamat IP Statis 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 keluar 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, konfigurasi Setelan enkripsi:
      • Opsional: Jika Anda belum mengonfigurasi kunci satu wilayah, klik Buka halaman setelan untuk melakukannya. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan kunci satu wilayah untuk konektor pihak ketiga.
      • Pilih Kunci enkripsi yang dikelolaGoogle atau Kunci Cloud KMS.
      • Jika Anda memilih kunci Cloud KMS:
        • Di daftar Key management type, pilih jenis yang sesuai.
        • Di daftar Kunci Cloud KMS, pilih kunci.
      Untuk informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

  13. Klik Lanjutkan.

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

  15. Klik Create. Gemini Enterprise akan 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 Membuat menjadi Aktif, konektor Microsoft SharePoint siap digunakan.

Untuk konektor penyerapan yang dibuat dengan Microsoft SharePoint, status penyimpanan data akan bertransisi dari Membuat menjadi Berjalan setelah inisiasi sinkronisasi. Kemudian, statusnya akan berubah menjadi Aktif setelah penyerapan selesai, yang menandakan bahwa penyimpanan data telah dikonfigurasi sepenuhnya. Bergantung pada volume data, penyerapan dapat memerlukan waktu beberapa jam.

Setelah membuat penyimpanan data, buat aplikasi, hubungkan ke penyimpanan data Microsoft SharePoint, dan otorisasi 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.

Entitas 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 Data Stores.

  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 Sinkronisasi real-time, klik Lihat/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 20 karakter.

  8. Klik Simpan.

    Tunggu hingga kolom Sinkronisasi real-time berubah menjadi Berjalan.

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 SharePoint dan mengirim kueri penelusuran ke Gemini Enterprise:

  • Gemini Enterprise mengirimkan 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 diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

Langkah berikutnya