Buat sumber data Parameter konektor Ubah metode otentikasi Langkah selanjutnya

Connect sumber OneDrive data

Setelah Anda mengatur otentikasi dan menyimpan kredensyal Anda secara AWS Secrets Manager rahasia, buat sumber OneDrive 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 Mengatur otentikasi Microsoft Entra App ID untuk OneDrive (disarankan) atauSiapkan otentikasi OAuth 2.0 untuk OneDrive. Anda memerlukan ARN rahasia, ID penyewa Anda, dan (untuk kontrol akses tingkat dokumen) lokasi Amazon S3 sertifikat Anda.

Buat sumber data

Console

Untuk terhubung OneDrive ke basis pengetahuan terkelola

Di bawah Sumber data, berikan nama untuk sumber data Anda.
Pilih OneDrivedari dropdown sumber data.
Di bawah Sumber, masukkan ID OneDrive Penyewa Anda.
Di bawah Otentikasi, pilih Microsoft Entra ID App atau otentikasi OAuth 2.0.
Pilih atau buat AWS Secrets Manager rahasia untuk menyimpan kredensyal Anda.
(Opsional) Untuk mengaktifkan kontrol akses tingkat dokumen, pilih Kontrol akses dokumen dengan ACL dan berikan jalur Sertifikat — jalur Amazon S3 ke file sertifikat Anda. .p12 Opsi ini hanya tersedia dengan otentikasi Microsoft Entra ID App dan tidak dapat diubah setelah pembuatan. Lihat perinciannya di Document-level kontrol akses.
(Opsional) Perluas cakupan Sinkronisasi untuk memilih konten mana yang akan dirayapi. Dengan otentikasi Microsoft Entra ID App, hanya drive pribadi yang dapat dirayapi.
(Opsional) Perluas email Pengguna untuk menambahkan email tertentu dari pengguna yang datanya ingin Anda sertakan atau kecualikan.
(Opsional) Perluas filter jalur File untuk menyertakan atau mengecualikan file dan folder tertentu.
(Opsional) Perluas pola regex tipe Mime untuk menambahkan pola regex untuk menyertakan atau mengecualikan tipe MIME tertentu.
(Opsional) Perluas sinkronisasi entitas berbasis Tanggal untuk menentukan filter tanggal.

API

Untuk membuat sumber OneDrive data, kirim CreateDataSourcepermintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. AWS Command Line Interface Contoh berikut membuat sumber data yang menggunakan otentikasi Microsoft Entra App ID. Untuk mengaktifkan kontrol akses tingkat dokumen, setel aclEnabled ke true dan tambahkan ke. certificateS3Path connectionConfiguration Untuk deskripsi setiap bidang, lihat referensi parameter konektor berikut.


aws bedrock-agent create-data-source \
 --name "OneDrive-connector" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://onedrive-managed-connector.json

onedrive-managed-connector.jsonFile tersebut berisi yang berikut:


{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "ONEDRIVE",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-onedrive-creds",
                "tenantId": "12345678-1234-1234-1234-123456789012",
                "authType": "ENTRA_APP_ID"
            },
            "dataEntityConfiguration": {
                "crawlPersonalDrives": true
            }
        }
    }
}

Untuk mengaktifkan kontrol akses tingkat dokumen, setel ke true dan tambahkan aclEnabled ke: certificateS3Path connectionConfiguration


{
    "type": "ONEDRIVE",
    "version": "1",
    "aclEnabled": true,
    "connectionConfiguration": {
        "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-onedrive-creds",
        "tenantId": "12345678-1234-1234-1234-123456789012",
        "authType": "ENTRA_APP_ID",
        "certificateS3Path": {
            "s3BucketName": "your-certificate-bucket",
            "s3KeyName": "certs/certificate.p12"
        }
    },
    "dataEntityConfiguration": {
        "crawlPersonalDrives": true
    }
}

Untuk sumber OAUTH2 data, atur authType ke OAUTH2 dan hilangkancertificateS3Path.

Untuk basis pengetahuan terkelola, CreateDataSource asinkron: transisi status sumber data dari CREATING ke AVAILABLE saat operasi selesai.

Parameter konektor

Konfigurasi sumber data menggunakan parameter konektor berikut. Untuk terhubung OneDrive, tentukan ONEDRIVE sebagai tipe konektor diconnectorParameters. Untuk bidang yang membungkus connectorParameters (seperti deletionProtectionConfiguration danmediaExtractionConfiguration), lihatConnect sumber data.

ConnectionConfiguration
Bidang	Diperlukan	Deskripsi
`secretArn`	Ya	ARN AWS Secrets Manager rahasia yang berisi kredensialmu OneDrive .
`tenantId`	Ya	ID penyewa Microsoft Entra (Azure AD).
`authType`	Ya	Jenis otentikasi: `ENTRA_APP_ID` (disarankan) atau`OAUTH2`. Lihat Metode autentikasi.
`certificateS3Path`	Bersyarat	Diperlukan saat `aclEnabled` ini `true` (otentikasi ID Aplikasi Microsoft Entra). Berisi `s3BucketName` dan `s3KeyName` untuk file `.p12` sertifikat di Amazon S3. Tidak digunakan untuk perayapan konten saja atau dengan. `OAUTH2`

data EntityConfiguration
Bidang	Diperlukan	Deskripsi
`crawlPersonalDrives`	Tidak	Apakah akan merayapi drive pribadi pengguna.
`crawlSharedWithMe`	Tidak	Apakah akan merayapi file yang dibagikan dengan pengguna yang masuk. Hanya didukung dengan `OAUTH2` otentikasi. Otentikasi Microsoft Entra App ID (khusus aplikasi) tidak dapat merayapi file bersama.

catatan

OneNote notebook saat ini tidak didukung.

FilterConfiguration (opsional)
Bidang	Diperlukan	Deskripsi
`inclusionUserEmailAddresses`	Tidak	Alamat email pengguna yang drive-nya disertakan.
`exclusionUserEmailAddresses`	Tidak	Alamat email pengguna yang drive-nya dikecualikan.
`userFilterPath`	Tidak	URL Amazon S3 yang menunjuk ke file yang mencantumkan pengguna untuk disertakan atau dikecualikan.
`inclusionDriveItems`	Tidak	Dorong jalur item untuk disertakan.
`exclusionDriveItems`	Tidak	Dorong jalur item untuk dikecualikan.
`includeMimeTypes`	Tidak	Jenis MIME untuk disertakan.
`excludeMimeTypes`	Tidak	Jenis MIME untuk dikecualikan.
`absoluteDateBefore`	Tidak	Hanya sertakan konten yang dimodifikasi sebelum tanggal ini (ISO 8601).
`absoluteDateAfter`	Tidak	Hanya sertakan konten yang dimodifikasi setelah tanggal ini (ISO 8601).

catatan

Dengan OAUTH2 autentikasi, konektor akan dirayapi dalam konteks delegasi pengguna yang masuk. Filter berbasis pengguna (inclusionUserEmailAddresses,exclusionUserEmailAddresses,userFilterPath) menentukan drive pengguna mana yang mencoba konektor; drive yang tidak dapat diakses pengguna yang masuk dilewati secara diam-diam. Untuk merayapi setiap pengguna OneDrive di penyewa Anda terlepas dari izin, gunakan autentikasi. ENTRA_APP_ID

ACLENabled (opsional)
Bidang	Diperlukan	Deskripsi
`aclEnabled`	Tidak	Setel `true` untuk mengaktifkan kontrol akses tingkat dokumen. Membutuhkan `ENTRA_APP_ID` otentikasi dan `certificateS3Path` masuk`connectionConfiguration`. 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 autentikasi sumber data (misalnya, dari OAuth 2.0 ke Microsoft Entra App ID) dengan memperbarui sumber data dengan yang baru authType dan kredensyal, menggunakan operasi atau. UpdateDataSource 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 mencerna konten ke basis pengetahuan Anda. Lihat perinciannya di Sinkronkan sumber data. Untuk memfilter hasil kueri berdasarkan izin pengguna, lihatDocument-level kontrol akses.

Konvensi Dokumen

Mengatur otentikasi OAuth 2.0

Document-level kontrol akses