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.
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.
Salin folder Menyalin folder dari sumber ke tujuan di Microsoft OneDrive.
Pindahkan file Memindahkan file dari sumber ke tujuan di Microsoft OneDrive.
Memindahkan folder Memindahkan folder dari sumber ke tujuan di Microsoft OneDrive.
Ganti nama file Mengganti nama file di Microsoft OneDrive.
Ganti nama folder Mengganti nama folder di Microsoft OneDrive.
Membagikan file atau folder Membagikan file atau folder kepada penerima yang ditentukan atau membuat link berbagi.
Memperbarui properti file Memperbarui properti metadata file di Microsoft OneDrive.

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 Actions untuk mode koneksi Federated search atau penyerapan data, pilih juga izin yang tercantum di baris Actions.

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 mencantumkan item di semua kumpulan situs yang dapat diakses pengguna.
User.Read.All (Didelegasikan) Memungkinkan penyimpanan data me-resolve 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. Hal ini juga memungkinkan penyimpanan data membaca informasi dasar perusahaan dari pengguna yang login.
User.Read.All (Khusus 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 kumpulan situs. Opsi 2 memungkinkan penyimpanan data mengakses sebagian koleksi situs. Kumpulan situs tertentu dan izin yang diberikan dapat dikonfigurasi di Microsoft OneDrive.
User.Read.All (Opsi 1)
User.ReadBasic.All (Opsi 2)		 (Khusus kredensial gabungan) Opsi 1 memungkinkan penyimpanan data membaca profil pengguna. Opsi 2 memungkinkan penyimpanan data membaca kumpulan dasar properti profil 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: Mengizinkan penyimpanan data membaca, mendownload, membuat, mengupload, memperbarui, dan menghapus file yang dapat diakses pengguna.
Files.ReadWrite.All (Didelegasikan) Mengizinkan penyimpanan data membaca dan memperbarui file di semua drive yang dapat diakses pengguna. Diperlukan untuk tindakan mutasi file dan folder (menyalin, memindahkan, mengganti nama, membagikan, memperbarui properti) yang beroperasi pada file yang disimpan di drive selain Microsoft OneDrive milik 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 oleh Anda.

  • 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 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 yang diarsipkan atau dienkripsi 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.
  • Parser tata letak dalam mode penelusuran gabungan: Meskipun parser tata letak bersifat standar, efektivitasnya pada PDF yang 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 dianalisis atau dapat ditelusuri sepenuhnya. Hal ini mencakup:

    • Tata letak teks multi-kolom
    • Data dalam tabel dan diagram tersemat
    • Teks dalam dokumen yang dipindai yang memerlukan Pengenalan Karakter Optik (OCR)
    • Dokumen dengan urutan pembacaan 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