Menghubungkan Microsoft OneDrive dengan federasi data

Halaman ini menjelaskan cara menghubungkan Microsoft OneDrive ke Gemini Enterprise menggunakan federasi data.

Catatan: Jika Anda ingin menghubungkan sumber data Microsoft OneDrive menggunakan penyerapan data, lihat Menghubungkan ke Microsoft OneDrive menggunakan penyerapan.

Gunakan prosedur berikut untuk menelusuri akun Microsoft OneDrive Anda menggunakan penelusuran gabungan.

Tentang gabungan data

Dengan federasi data, Gemini Enterprise langsung mengambil informasi dari sumber data pihak ketiga menggunakan API, bukan menyalin data ke Gemini Enterprise. Dengan menggunakan pendekatan ini, Anda dapat langsung mengakses sumber data eksternal, tanpa menunggu penyerapan.

Sebelum Anda memulai penyiapan gabungan Microsoft OneDrive

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

Lakukan langkah-langkah berikut sebelum terhubung ke penyimpanan data Microsoft OneDrive menggunakan penelusuran gabungan.

1. Daftarkan Gemini Enterprise sebagai aplikasi OAuth 2.0 di Microsoft Entra ID dan kumpulkan informasi berikut:

   • ID Klien
   • Rahasia klien
   • URL Instance: URL OneDrive organisasi Anda. Misalnya, https://example-my.sharepoint.com.
   • ID Tenant

2. Konfigurasi izin aplikasi Microsoft Graph berikut dengan izin administrator Microsoft OneDrive:

   Izin	Jenis	Deskripsi
   Files.Read.All	Didelegasikan	Membaca semua file yang dapat diakses pengguna
   Sites.Read.All	Didelegasikan	Membaca item di semua kumpulan situs

3. Tambahkan URL berikut sebagai URL callback web:

   • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html
   • https://vertexaisearch.cloud.google.com/oauth-redirect

Membuat konektor penelusuran gabungan dengan OneDrive

Gunakan langkah-langkah berikut untuk Google Cloud konsol guna melakukan penelusuran gabungan melalui Microsoft OneDrive dari Gemini Enterprise.

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

   Gemini Enterprise

2. Di menu navigasi, klik Data Stores.

3. Klik Create Data Store.

4. Di halaman Pilih sumber data, pilih Penelusuran Gabungan OneDrive untuk menghubungkan sumber data pihak ketiga Anda.

5. Di bagian Setelan autentikasi, pilih metode autentikasi yang akan digunakan.

   1. Masukkan Client ID, Client secret, Instance URL, dan Tenant ID.

   2. Klik Autentikasi.

   3. Klik Lanjutkan.

   Catatan: Langkah berikutnya (memilih entitas yang akan disinkronkan) akan dilewati secara otomatis, karena sumber data ini hanya mendukung satu jenis entitas.

6. Pilih region untuk sumber data Anda.

7. Masukkan nama untuk sumber data Anda.

8. Klik Buat. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkannya di halaman Data Stores.

Setelah penyimpanan data dibuat, buka halaman Data Stores dan klik nama penyimpanan data Anda untuk melihat statusnya. Saat Status konektor berubah dari Membuat menjadi Aktif, konektor penelusuran federasi siap digunakan.

Otorisasi pengguna

Setelah membuat penyimpanan data penelusuran gabungan, Anda akan melihatnya tercantum sebagai salah satu sumber data di panel pengelolaan sumber. Jika Anda belum pernah mengizinkan Gemini Enterprise, Anda tidak dapat memilih sumber data. Sebagai gantinya, tombol Authorize akan muncul.

Untuk memulai alur otorisasi:

1. Klik Otorisasi. Anda akan dialihkan ke server otorisasi OneDrive.

2. Login ke akun Anda.

3. Klik Grant access. Setelah memberikan akses, Anda akan dialihkan kembali ke Gemini Enterprise untuk menyelesaikan alur otorisasi. Gemini Enterprise mendapatkan token akses dan menggunakannya untuk mengakses penelusuran Microsoft OneDrive.

Eksekusi kueri

Setelah Anda mengizinkan Microsoft OneDrive, saat Anda memasukkan kueri penelusuran:

1. Gemini Enterprise mengirimkan kueri penelusuran Anda ke Microsoft Graph API.

2. Gemini Enterprise menggabungkan hasil dengan hasil dari sumber lain dan menampilkannya.

Penanganan data

Saat menggunakan penelusuran gabungan pihak ketiga, string kueri Anda akan dikirim ke backend penelusuran pihak ketiga. 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: LLM dapat menulis ulang kueri Anda sebelum dikirim. Kueri yang ditulis ulang ini dapat menggabungkan informasi dari histori kueri berbasis sesi Anda. Akibatnya, bagian dari histori kueri tersebut juga dapat disertakan dalam kueri yang dikirim ke backend penelusuran pihak ketiga.

Kode error

Tabel berikut mencantumkan kode dan deskripsi error OneDrive.

Kode error	Deskripsi
ONEDRIVE_MISSING_PERMISSION_1	Aplikasi tidak memiliki peran Files.Read.All yang diperlukan untuk Graph API.
ONEDRIVE_MISSING_PERMISSION_2	Aplikasi tidak memiliki peran Group.Read.All yang diperlukan untuk Graph API.
ONEDRIVE_MISSING_PERMISSION_3	Aplikasi tidak memiliki peran User.Read.All atau User.ReadBasic.All yang diperlukan untuk Graph API.
ONEDRIVE_INVALID_SITE_URI	URL instance tidak valid.
ONEDRIVE_INVALID_AUTH	Terjadi error saat mengambil token akses Graph API. Hal ini mungkin disebabkan oleh ID klien yang tidak valid, nilai rahasia yang tidak valid, atau kredensial gabungan yang tidak ada.
ONEDRIVE_UNCATEGORIZED_ERROR	ACL tidak valid atau tidak ada dalam file.
ONEDRIVE_TOO_MANY_REQUESTS	OneDrive telah menerima terlalu banyak permintaan HTTP dan telah menampilkan respons HTTP 429.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda, dengan mengikuti langkah-langkah di Membuat aplikasi.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi dan penyimpanan data Anda disiapkan, lihat Melihat pratinjau hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.