Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Connect to Confluence untuk basis pengetahuan Anda
Atlassian Confluence adalah alat manajemen kerja kolaboratif yang dirancang untuk berbagi, menyimpan, dan mengerjakan perencanaan proyek, pengembangan perangkat lunak, dan manajemen produk. [Anda dapat menyambung ke instans Confluence untuk basis pengetahuan Amazon Bedrock dengan menggunakan [AWS Management Console untuk Amazon Bedrock](https://console.aws.amazon.com/bedrock/home) atau API [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html)(lihat SDK yang didukung Amazon Bedrock dan). AWS CLI](https://docs.aws.amazon.com/bedrock/latest/APIReference/welcome.html)
**catatan**
Konektor sumber data pertemuan dalam rilis pratinjau dan dapat berubah sewaktu-waktu.
Sumber data pertemuan tidak mendukung data multimodal, seperti tabel, bagan, diagram, atau gambar lainnya.
Amazon Bedrock mendukung koneksi ke instans Confluence Cloud. Saat ini, hanya penyimpanan vektor Amazon OpenSearch Tanpa Server yang tersedia untuk digunakan dengan sumber data ini.
Ada batasan berapa banyak file dan MB per file yang dapat dirayapi. Lihat [Kuota untuk basis pengetahuan](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas.html).
**Topics**
+ [Fitur yang didukung](#supported-features-confluence-connector)
+ [Prasyarat](#prerequisites-confluence-connector)
+ [Konfigurasi koneksi](#configuration-confluence-connector)
## Fitur yang didukung
+ Deteksi otomatis bidang dokumen utama
+ Inclusion/exclusion filter konten
+ Konten tambahan disinkronkan untuk konten yang ditambahkan, diperbarui, dihapus
+ Otentikasi OAuth 2.0, otentikasi dengan token Confluence API
## Prasyarat
**Di Confluence, pastikan Anda**:
+ Catat URL instans Confluence Anda. Misalnya, untuk Confluence Cloud,. {{https://example.atlassian.net}} URL untuk Confluence Cloud harus berupa URL dasar, diakhiri dengan. {{.atlassian.net}}
+ Konfigurasikan kredensyal otentikasi dasar yang berisi nama pengguna (email akun admin) dan kata sandi (token Confluence API) untuk memungkinkan Amazon Bedrock terhubung ke instans Confluence Cloud Anda. Untuk informasi tentang cara membuat token API Confluence, lihat [Mengelola token API untuk akun Atlassian Anda](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token) di situs web Atlassian.
+ (Opsional) Konfigurasikan aplikasi OAuth 2.0 dengan kredensyal kunci aplikasi, rahasia aplikasi, token akses, dan token penyegaran. Untuk informasi selengkapnya, lihat [aplikasi OAuth 2.0](https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/) di situs web Atlassian.
+ Izin atau cakupan baca tertentu harus diaktifkan agar aplikasi OAuth 2.0 Anda dapat terhubung ke Confluence.
API pertemuan:
+ offline\_access
+ read:content:confluence — Lihat isi rinci
+ baca:content-details:confluence - Lihat rincian konten
+ baca:space-details:confluence — Lihat detail ruang
+ read:audit-log:confluence - Lihat catatan audit
+ baca:page:confluence - Lihat halaman
+ read:attachment:confluence - Lihat dan unduh lampiran konten
+ baca:blogpost:confluence - Lihat blogposts
+ baca: custom-content:confluence - Lihat konten kustom
+ baca:comment:confluence — Lihat komentar
+ baca:template:confluence - Lihat template konten
+ read:label:confluence - Lihat label
+ read:watcher:confluence - Lihat pengamat konten
+ read:relation:confluence - Lihat hubungan entitas
+ read:user:confluence — Lihat detail pengguna
+ read:configuration:confluence - Lihat pengaturan Confluence
+ read:space:confluence — Lihat detail ruang
+ read:space.property:confluence - Lihat properti ruang
+ read:user.property:confluence - Lihat properti pengguna
+ read:space.setting:confluence - Lihat pengaturan ruang
+ read:analytics.content:confluence - Lihat analitik untuk konten
+ read:content.property:confluence - Lihat properti konten
+ read:content.metadata:confluence — Lihat ringkasan konten
+ read:inlinetask:confluence - Lihat tugas
+ baca:task:confluence - Lihat tugas
+ baca:whiteboard:confluence — Lihat papan tulis
+ baca:app-data:confluence - Baca data aplikasi
+ read:folder:confluence - Lihat folder
+ read:embed:confluence - Lihat data Smart Link
**Di AWS akun Anda, pastikan Anda**:
+ Simpan kredensyal otentikasi Anda secara [AWS Secrets Manager rahasia dan catat Nama](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html) Sumber Daya Amazon (ARN) dari rahasianya. Ikuti petunjuk **konfigurasi Koneksi** di halaman ini untuk menyertakan pasangan nilai kunci yang harus disertakan dalam rahasia Anda.
+ Sertakan izin yang diperlukan untuk terhubung ke sumber data Anda dalam role/permissions kebijakan AWS Identity and Access Management (IAM) untuk basis pengetahuan Anda. Untuk informasi tentang izin yang diperlukan untuk sumber data ini untuk ditambahkan ke IAM peran basis pengetahuan Anda, lihat [Izin untuk mengakses sumber data](https://docs.aws.amazon.com/bedrock/latest/userguide/kb-permissions.html#kb-permissions-access-ds).
**catatan**
Jika Anda menggunakan konsol, Anda dapat pergi ke AWS Secrets Manager untuk menambahkan rahasia Anda atau menggunakan rahasia yang ada sebagai bagian dari langkah konfigurasi sumber data. IAM Peran dengan semua izin yang diperlukan dapat dibuat untuk Anda sebagai bagian dari langkah konsol untuk membuat basis pengetahuan. Setelah Anda mengonfigurasi sumber data dan konfigurasi lainnya, IAM peran dengan semua izin yang diperlukan diterapkan ke basis pengetahuan khusus Anda.
Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensyal dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami tidak menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data.
## Konfigurasi koneksi
Untuk menyambung ke instans Confluence, Anda harus memberikan informasi konfigurasi yang diperlukan agar Amazon Bedrock dapat mengakses dan meng-crawl data Anda. Anda juga harus mengikuti[Prasyarat](#prerequisites-confluence-connector).
Contoh konfigurasi untuk sumber data ini disertakan dalam bagian ini.
Untuk informasi selengkapnya tentang deteksi otomatis bidang dokumen, inclusion/exclusion filter, sinkronisasi inkremental, kredensyal otentikasi rahasia, dan cara kerjanya, pilih yang berikut ini:
### Deteksi otomatis bidang dokumen utama
Konektor sumber data secara otomatis mendeteksi dan merayapi semua bidang metadata utama dokumen atau konten Anda. Misalnya, konektor sumber data dapat merayapi badan dokumen yang setara dengan dokumen Anda, judul dokumen, tanggal pembuatan atau modifikasi dokumen, atau bidang inti lainnya yang mungkin berlaku untuk dokumen Anda.
**penting**
Jika konten Anda menyertakan informasi sensitif, maka Amazon Bedrock dapat merespons menggunakan informasi sensitif.
Anda dapat menerapkan operator pemfilteran ke bidang metadata untuk membantu Anda lebih meningkatkan relevansi tanggapan. Misalnya, dokumentasikan “epoch\_modification\_time” atau jumlah detik yang berlalu 1 Januari 1970 untuk saat dokumen terakhir diperbarui. *Anda dapat memfilter data terbaru, di mana “epoch\_modification\_time” lebih besar dari angka tertentu.* Untuk informasi selengkapnya tentang operator pemfilteran yang dapat Anda terapkan ke bidang metadata, lihat [Metadata](https://docs.aws.amazon.com/bedrock/latest/userguide/kb-test-config.html) dan pemfilteran.
### Inclusion/exclusion filter
Anda dapat menyertakan atau mengecualikan perayapan konten tertentu. Misalnya, Anda dapat menentukan pola prefix/regular ekspresi pengecualian untuk melewatkan perayapan file apa pun yang berisi “pribadi” dalam nama file. Anda juga dapat menentukan pola prefix/regular ekspresi inklusi untuk menyertakan entitas konten atau jenis konten tertentu. Jika Anda menentukan filter penyertaan dan pengecualian dan keduanya cocok dengan dokumen, filter pengecualian akan diutamakan dan dokumen tidak dirayapi.
Contoh pola ekspresi reguler untuk mengecualikan atau memfilter file PDF yang berisi “pribadi” dalam nama file:*”. \*pribadi.\*\\\\ .pdf*”
Anda dapat menerapkan inclusion/exclusion filter pada jenis konten berikut:
+ `Space`: Kunci spasi unik
+ `Page`: Judul halaman utama
+ `Blog`: Judul blog utama
+ `Comment`: Komentar yang termasuk dalam halaman atau blog tertentu. Tentukan {{Re: Page/Blog Title}}
+ `Attachment`: Nama file lampiran dengan ekstensinya
### Sinkronisasi inkremental
Konektor sumber data merayapi konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan basis pengetahuan Anda. Amazon Bedrock dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan merayapi konten yang berubah sejak sinkronisasi terakhir. Saat Anda menyinkronkan sumber data dengan basis pengetahuan untuk pertama kalinya, semua konten dirayapi secara default.
Untuk menyinkronkan sumber data Anda dengan basis pengetahuan Anda, gunakan [StartIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StartIngestionJob.html)API atau pilih basis pengetahuan Anda di konsol dan pilih **Sinkronkan** dalam bagian ikhtisar sumber data.
**penting**
Semua data yang Anda sinkronkan dari sumber data Anda akan tersedia bagi siapa saja yang memiliki `bedrock:Retrieve` izin untuk mengambil data. Ini juga dapat mencakup data apa pun dengan izin sumber data terkontrol. Untuk informasi selengkapnya, lihat [Izin basis pengetahuan](https://docs.aws.amazon.com/bedrock/latest/userguide/kb-permissions.html).
### Kredensial otentikasi rahasia
(Jika menggunakan otentikasi dasar) Kredensyal otentikasi rahasia Anda AWS Secrets Manager harus menyertakan pasangan nilai kunci ini:
+ `username`: {{admin user email address of Atlassian account}}
+ `password`: {{Confluence API token}}
(Jika menggunakan otentikasi OAuth 2.0) Kredensyal otentikasi rahasia Anda harus menyertakan pasangan nilai kunci ini: AWS Secrets Manager
+ `confluenceAppKey`: {{app key}}
+ `confluenceAppSecret`: {{app secret}}
+ `confluenceAccessToken`: {{app access token}}
+ `confluenceRefreshToken`: {{app refresh token}}
**catatan**
Token OAuth2.0 **akses** Confluence memiliki waktu kedaluwarsa default 60 menit. Jika token ini kedaluwarsa saat sumber data Anda disinkronkan (pekerjaan sinkronisasi), Amazon Bedrock akan menggunakan token **penyegaran** yang disediakan untuk membuat ulang token ini. Regenerasi ini menyegarkan token akses dan penyegaran. Untuk menjaga token diperbarui dari pekerjaan sinkronisasi saat ini ke pekerjaan sinkronisasi berikutnya, Amazon Bedrock memerlukan write/put izin untuk kredensyal rahasia Anda sebagai bagian dari peran IAM basis pengetahuan Anda.
**catatan**
Rahasia Anda AWS Secrets Manager harus menggunakan Wilayah yang sama dari basis pengetahuan Anda.
------
#### [ Console ]
**Hubungkan instans Confluence ke basis pengetahuan Anda**
1. Ikuti langkah-langkah di [Buat basis pengetahuan dengan menghubungkan ke sumber data di Amazon Bedrock Knowledge Bases](knowledge-base-create.md) dan pilih **Confluence** sebagai sumber data.
1. Berikan nama dan deskripsi opsional untuk sumber data.
1. Berikan URL instans Confluence Anda. Misalnya, untuk Confluence Cloud,. {{https://example.atlassian.net}} URL untuk Confluence Cloud harus berupa URL dasar, diakhiri dengan. {{.atlassian.net}}
1. Di bagian **Pengaturan lanjutan**, Anda dapat secara opsional mengonfigurasi yang berikut:
+ **Kunci KMS untuk penyimpanan data sementara.** — Anda dapat mengenkripsi data sementara sambil mengubah data Anda menjadi embeddings dengan default atau kunci KMS Anda sendiri. Kunci yang dikelola AWS Untuk informasi selengkapnya, lihat [Enkripsi penyimpanan data sementara selama konsumsi data](encryption-kb.md#encryption-kb-ingestion).
+ **Kebijakan penghapusan data** — Anda dapat menghapus embeddings vektor untuk sumber data Anda yang disimpan di penyimpanan vektor secara default, atau memilih untuk menyimpan data penyimpanan vektor.
1. Berikan informasi autentikasi untuk terhubung ke instans Confluence Anda:
+ Untuk otentikasi dasar, buka AWS Secrets Manager untuk menambahkan kredensyal otentikasi rahasia Anda atau gunakan Amazon Resource Name (ARN) yang ada untuk rahasia yang Anda buat. Rahasia Anda harus berisi alamat email pengguna admin akun Atlassian sebagai nama pengguna dan token API Confluence sebagai pengganti kata sandi. Untuk informasi tentang cara membuat token API Confluence, lihat [Mengelola token API untuk akun Atlassian Anda](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token) di situs web Atlassian.
+ Untuk otentikasi OAuth 2.0, buka AWS Secrets Manager untuk menambahkan kredensyal otentikasi rahasia Anda atau gunakan Nama Sumber Daya Amazon (ARN) yang ada untuk rahasia yang Anda buat. Rahasia Anda harus berisi kunci aplikasi Confluence, rahasia aplikasi, token akses, dan token refresh. Untuk informasi selengkapnya, lihat [aplikasi OAuth 2.0](https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/) di situs web Atlassian.
1. (Opsional) Di bagian **Parsing dan chunking konten**, Anda dapat menyesuaikan cara mengurai dan memotong data Anda. Lihat sumber daya berikut untuk mempelajari lebih lanjut tentang penyesuaian ini:
+ Untuk informasi selengkapnya tentang opsi penguraian, lihat[Opsi penguraian untuk sumber data Anda](kb-advanced-parsing.md).
+ Untuk informasi lebih lanjut tentang strategi chunking, lihat. [Bagaimana content chunking bekerja untuk basis pengetahuan](kb-chunking.md)
**Awas**
Anda tidak dapat mengubah strategi chunking setelah terhubung ke sumber data.
+ Untuk informasi selengkapnya tentang cara menyesuaikan potongan data dan pemrosesan metadata Anda dengan fungsi Lambda, lihat. [Gunakan fungsi Lambda transformasi kustom untuk menentukan bagaimana data Anda dicerna](kb-custom-transformation.md)
1. Pilih untuk menggunakan pola filters/regular ekspresi untuk menyertakan atau mengecualikan konten tertentu. Jika tidak, semua konten standar akan dirayapi.
1. Lanjutkan untuk memilih model embeddings dan penyimpanan vektor. Untuk melihat langkah-langkah yang tersisa, kembali ke [Buat basis pengetahuan dengan menghubungkan ke sumber data di Amazon Bedrock Knowledge Bases](knowledge-base-create.md) dan lanjutkan dari langkah setelah menghubungkan sumber data Anda.
------
#### [ API ]
Berikut ini adalah contoh konfigurasi untuk menghubungkan ke Confluence Cloud untuk basis pengetahuan Amazon Bedrock Anda. Anda mengonfigurasi sumber data menggunakan API dengan AWS CLI atau SDK yang didukung, seperti Python. Setelah menelepon [CreateKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateKnowledgeBase.html), Anda menelepon [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html)untuk membuat sumber data dengan informasi koneksi Anda di`dataSourceConfiguration`.
Untuk mempelajari tentang penyesuaian yang dapat Anda terapkan pada konsumsi dengan menyertakan bidang opsional`vectorIngestionConfiguration`, lihat. [Sesuaikan konsumsi untuk sumber data](kb-data-source-customize-ingestion.md)
**AWS Command Line Interface**
```
aws bedrock create-data-source \
--name "Confluence Cloud/SaaS connector" \
--description "Confluence Cloud/SaaS data source connector for Amazon Bedrock to use content in Confluence" \
--knowledge-base-id "your-knowledge-base-id" \
--data-source-configuration file://confluence-bedrock-connector-configuration.json \
--data-deletion-policy "DELETE" \
--vector-ingestion-configuration '{"chunkingConfiguration":[{"chunkingStrategy":"FIXED_SIZE","fixedSizeChunkingConfiguration":[{"maxTokens":"100","overlapPercentage":"10"}]}]}'
confluence-bedrock-connector-configuration.json
{
"confluenceConfiguration": {
"sourceConfiguration": {
"hostUrl": "https://example.atlassian.net",
"hostType": "SAAS",
"authType": "OAUTH2_CLIENT_CREDENTIALS",
"credentialsSecretArn": "arn:aws::secretsmanager:your-region:secret:AmazonBedrock-Confluence"
},
"crawlerConfiguration": {
"filterConfiguration": {
"type": "PATTERN",
"patternObjectFilter": {
"filters": [
{
"objectType": "Attachment",
"inclusionFilters": [
".*\\.pdf"
],
"exclusionFilters": [
".*private.*\\.pdf"
]
}
]
}
}
}
},
"type": "CONFLUENCE"
}
```
------