Ringkasan

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

Versi Microsoft SharePoint yang didukung

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

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.
Check out dokumen Melakukan check out dokumen dari library Microsoft SharePoint.
Check in dokumen Melakukan 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, folder, atau situs SharePoint lain tujuan.
Menghapus dokumen check-out Menghapus check-out pada dokumen, mengembalikannya tanpa menyimpan perubahan.
Bagikan referensi Membagikan dokumen, folder, atau referensi kepada penerima yang ditentukan 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.
Membuat item daftar Membuat item baru dalam daftar yang ditentukan di situs Microsoft SharePoint.
Memperbarui item daftar Memperbarui kolom item yang ada dalam daftar yang ditentukan.
Membuat daftar daftar Mengambil semua daftar dan library dokumen di situs Microsoft SharePoint yang ditentukan.
Mendapatkan item daftar Menampilkan satu item daftar, termasuk semua nilai kolomnya.
Mendapatkan kolom daftar Menampilkan skema daftar yang ditentukan, 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 Actions untuk mode koneksi Federated search atau penyerapan data, pilih juga izin yang tercantum di baris Actions.

Mode koneksi Cakupan Tujuan
Penelusuran gabungan T/A Tidak diperlukan izin Graph API.
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. Koleksi situs tertentu dan izin yang diberikan dapat dikonfigurasi di SharePoint Online.
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 Sites.ReadWrite.All (Penelusuran gabungan & Penyerapan data) Memungkinkan penyimpanan data mengedit atau menghapus dokumen dan item daftar di semua kumpulan situs atas nama pengguna yang login.
Sites.Read.All (Penelusuran gabungan & Penyerapan data) Memungkinkan penyimpanan data membaca daftar, item daftar, dan skema daftar di semua kumpulan situs atas nama pengguna yang login. Diperlukan untuk tindakan list lists, get list item, dan get list fields.
Files.ReadWrite Mengizinkan penyimpanan data membaca, membuat, memperbarui, dan menghapus file pengguna yang login.
Files.ReadWrite.All Mengizinkan penyimpanan data 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 daftar dan koleksi dokumen 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 mencantumkan item di 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.
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 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 umum dan batasan 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 mencapai hasil penelusuran yang optimal dan memanfaatkan fitur Pustaka Pengetahuan sepenuhnya, sebaiknya konfigurasikan 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 library 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.

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 telah disiapkan dan disinkronkan jika Anda menghadapi masalah relevansi atau pencocokan entitas.
  • Error autentikasi: Error autentikasi yang persisten, seperti "Error saat mengambil token akses Graph API", akan mencegah penelusuran berfungsi. Untuk mengatasi masalah ini, periksa log Microsoft Entra ID untuk mengetahui detailnya, lalu autentikasi ulang koneksi.
  • Ketidakcocokan identitas: Jika menggunakan Google Identity, pastikan email Google pengguna sama persis dengan email Microsoft SharePoint mereka. 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 umum dalam menyelesaikan alat untuk tindakan SharePoint, seperti download_document dalam Agent Builder.

Langkah berikutnya