Ringkasan

Penyimpanan data Microsoft OneDrive untuk Gemini Enterprise memungkinkan Anda menelusuri dan melakukan tindakan pada file dan folder Anda.

Versi Microsoft OneDrive yang didukung

Penyimpanan data Microsoft OneDrive mendukung semua versi Microsoft OneDrive yang dihosting melalui Microsoft Graph API v1.0.

Tindakan yang didukung

Jika penyimpanan data Microsoft OneDrive diaktifkan, pengguna akhir dapat menggunakan perintah bahasa alami di Gemini Enterprise untuk melakukan tindakan berikut.

Tindakan Deskripsi
Buat folder Membuat folder baru di jalur yang ditentukan di Microsoft OneDrive.
Menyalin file Menyalin file dari sumber ke tujuan di Microsoft OneDrive.
Upload file Mengupload file ke lokasi tertentu di Microsoft OneDrive.
Download file Mendownload file dari Microsoft OneDrive ke lokasi tertentu.

Izin yang diperlukan

Untuk mengizinkan Gemini Enterprise melakukan penelusuran dan penyerapan data menggunakan penyimpanan data Microsoft OneDrive, Anda memerlukan izin berikut:

Izin Microsoft Graph API

Tabel di bawah menguraikan izin yang diperlukan untuk setiap mode koneksi.

Catatan: Tabel berikut menguraikan izin yang diperlukan untuk setiap mode koneksi. Jika Anda mengaktifkan Tindakan untuk mode koneksi Penelusuran gabungan atau Penyerapan data, pilih juga izin yang tercantum di baris Tindakan.

Mode koneksi Cakupan Tujuan
Penelusuran gabungan Files.Read.All (Didelegasikan) Mengizinkan penyimpanan data membaca semua file yang dapat diakses pengguna.
Sites.Read.All (Delegasi) Mengizinkan penyimpanan data membaca dokumen dan item daftar di semua kumpulan situs yang dapat diakses pengguna.
User.Read.All (Delegasi) Mengizinkan penyimpanan data menyelesaikan lokasi drive pengguna untuk penemuan konten.
Penyerapan data GroupMember.Read.All (Kredensial gabungan & token refresh OAuth 2.0) Mengizinkan penyimpanan data membaca keanggotaan dan properti grup dasar untuk semua grup tanpa pengguna yang login.
User.Read (Kredensial gabungan & token refresh OAuth 2.0) Memungkinkan penyimpanan data membaca profil pengguna yang login. Hal ini juga memungkinkan penyimpanan data membaca informasi dasar perusahaan pengguna yang login.
User.Read.All (Khusus token refresh OAuth 2.0) Mengizinkan penyimpanan data membaca profil pengguna.
Sites.FullControl.All (Opsi 1)
Sites.Selected (Opsi 2)		 (Kredensial gabungan & token refresh OAuth 2.0) Opsi 1 memungkinkan penyimpanan data memiliki kontrol penuh atas semua kumpulan situs. Opsi 2 memungkinkan penyimpanan data mengakses subset kumpulan situs. Kumpulan situs tertentu dan izin yang diberikan dapat dikonfigurasi di Microsoft OneDrive.
User.Read.All (Opsi 1)
User.ReadBasic.All (Opsi 2)		 (Hanya kredensial gabungan) Opsi 1 memungkinkan penyimpanan data membaca profil pengguna. Opsi 2 memungkinkan penyimpanan data membaca serangkaian properti profil dasar pengguna lain di organisasi.
Tindakan Files.ReadWrite.AppFolder (Delegasi) Mengizinkan penyimpanan data untuk membaca, membuat, memperbarui, dan menghapus file di folder Microsoft OneDrive.
Files.ReadWrite Didelegasikan: Mengizinkan penyimpanan data untuk membaca, mendownload, membuat, mengupload, memperbarui, dan menghapus file yang dapat diakses pengguna.

Untuk mengetahui informasi tentang cara menambahkan izin untuk Microsoft OneDrive, lihat Mengonfigurasi Microsoft OneDrive dan menetapkan izin yang diperlukan.

Batasan

Bagian ini menguraikan masalah dan batasan umum yang dapat memengaruhi penggunaan penyimpanan data Microsoft OneDrive oleh Anda.

  • Saat membuat aplikasi baru atau menambahkan penyimpanan data ke aplikasi yang sudah ada, sebaiknya hanya kaitkan satu penyimpanan data dengan tindakan yang termasuk dalam satu jenis konektor.
  • Penerapan perimeter Kontrol Layanan VPC pada penyimpanan data Microsoft OneDrive yang ada tidak didukung. Untuk menerapkan Kontrol Layanan VPC, Anda harus menghapus dan membuat ulang penyimpanan data. Untuk mengetahui informasi selengkapnya tentang Kontrol Layanan VPC dan cara menggunakan tindakan setelah mengaktifkan Kontrol Layanan VPC, lihat Mengamankan aplikasi Anda dengan Kontrol Layanan VPC.
  • Penyimpanan data Microsoft OneDrive hanya didukung di lokasi global, us, dan eu.

Berikut adalah batasan untuk penyimpanan data gabungan Microsoft OneDrive:

  • Batasan penelusuran: Hasil penelusuran dapat bervariasi dan tidak selalu komprehensif untuk semua jenis file. Konten dalam folder terenkripsi atau yang diarsipkan mungkin tidak dapat diakses untuk penelusuran. Penelusuran gabungan tidak mendukung penelusuran dalam lampiran.
  • Akses yang didelegasikan: Akses ke file atau folder Microsoft OneDrive bersama mungkin memerlukan izin khusus yang tidak tercakup dalam otorisasi pengguna standar.
  • Pengurai tata letak dalam mode penelusuran gabungan: Meskipun pengurai tata letak bersifat standar, efektivitasnya pada PDF kompleks (dengan tabel, tata letak multi-kolom, atau memerlukan OCR) terbatas dalam mode penelusuran gabungan. Panggilan API real-time mode ini mungkin tidak memberikan data atau waktu lengkap yang diperlukan untuk analisis mendalam yang dilakukan parser tata letak selama penyerapan data.

  • Fitur PDF yang Tidak Didukung: Akibatnya, struktur PDF yang kompleks mungkin tidak sepenuhnya dianalisis atau dapat ditelusuri. Hal ini mencakup:

    • Tata letak teks multi-kolom
    • Data dalam tabel dan diagram tersemat
    • Teks dalam dokumen hasil pindaian yang memerlukan Pengenalan Karakter Optik (OCR)
    • Dokumen dengan urutan baca non-linear atau pemformatan yang rumit.

Berikut adalah batasan untuk penyimpanan data penyerapan Microsoft OneDrive:

  • Sinkronisasi inkremental tidak mendeteksi tindakan tingkat folder seperti Salin, Pindahkan, atau Ganti nama.

Rekomendasi

Untuk data Microsoft OneDrive yang berisi PDF dengan fitur kompleks (seperti tabel, tata letak multi-kolom, atau konten yang bergantung pada OCR), sebaiknya gunakan mode penyerapan data untuk penelusuran yang efektif. Mode ini memungkinkan parser tata letak memproses dan mengindeks seluruh konten dokumen secara mendalam.

Langkah berikutnya