Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Hubungkan sumber SharePoint data
Setelah Anda mengatur otentikasi dan menyimpan kredenSIAL Anda secara AWS Secrets Manager rahasia, buat sumber SharePoint data di basis pengetahuan Anda. Halaman ini menjelaskan cara membuat sumber data dengan Konsol Manajemen AWS atau API, diikuti dengan referensi untuk parameter konektor yang dapat Anda konfigurasi.
**catatan**
Selesaikan pengaturan otentikasi terlebih dahulu. Lihat [User-managed pengaturan (3LO)](kb-managed-sharepoint-3lo-setup.md) (paling sederhana), [Mengatur App-Only otentikasi Microsoft Entra ID untuk SharePoint](kb-managed-sharepoint-entra-setup.md) (direkomendasikan untuk kontrol akses tingkat dokumen), atau. [Siapkan otentikasi OAuth 2.0 untuk SharePoint](kb-managed-sharepoint-oauth2-setup.md) Untuk pengaturan yang dikelola pengguna (3LO), Anda masuk melalui konsol dan Amazon Bedrock membuat rahasia untuk Anda (dengan ARN yang dihasilkan sistem); Anda tidak memberikan ID rahasia atau penyewa. Untuk metode lain, Anda memerlukan ARN rahasia, ID penyewa Anda, dan (untuk App-Only otentikasi ID Microsoft Entra) lokasi Amazon S3 sertifikat Anda.
## Buat sumber data
------
#### [ Console ]
**Untuk terhubung SharePoint ke basis pengetahuan terkelola Anda**
1. Di bawah Sumber ** data**, berikan nama untuk sumber data Anda.
1. Pilih ** SharePoint ** dari dropdown sumber data.
1. Di bawah ** Sumber**, masukkan URL ** Situs Anda**. Setiap URL harus dimulai dengan `https://` dan menunjuk ke situs, situs tim, atau situs pribadi (misalnya,`https://contoso.sharepoint.com/sites/engineering`). Anda dapat menambahkan hingga 100 URL.
1. Di bawah O ** ten ** tikasi, pilih ** User-managed pengaturan (3LO)**, ** Microsoft Entra ID App-Only**, atau otentikasi ** OAuth 2.0. ** Untuk pengaturan yang dikelola pengguna (3LO), secara opsional masukkan awalan nama ** rahasia. ** Kemudian pilih Mas ** uk untuk ** masuk SharePoint dan otorisasi koneksi. Anda tidak memberikan ID rahasia atau penyewa. Amazon Bedrock menciptakan rahasia dengan ARN yang dihasilkan sistem untuk menyimpan token. Lihat perinciannya di [User-managed pengaturan (3LO)](kb-managed-sharepoint-3lo-setup.md).
1. Pilih atau buat AWS Secrets Manager rahasia untuk menyimpan kredenSIAL Anda.
1. Masukkan ID ** Penyewa Anda**.
1. Jika Anda memilih App-Only otentikasi ID Microsoft Entra, berikan jalur ** Sertifikat ** — jalur Amazon S3 ke file `.p12` sertifikat Anda.
1. (Opsional) Untuk mengaktifkan kontrol akses tingkat dokumen, pilih ** Kontrol akses dokumen dengan ACL. ** Opsi ini hanya tersedia dengan App-Only otentikasi Microsoft Entra ID dan tidak dapat diubah setelah pembuatan. Lihat perinciannya di [Document-level kontrol akses](kb-managed-ds-sharepoint-acl.md).
1. (Opsional) Perluas ** cakupan Sinkronisasi ** untuk mengonfigurasi konten yang akan di-crawl (file, halaman).
1. (Opsional) Perluas sinkronisasi entitas berbasis ** tanggal ** untuk menentukan filter tanggal.
1. (Opsional) Perluas pola jalur ** item ** untuk menambahkan jalur tertentu untuk memfilter item yang akan dirayapi.
------
#### [ API ]
Untuk membuat sumber SharePoint data, kirim [ CreateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) permintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. AWS Command Line Interface Contoh berikut membuat sumber data yang menggunakan App-Only otentikasi ID Microsoft Entra. Untuk mengaktifkan kontrol akses tingkat dokumen, set `aclEnabled` el ke. `true` Untuk deskripsi setiap bidang, lihat referensi parameter konektor berikut.
```
aws bedrock-agent create-data-source \
--name "{{SharePoint-connector}}" \
--knowledge-base-id "{{your-knowledge-base-id}}" \
--data-source-configuration file://sharepoint-managed-connector.json
```
`sharepoint-managed-connector.json`File berisi yang berikut ini:
```
{
"type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
"managedKnowledgeBaseConnectorConfiguration": {
"connectorParameters": {
"type": "SHAREPOINT",
"version": "1",
"aclEnabled": false,
"connectionConfiguration": {
"secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-sharepoint-creds}}",
"tenantId": "{{12345678-1234-1234-1234-123456789012}}",
"authType": "ENTRA_ID_APP_ONLY",
"certificateS3Path": {
"s3BucketName": "{{your-certificate-bucket}}",
"s3KeyName": "{{certs/certificate.p12}}"
}
},
"dataEntityConfiguration": {
"crawlFiles": true,
"crawlPages": true,
"siteUrls": [
"{{https://contoso.sharepoint.com/sites/engineering}}"
]
}
}
}
}
```
Untuk sumber `OAUTH2_APP` data, atur `authType` ke `OAUTH2_APP` dan hilangkan`certificateS3Path`. Untuk pengaturan yang dikelola pengguna (3LO), atur `authType` ke `MANAGED_OAUTH2` dan hilangkan. `certificateS3Path` Anda tidak dapat membuat rahasia 3LO melalui API: pertama masuk melalui konsol untuk membuat rahasia, lalu atur `secretArn` ke ARN rahasia itu. Lihat perinciannya di [User-managed pengaturan (3LO)](kb-managed-sharepoint-3lo-setup.md).
Untuk basis pengetahuan terkelola, `CreateDataSource` tidak sinkron: transisi status sumber data dari `CREATING` ke `AVAILABLE` saat operasi selesai.
------
## Parameter konektor
Konfigurasi sumber data menggunakan parameter konektor berikut. Untuk terhubung ke SharePoint, tentukan `SHAREPOINT` sebagai tipe konektor`connectorParameters`. Untuk bidang yang membungkus `connectorParameters` (seperti `deletionProtectionConfiguration` dan`mediaExtractionConfiguration`), lihat[Menghubungkan sumber data](kb-managed-connect-ds.md).
**KoneksiKonfigurasi**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| secretArn | Ya | ARN AWS Secrets Manager rahasia yang berisi SharePoint kredensimalmu. |
| tenantId | Ya | ID penyewa Microsoft Entra (Azure AD). |
| authType | Ya | Jenis otentikasi: MANAGED\_OAUTH2 (pengaturan yang dikelola pengguna, 3LO), ENTRA\_ID\_APP\_ONLY (disarankan), atau. OAUTH2\_APP Lihat [Metode autentikasi](kb-managed-ds-sharepoint.md#kb-managed-sharepoint-auth-methods). |
| certificateS3Path | Bersyarat | Diperlukan untuk ENTRA\_ID\_APP\_ONLY otentikasi, bahkan ketika ACL dinonaktifkan. Ber s3BucketName isi dan s3KeyName untuk file sertifikat di Amazon S3. Tidak digunakan denganOAUTH2\_APP. |
**data EntityConfiguration**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| siteUrls | Ya | Daftar URL SharePoint situs yang akan di-crawl. Setiap URL adalah titik masuk crawling dan harus dimulai dengan https:// dan menunjuk ke situs, situs tim, atau situs pribadi — jalur harus dimulai dengan /sites//teams/,, atau /personal/ diikuti oleh nama situs (misalnya,https://contoso.sharepoint.com/sites/engineering). \*.sharepoint.comDomain standar dan domain kustom (vanity) keduanya didukung. Dalam setiap situs, konektor merayapi file dan halaman (lihat crawlFiles dancrawlPages); untuk menargetkan item tertentu, gunakaninclusionItemPaths. |
| crawlFiles | Tidak | Apakah akan merayapi file. Default ke true. |
| crawlPages | Tidak | Apakah akan merayapi halaman. Default ke true. |
**FilterConfiguration (opsional)**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| modifiedDateBefore | Tidak | Hanya menyertakan konten yang dimodifikasi sebelum tanggal ini (ISO 8601). |
| modifiedDateAfter | Tidak | Hanya menyertakan konten yang dimodifikasi setelah tanggal ini (ISO 8601). |
| inclusionItemPaths | Tidak | Jalur item tertentu untuk disertakan. Saat Anda menyediakaninclusionItemPaths, konektor merayapi item tersebut dan tidak memvalidasisiteUrls. |
**ACLEnabled (opsional)**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| aclEnabled | Tidak | Setel true untuk mengaktifkan kontrol akses tingkat dokumen. Membutuhkan ENTRA\_ID\_APP\_ONLY otentikasi. Anda tidak dapat mengubah pengaturan ini setelah Anda membuat sumber data. Lihat perinciannya di [Document-level kontrol akses](kb-managed-ds-sharepoint-acl.md). |
## Ubah metode otentikasi
Anda dapat mengubah metode otentikasi sumber data (misalnya, dari OAuth 2.0 ke Microsoft Entra ID App-Only) dengan memperbarui sumber data dengan yang baru `authType` dan kredenSIAL, menggunakan [ UpdateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) operasi atau. Konsol Manajemen AWS Pengaturan kontrol akses tingkat dokumen diperbaiki saat Anda membuat sumber data, jadi untuk menambah atau menghapus ACL Anda harus membuat sumber data baru.
## Langkah selanjutnya
Setelah Anda membuat sumber data, sinkronkan untuk menelan konten ke basis pengetahuan Anda. Lihat perinciannya di [Menyinkronkan sumber data](kb-managed-sync.md). Untuk memfilter hasil kueri berdasarkan izin pengguna, lihat[Document-level kontrol akses](kb-managed-ds-sharepoint-acl.md).