Menyiapkan penyimpanan data Microsoft OneDrive

Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Microsoft OneDrive 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 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 konsol Google Cloud , buka halaman IAM.

      Buka IAM

   2. Temukan akun pengguna, lalu klik ikon 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:

   • ID Klien

   • 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 konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Pilih atau buat project Google Cloud .

   Catatan: Untuk mengakses alur terpadu, project Anda harus berada dalam daftar yang diizinkan.

3. Di menu navigasi, klik Penyimpanan data.

4. Klik Buat penyimpanan data.

5. Di bagian Sumber, telusuri Microsoft OneDrive, lalu klik Pilih.

6. Di bagian Data:

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

   2. Klik Lanjutkan.

   3. Di bagian Setelan autentikasi, 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.
         • 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.

         Untuk mengetahui informasi selengkapnya, lihat Mendapatkan kredensial klien.

      2. Jika Anda memilih Federated Search, klik Login dan selesaikan login Microsoft.

   4. Klik Lanjutkan.

   5. Jika Anda memilih Federated Search, lakukan tindakan berikut:

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

      2. Di bagian Advanced options, masukkan Azure Tenant, ID tenant yang Anda peroleh saat membuat aplikasi Entra.

   6. Jika Anda memilih Penyerapan data, di bagian Opsi lanjutan, lakukan hal berikut:

      1. Opsional: Untuk mengizinkan sekumpulan alamat IP statis di sistem Anda, centang kotak Enable static IP addresses.
      2. Opsional: Di kolom QPS Maks, masukkan kueri maksimum per detik untuk menerapkan batas kecepatan 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 Dekripsi file yang dienkripsi dengan perlindungan informasi Microsoft Purview.

   7. 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.

7. Klik Lanjutkan.

8. Di bagian Tindakan:

   1. Jika Anda memilih Penelusuran gabungan:
      1. Dari Pilih tindakan Microsoft OneDrive 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. Berikan detail autentikasi berikut:

         • 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.

         Untuk mengetahui informasi selengkapnya, lihat Mendapatkan kredensial klien.

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

      3. Klik Lanjutkan.

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

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

      6. Dari Pilih tindakan Microsoft OneDrive yang akan diaktifkan, pilih tindakan dari kategori untuk mengaktifkannya bagi konektor.

9. Klik Lanjutkan.

   Catatan: Jika Anda melewati penambahan tindakan pada langkah ini, Anda harus membuat penyimpanan data baru untuk menambahkan tindakan. Untuk melihat daftar tindakan, lihat Melihat tindakan.

10. 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:
       • 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 mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

11. Klik Lanjutkan.

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

13. 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 OneDrive siap digunakan.

Untuk konektor penyerapan yang dibuat dengan Microsoft OneDrive, 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 OneDrive, dan otorisasi Gemini Enterprise untuk mengakses Microsoft OneDrive sebelum menjalankan kueri apa pun.

Mengaktifkan sinkronisasi real-time untuk penyerapan data

Pratinjau — Real-time sync

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.

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 OneDrive yang sinkronisasi real-time-nya ingin Anda aktifkan.

4. Di halaman Data penyimpanan data, tunggu hingga Status konektor berubah menjadi Aktif.

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 OneDrive. 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 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 diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

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

Langkah berikutnya

• Untuk menyediakan antarmuka pengguna untuk membuat kueri data Microsoft OneDrive Anda, buat aplikasi dan hubungkan ke penyimpanan data Microsoft OneDrive.
• Untuk melihat daftar tindakan, lihat Melihat tindakan.
• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi Anda disiapkan, lihat Mendapatkan hasil penelusuran.
• Untuk mengaktifkan pemberitahuan untuk penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.