View a markdown version of this page

Hubungkan sumber data Confluence - Amazon Bedrock

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Hubungkan sumber data Confluence

Setelah Anda mengatur otentikasi dan menyimpan kredensyal Anda secara AWS Secrets Manager rahasia, buat sumber data Confluence 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 Menyiapkan otentikasi dasar untuk Confluence atau Siapkan otentikasi OAuth 2.0 untuk Confluence. Anda memerlukan ARN rahasia dan URL host Confluence.

Buat sumber data

Console
Untuk menghubungkan Confluence ke basis pengetahuan terkelola Anda
  1. Di bawah Sumber data, berikan nama untuk sumber data Anda.

  2. Pilih Confluence dari dropdown sumber data.

  3. Di bawah Sumber, masukkan URL Confluence Anda (misalnya,https://example.atlassian.net).

  4. Di bawah Otentikasi, pilih Autentikasi dasar atau otentikasi OAuth 2.0.

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

  6. (Opsional, Hanya autentikasi dasar) Untuk mengaktifkan kontrol akses tingkat dokumen, pilih Kontrol akses dokumen dengan ACL. Rahasia yang Anda pilih harus mencakupadminApiKey,organizationId, dandirectoryId. Opsi ini tidak dapat diubah setelah pembuatan. Lihat perinciannya di Document-level kontrol akses.

  7. (Opsional) Perluas cakupan Sinkronisasi untuk memilih jenis entitas mana yang akan dirayapi (halaman, blog, lampiran halaman, lampiran blog, ruang arsip, halaman yang diarsipkan, ruang pribadi).

  8. (Opsional) Perluas URL Entitas untuk menggunakan URL-based pemfilteran untuk menyinkronkan ruang, halaman, dan blog Confluence tertentu.

  9. (Opsional) Perluas pola regex tipe Mime untuk menyertakan atau mengecualikan tipe MIME tertentu.

API

Untuk membuat sumber data Confluence, kirim CreateDataSourcepermintaan dengan titik akhir waktu build Agen untuk Amazon Bedrock. AWS Command Line Interface Contoh berikut membuat sumber data yang menggunakan otentikasi Dasar. Untuk menggunakan OAuth 2.0 sebagai gantinya, ubah authType ke. OAUTH2 Untuk mengaktifkan kontrol akses tingkat dokumen, setel ke. aclEnabled true Untuk deskripsi setiap bidang, lihat referensi parameter konektor berikut.

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

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

{ "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR", "managedKnowledgeBaseConnectorConfiguration": { "connectorParameters": { "type": "CONFLUENCE", "version": "1", "aclEnabled": false, "connectionConfiguration": { "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-basic-creds", "type": "SAAS", "authType": "BASIC", "hostUrl": "https://example.atlassian.net" }, "dataEntityConfiguration": { "crawlPage": true, "crawlBlog": true, "crawlPageAttachment": true, "crawlBlogAttachment": true }, "filterConfiguration": { "inclusionSpaceKeys": ["ENG", "DOCS"] } } } }

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 ke Confluence, tentukan CONFLUENCE sebagai tipe konektor di. connectorParameters Untuk bidang yang membungkus connectorParameters (seperti deletionProtectionConfiguration danmediaExtractionConfiguration), lihatConnect sumber data.

Setel ACLEnabled secara eksplisit

Jika Anda menghilangkanaclEnabled, defaultnya bergantung padaauthType: BASIC default ketrue, dan default ke. OAUTH2 false Karena konfigurasi ACL bersifat permanen setelah sumber data dibuat, atur aclEnabled secara eksplisit sehingga sumber data memiliki perilaku kontrol akses yang Anda inginkan. Lihat perinciannya di Document-level kontrol akses.

ConnectionConfiguration
Bidang Diperlukan Deskripsi
secretArn Ya ARN AWS Secrets Manager rahasia yang berisi kredenal Confluence Anda.
type Ya Jenis penyebaran Confluence. Setel keSAAS. Server Confluence dan Pusat Data tidak didukung.
authType Ya Jenis otentikasi. Setel ke BASIC atauOAUTH2. Lihat Metode autentikasi.
hostUrl Ya URL dasar instans Confluence Cloud Anda (misalnya,https://example.atlassian.net).
data EntityConfiguration (opsional)
Bidang Diperlukan Deskripsi
crawlPage Tidak Apakah akan merayapi halaman.
crawlBlog Tidak Apakah akan merayapi posting blog.
crawlPageAttachment Tidak Apakah akan merayapi lampiran halaman. Merangkak hanya ketika crawlPage jugatrue.
crawlBlogAttachment Tidak Apakah akan merayapi lampiran posting blog. Merangkak hanya ketika crawlBlog jugatrue.
crawlArchivedSpace Tidak Apakah akan merayapi ruang yang diarsipkan.
crawlArchivedPage Tidak Apakah akan merayapi halaman yang diarsipkan.
crawlPersonalSpace Tidak Apakah akan merangkak ruang pribadi.
FilterConfiguration (opsional)
Bidang Diperlukan Deskripsi
inclusionSpaceKeys Tidak Tombol spasi untuk disertakan.
inclusionSpaceUrls Tidak URL luar angkasa untuk disertakan.
inclusionMimeTypes Tidak Jenis MIME untuk disertakan.
exclusionMimeTypes Tidak Jenis MIME untuk dikecualikan.
maxFileSizeInMegaBytes Tidak Ukuran maksimum, dalam megabyte, dari setiap file tunggal yang dicerna konektor. Berikan sebagai string numerik (misalnya,"500"). Default ke "500".
ACLENabled (opsional)
Bidang Diperlukan Deskripsi
aclEnabled Tidak Apakah kontrol akses tingkat dokumen diaktifkan. Setel true untuk mengaktifkan, atau false untuk menonaktifkan. Jika Anda menghilangkan bidang ini, defaultnya bergantung padaauthType: BASIC default ke; default ketrue. OAUTH2 false ACL on BASIC membutuhkan rahasia yang mencakup kredensyal admin organisasi Atlassian. 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 Basic) dengan memperbarui sumber data dengan yang baru authType dan rahasia yang berisi kredensyal yang cocok, 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 menyerap konten ke basis pengetahuan Anda. Lihat perinciannya di Sinkronkan sumber data. Untuk memfilter hasil kueri berdasarkan izin pengguna, lihatDocument-level kontrol akses.