Ringkasan

Penyimpanan data Microsoft SharePoint untuk Gemini Enterprise memungkinkan Anda menelusuri dan melakukan tindakan pada data Microsoft SharePoint Online Anda, termasuk dokumen, daftar, dan situs.

Versi Microsoft SharePoint yang didukung

Penyimpanan data Microsoft SharePoint mendukung Microsoft SharePoint Online versi cloud terbaru.

Tindakan yang didukung

Jika penyimpanan data Microsoft SharePoint 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.
Tambahkan daftar Membuat daftar data terstruktur baru (misalnya, tugas, kontak) di situs Microsoft SharePoint.
Upload dokumen Mengupload dokumen ke situs atau library Microsoft SharePoint.
Download dokumen Mendownload dokumen dari situs atau library Microsoft SharePoint.
Tambahkan halaman Membuat halaman baru di situs Microsoft SharePoint.
Lihat dokumen Mengeluarkan dokumen dari library Microsoft SharePoint.
Periksa dalam dokumen Check in dokumen ke library Microsoft SharePoint.
Mengganti nama lampiran atau dokumen Mengganti nama lampiran atau dokumen di library Microsoft SharePoint.
Memindahkan lampiran atau dokumen Memindahkan dokumen dari library Microsoft SharePoint ke library tujuan, folder, atau situs SharePoint lain.
Menghapus dokumen check out Membatalkan check-out pada dokumen, mengembalikannya tanpa menyimpan perubahan.
Membagikan resource Membagikan dokumen, folder, atau resource kepada penerima tertentu atau membuat link berbagi.
Memperbarui properti file Memperbarui properti metadata dokumen di library Microsoft SharePoint.
Perbarui halaman Memperbarui halaman yang ada di situs Microsoft SharePoint.
Perbarui daftar Memperbarui setelan daftar data terstruktur yang ada di situs Microsoft SharePoint.
Buat item daftar Membuat item baru dalam daftar tertentu di situs Microsoft SharePoint.
Memperbarui item daftar Memperbarui kolom item yang ada dalam daftar tertentu.
Membuat daftar daftar Mengambil semua daftar dan library dokumen di situs Microsoft SharePoint tertentu.
Dapatkan item daftar Menampilkan satu item daftar, termasuk semua nilai kolomnya.
Mendapatkan kolom daftar Menampilkan skema daftar tertentu, termasuk semua kolom dan propertinya.

Izin yang diperlukan

Agar Gemini Enterprise dapat melakukan penelusuran dan penyerapan data menggunakan penyimpanan data Microsoft SharePoint, 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 T/A Tidak ada izin Graph API yang diperlukan.
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. API 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. Koleksi situs tertentu dan izin yang diberikan dapat dikonfigurasi di SharePoint Online.
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 dalam organisasi.
Tindakan Sites.ReadWrite.All (Penelusuran gabungan & Penyerapan data) Mengizinkan penyimpanan data untuk mengedit atau menghapus dokumen dan item daftar di semua koleksi situs atas nama pengguna yang login.
Sites.Read.All (Penelusuran gabungan & Penyerapan data) Mengizinkan penyimpanan data membaca daftar, item daftar, dan skema daftar di semua kumpulan situs atas nama pengguna yang login. Diperlukan untuk tindakan daftar daftar, dapatkan item daftar, dan dapatkan kolom daftar.
Files.ReadWrite Mengizinkan penyimpanan data membaca, membuat, memperbarui, dan menghapus file pengguna yang login.
Files.ReadWrite.All Mengizinkan penyimpanan data untuk membaca, membuat, memperbarui, menghapus, mengupload, dan mendownload semua file yang dapat diakses oleh pengguna yang login.
Sites.Manage.All Mengizinkan penyimpanan data membuat atau menghapus pustaka dokumen dan daftar di semua kumpulan situs atas nama pengguna.

Izin Microsoft SharePoint API

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

Mode koneksi Cakupan Tujuan
Penelusuran gabungan Sites.Search.All (Didelegasikan) Memungkinkan penyimpanan data menjalankan kueri penelusuran dan membaca info situs dasar atas nama pengguna yang saat ini login. Hasil penelusuran didasarkan pada izin pengguna, bukan izin aplikasi.
AllSites.Read (Opsi 1, Didelegasikan) Mengizinkan penyimpanan data membaca dokumen dan item daftar di semua koleksi situs atas nama pengguna yang login.
Sites.Selected (Opsi 2, Didelegasikan) Mengizinkan penyimpanan data mengakses subset kumpulan situs dengan pengguna yang login. Koleksi situs tertentu dan izin yang diberikan dapat dikonfigurasi di SharePoint Online.
Penyerapan data (Kredensial gabungan) Sites.FullControl.All (Opsi 1, Aplikasi) Memungkinkan penyimpanan data memiliki kontrol penuh atas semua kumpulan situs.
Sites.Selected (Opsi 2, Aplikasi) Mengizinkan penyimpanan data mengakses subset kumpulan situs dengan pengguna yang login. Koleksi situs tertentu dan izin yang diberikan dapat dikonfigurasi di SharePoint Online.
Penyerapan data (token refresh OAuth 2.0) AllSites.FullControl (Opsi 1, Didelegasikan) Mengizinkan penyimpanan data memiliki kontrol penuh atas semua kumpulan situs atas nama pengguna yang login.
Sites.Selected (Opsi 2, Didelegasikan) Mengizinkan penyimpanan data mengakses subset kumpulan situs dengan pengguna yang login. Koleksi situs tertentu dan izin yang diberikan dapat dikonfigurasi di SharePoint Online.
Tindakan AllSites.Write (Didelegasikan) Mengizinkan penyimpanan data untuk membuat, membaca, memperbarui, menghapus, mengupload, dan mendownload dokumen serta item daftar di semua koleksi situs atas nama pengguna yang login.

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

Batasan

Bagian ini menguraikan masalah dan batasan umum yang dapat memengaruhi penggunaan penyimpanan data Microsoft SharePoint.

  • 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 SharePoint 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 SharePoint hanya didukung di lokasi global, us, dan eu.

  • Prasyarat kualitas penelusuran: Untuk mendapatkan hasil penelusuran yang optimal dan memanfaatkan fitur Pustaka Pengetahuan sepenuhnya, sebaiknya konfigurasi dan sinkronkan Penyimpanan data penelusuran orang selain penyimpanan data Microsoft SharePoint.

Berikut adalah batasan untuk penyimpanan data gabungan Microsoft SharePoint:

  • 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 situs atau pustaka bersama mungkin memerlukan izin khusus yang tidak tercakup dalam otorisasi pengguna standar.
  • Penguraian tata letak dalam mode penelusuran gabungan: Meskipun penguraian 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 pembacaan non-linear atau pemformatan rumit.

Rekomendasi

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

Memecahkan masalah hasil penelusuran konektor SharePoint

Jika Anda mengalami masalah terkait dokumen yang hilang, hasil yang salah, atau relevansi penelusuran yang buruk, periksa area diagnostik berikut:

  • Periksa penyimpanan data Orang: Pastikan penyimpanan data penelusuran Orang disiapkan dan disinkronkan jika Anda menghadapi masalah relevansi atau pencocokan entitas.
  • Error autentikasi: Error autentikasi persisten, seperti "Error saat mengambil token akses Graph API", akan mencegah penelusuran berfungsi. Untuk mengatasinya, periksa log Microsoft Entra ID untuk mengetahui detailnya, lalu lakukan autentikasi ulang koneksi.
  • Ketidakcocokan identitas: Jika menggunakan Identitas Google, verifikasi bahwa email Google pengguna sama persis dengan email Microsoft SharePoint-nya. Ketidakcocokan mencegah hasil ditampilkan.
  • Penelusuran folder yang ditargetkan (URL .aspx): Penelusuran dengan URL browser lengkap yang diakhiri dengan /Forms/AllItems.aspx akan menjalankan penelusuran di seluruh situs, bukan hanya folder tertentu. Selalu gunakan jalur folder absolut untuk penelusuran yang ditargetkan.
  • Batas hasil: Perlu diketahui bahwa penelusuran gabungan mungkin memiliki batas jumlah dokumen yang ditampilkan per kueri (biasanya dibatasi sekitar 20 hasil).
  • Masalah kutipan: Kutipan yang salah dapat terjadi sesekali. Jika masalah berlanjut, laporkan masalah tersebut ke dukungan dan sertakan token diagnostik Anda.
  • Kompatibilitas model-konektor: Pastikan Anda menggunakan versi model Gemini terbaru. Beberapa model lama (misalnya, 3.x) memiliki masalah yang diketahui dalam menyelesaikan alat untuk tindakan SharePoint, seperti download_document dalam Agent Builder.

Langkah berikutnya