Menyiapkan penyimpanan data Microsoft SharePoint

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

Sebelum memulai

Catatan: Untuk menerapkan kontrol akses sumber data dan mengamankan data di Gemini Enterprise, pastikan Anda telah mengonfigurasi penyedia identitas Anda.

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. 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 Connector mode, pilih Federated search 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.
         • 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).
         • 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.

         Catatan: Setelan ini hanya berlaku untuk pelanggan Microsoft 365 US Government (cloud berdaulat). Jika Anda terhubung ke cloud Pemerintah AS, gunakan kombinasi yang cocok; jika tidak, pertahankan default (Standard dan Global):

         • GCC: Jenis Lingkungan Standard, Lingkungan Cloud GCC.
         • GCC High: Jenis Lingkungan US Government, Lingkungan Cloud GCC High.
         • DoD: Jenis Lingkungan US Government, Lingkungan Cloud DoD.

      • 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 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 untuk 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 Filter situs:
         • 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 subpath, folder, dan pustaka dokumen, dalam format https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/. Setiap 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 entity 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 langkah-langkah 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 data entitas dan identitas secara terpisah, luaskan menu di bagian Sinkronisasi penuh, lalu pilih Opsi kustom.
            2. Di 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 Federated search:
      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 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.
            • 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.

    Catatan: Jika Anda melewati penambahan tindakan pada langkah ini, Anda dapat menambahkannya nanti. Untuk mengetahui informasi selengkapnya, lihat Menambahkan tindakan.

    Untuk mengelola daftar tindakan, lihat Mengelola tindakan.

    Peringatan:

    • Tindakan tulis default: Saat membuat dan mengonfigurasi penyimpanan data, pastikan semua tindakan tulis default dinonaktifkan secara eksplisit jika Anda hanya ingin memberikan akses baca. Jika tindakan tulis tetap diaktifkan tanpa cakupan tulis yang sesuai di Microsoft Entra ID, akan terjadi error autentikasi dan sinkronisasi.

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, konfigurasi 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 Kunci enkripsi yang dikelolaGoogle atau Kunci Cloud KMS.
       • 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.

13. Klik Lanjutkan.

14. Di bagian Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi status penagihan project Anda 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 Creating menjadi Active, konektor Microsoft SharePoint siap digunakan.

Untuk konektor penyerapan yang dibuat dengan Microsoft SharePoint, status penyimpanan data akan bertransisi dari Creating ke Running 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 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

Pratinjau — Sinkronisasi real-time

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Catatan: Sinkronisasi real-time hanya tersedia untuk mode koneksi 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 Real-time sync, klik View/edit.

6. Untuk mengaktifkan sinkronisasi real-time, klik tombol Aktifkan sinkronisasi real-time.

7. Di kolom Rahasia klien, masukkan nilai. Nilai ini digunakan untuk memverifikasi peristiwa webhook Microsoft SharePoint. Sebaiknya gunakan string yang berisi 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 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.

Catatan: Untuk meningkatkan akurasi, LLM dapat menulis ulang kueri Anda sebelum dikirim ke Microsoft SharePoint. Kueri yang ditulis ulang ini dapat menggabungkan informasi dari histori kueri sesi Anda. Akibatnya, bagian dari histori kueri Anda mungkin juga disertakan dalam kueri yang dikirim ke Microsoft API.

Langkah berikutnya

• Untuk menyediakan antarmuka pengguna guna mengkueri data Microsoft SharePoint Anda, buat aplikasi dan hubungkan ke penyimpanan data Microsoft SharePoint.
• Untuk mengelola daftar tindakan, lihat Mengelola tindakan.
• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi Anda disiapkan, lihat Mendapatkan hasil penelusuran.
• Untuk mengaktifkan pemberitahuan bagi penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.
• Untuk menambahkan filter ke penyimpanan data, lihat Menambahkan filter ke penyimpanan data Microsoft SharePoint.