View a markdown version of this page

Hubungkan sumber data Confluence - 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 data Confluence

Setelah Anda mengatur otentikasi dan menyimpan kredenSIAL 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 User-managed pengaturan (3LO) (paling sederhana),Menyiapkan otentikasi dasar untuk Confluence, atauSiapkan otentikasi OAuth 2.0 untuk Confluence. Untuk pengaturan yang dikelola pengguna (3LO), Anda masuk melalui konsol dan Amazon Bedrock membuat rahasia untuk Anda (dengan ARN yang dihasilkan sistem); Anda memberikan URL host Confluence tetapi bukan rahasia. Untuk metode lain, Anda memerlukan ARN rahasia dan URL host Confluence.

Buat sumber data

Console
Untuk menghubungkan Confluence ke basis pengetahuan terkelola

  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 O tentikasi, pilih User-managed pengaturan (3LO), otentikasi dasar, atau otentikasi OAuth 2.0. Untuk pengaturan yang dikelola pengguna (3LO), secara opsional masukkan awalan nama rahasia, lalu pilih Mas uk untuk masuk ke Confluence Cloud. Anda tidak memberikan rahasia. 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. (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 di-crawl (halaman, blog, lampiran halaman, lampiran blog, ruang arsip, halaman yang diarsipkan, ruang pribadi).

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

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

API

Untuk membuat sumber data Confluence, kirim CreateDataSource permintaan dengan titik akhir waktu pembuatan 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 pengaturan yang dikelola pengguna (3LO), set authType el ke. MANAGED_OAUTH2 Anda tidak dapat membuat rahasia 3LO melalui API: pertama masuk melalui konsol untuk membuat rahasia, lalu atur secretArn ke ARN rahasia itu (lihatUser-managed pengaturan (3LO)). 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 "Confluence-connector" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://confluence-managed-connector.json

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

{
    "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 tidak sinkron: transisi status sumber data dari CREATING ke AVAILABLE saat operasi selesai.

Parameter konektor

Konfigurasi sumber data menggunakan parameter konektor berikut. Untuk menyambung ke Confluence, tentukan CONFLUENCE sebagai tipe konektor di. connectorParameters Untuk bidang yang membungkus connectorParameters (seperti deletionProtectionConfiguration danmediaExtractionConfiguration), lihatMenghubungkan sumber data.

Setel acleNabled secara eksplisit

Jika Anda menghilangkanaclEnabled, defaultnya bergantung padaauthType: BASIC default ketrue, dan OAUTH2 default ke. 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.

KoneksiKonfigurasi
Bidang Diperlukan Deskripsi
secretArn Ya ARN AWS Secrets Manager rahasia yang berisi kredensi Confluence Anda.
type Ya Jenis penyebaran Confluence. Setel keSAAS. Server Confluence dan Pusat Data tidak didukung.
authType Ya Jenis otentikasi. Setel ke MANAGED_OAUTH2 (pengaturan yang dikelola pengguna, 3LO),BASIC, atau. OAUTH2 Lihat Metode autentikasi.
hostUrl Ya URL dasar instance 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. Merayap hanya ketika crawlPage jugatrue.
crawlBlogAttachment Tidak Apakah akan merayapi lampiran posting blog. Merayap 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 spasi 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 menonaktifkan. Jika Anda menghilangkan bidang ini, defaultnya bergantung padaauthType: BASIC default ketrue; OAUTH2 default ke. false ACL on BASIC memerlukan rahasia yang menyertakan kredentif 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 kredenSIAL yang cocok, 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.