View a markdown version of this page

Hubungkan sumber SharePoint data - Amazon Bedrock
Buat sumber dataParameter konektorUbah metode otentikasiLangkah selanjutnya

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) (paling sederhana), Mengatur App-Only otentikasi Microsoft Entra ID untuk SharePoint (direkomendasikan untuk kontrol akses tingkat dokumen), atau. Siapkan otentikasi OAuth 2.0 untuk SharePoint 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.

  2. Pilih SharePoint dari dropdown sumber data.

  3. 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.

  4. 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).

  5. Pilih atau buat AWS Secrets Manager rahasia untuk menyimpan kredenSIAL Anda.

  6. Masukkan ID Penyewa Anda.

  7. Jika Anda memilih App-Only otentikasi ID Microsoft Entra, berikan jalur Sertifikat — jalur Amazon S3 ke file .p12 sertifikat Anda.

  8. (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.

  9. (Opsional) Perluas cakupan Sinkronisasi untuk mengonfigurasi konten yang akan di-crawl (file, halaman).

  10. (Opsional) Perluas sinkronisasi entitas berbasis tanggal untuk menentukan filter tanggal.

  11. (Opsional) Perluas pola jalur item untuk menambahkan jalur tertentu untuk memfilter item yang akan dirayapi.

API

Untuk membuat sumber SharePoint data, kirim CreateDataSource 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.jsonFile 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 hilangkancertificateS3Path. 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).

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 konektorconnectorParameters. Untuk bidang yang membungkus connectorParameters (seperti deletionProtectionConfiguration danmediaExtractionConfiguration), lihatMenghubungkan sumber data.

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.
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.

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 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 Sinkronkan sumber data. Untuk memfilter hasil kueri berdasarkan izin pengguna, lihatDocument-level kontrol akses.