Ringkasan

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

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.
Salin file Menyalin file dari sumber ke tujuan di Microsoft OneDrive.
Upload file Mengupload file ke lokasi yang ditentukan di Microsoft OneDrive.
Download file Mendownload file dari Microsoft OneDrive ke lokasi yang ditentukan.

Izin yang diperlukan

Untuk mengaktifkan Gemini Enterprise agar dapat 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) Memungkinkan penyimpanan data membaca semua file yang dapat diakses pengguna.
Sites.Read.All (Didelegasikan) Memungkinkan penyimpanan data membaca dokumen dan item daftar di semua koleksi situs yang dapat diakses pengguna.
User.Read.All (Didelegasikan) Memungkinkan penyimpanan data menyelesaikan lokasi drive pengguna untuk penemuan konten.
Penyerapan data GroupMember.Read.All (Kredensial gabungan &token refresh OAuth 2.0) Memungkinkan 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. Penyimpanan data juga dapat membaca informasi perusahaan dasar pengguna yang login.
User.Read.All (Hanya token refresh OAuth 2.0) Memungkinkan 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 koleksi situs. Opsi 2 memungkinkan penyimpanan data mengakses subset koleksi situs. Koleksi 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 kumpulan properti profil dasar pengguna lain di organisasi.
Tindakan Files.ReadWrite.AppFolder (Didelegasikan) Memungkinkan penyimpanan data membaca, membuat, memperbarui, dan menghapus file di folder Microsoft OneDrive.
Files.ReadWrite Didelegasikan: Memungkinkan penyimpanan data 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 umum dan batasan yang dapat memengaruhi penggunaan penyimpanan data Microsoft OneDrive.

  • Saat membuat aplikasi baru atau menambahkan penyimpanan data ke aplikasi yang sudah ada, sebaiknya kaitkan hanya satu penyimpanan data dengan tindakan yang termasuk dalam satu jenis konektor.
  • Penerapan perimeter Kontrol Layanan VPC pada penyimpanan data Microsoft OneDrive yang sudah 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 global, us, dan eu lokasi.

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 yang diarsipkan atau dienkripsi mungkin tidak dapat diakses untuk penelusuran. Penelusuran gabungan tidak mendukung penelusuran dalam lampiran.
  • Akses delegasi: Akses ke file atau folder Microsoft OneDrive yang dibagikan mungkin memerlukan izin tertentu yang tidak tercakup dalam otorisasi pengguna standar.
  • Parser tata letak dalam mode penelusuran gabungan: Meskipun parser 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 format 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 konten dokumen secara mendalam.

Langkah berikutnya