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

# Integrasi basis pengetahuan Atlassian Confluence Cloud
<a name="confluence-knowledge-base"></a>

Gunakan integrasi basis pengetahuan Atlassian Confluence Cloud untuk mengindeks konten Confluence sehingga agen Amazon Quick dapat mencari dan menjawab pertanyaan tentangnya. Amazon Quick mendukung kontrol akses tingkat dokumen opsional (ACL) untuk basis pengetahuan Confluence. Saat diaktifkan, pengguna hanya melihat jawaban dari dokumen yang diizinkan untuk diakses di Confluence. Untuk informasi selengkapnya, lihat [Document-level kontrol akses](confluence-kb-acl.md).

## Sebelum kamu memulai
<a name="confluence-kb-prerequisites"></a>

Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Sebuah contoh Atlassian Confluence Cloud.
+ Untuk persyaratan berlangganan Cepat, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).

Jika Anda berencana untuk mengaktifkan kontrol akses tingkat dokumen, Anda harus memberikan kredensyal admin Atlassian selama penyiapan. Kredensyal ini memungkinkan Amazon Quick untuk mengakses semua informasi pengguna dan grup terlepas dari pengaturan visibilitas email individual. Tanpa kredensi admin, opsi ACL tidak tersedia selama pembuatan basis pengetahuan. Untuk memberikan kredensyal admin, Anda memerlukan yang berikut dari administrator organisasi Atlassian Anda:
+ **Kunci API admin Atlassian** — String alfanumerik yang dihasilkan di portal admin Atlassian.
+ **ID Organisasi (UUID)** — Pengidentifikasi unik untuk organisasi Atlassian Anda. Anda dapat menemukan ini di URL browser Anda saat masuk ke portal admin:`admin.atlassian.com/o/{{orgId}}`.
+ **ID Direktori (UUID)** — Pengidentifikasi unik untuk direktori pengguna Anda. Ambil nilai ini menggunakan Atlassian Admin Workspace API.

Untuk langkah-langkah terperinci untuk mendapatkan kredensyal ini, lihat. [Dapatkan kredensi admin Atlassian](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials)

## Mengatur integrasi basis pengetahuan
<a name="confluence-kb-setup"></a>

Wizard pengaturan memiliki tiga langkah: otentikasi, pembuatan basis pengetahuan, dan pengaturan tambahan.

### Otentikasi akun Anda
<a name="confluence-kb-setup-auth"></a>

1. Di konsol Amazon Quick, pilih **Pengetahuan**.

1. Di bawah **Pengetahuan**, pilih **Atlassian Confluence Cloud** dan pilih tombol Tambah (plus “\+”).

1. Dalam dialog **Create Confluence knowledge base**, di bawah **Metode otentikasi**, pilih akun terhubung yang ada dari dropdown **Nama**, atau pilih **Tambah akun** untuk membuat koneksi baru.

1. Jika Anda menambahkan akun baru, lengkapi kolom berikut:
   + **Nama — Nama** deskriptif untuk koneksi Anda.
   + **Deskripsi** (Opsional) — Catatan tentang koneksi.
   + **Confluence URL** — URL situs Atlassian Anda (misalnya,). `https://{{your-site}}.atlassian.net`

1. (Opsional) Di bawah **Manajemen ACL**, pilih **Gunakan kredensyal admin Atlassian untuk memberikan kredensyal admin** Atlassian. Saat dipilih, masukkan yang berikut ini:
   + **Kunci API - Kunci** API admin Atlassian.
   + **OrganizationID (UUID) — ID organisasi Atlassian** Anda.
   + **ID Direktori (UUID)** — ID direktori pengguna Atlassian Anda.
**penting**  
**Kredensyal admin Atlassian diperlukan untuk mengaktifkan kontrol akses tingkat dokumen (ACL) di pengaturan tambahan.** Tanpa kredensi admin, opsi ACL dinonaktifkan. Kredensyal admin tidak dapat ditambahkan setelah basis pengetahuan dibuat. Untuk langkah-langkah untuk mendapatkan kredensyal ini, lihat. [Dapatkan kredensi admin Atlassian](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials)

1. Pilih **Berikutnya**.

1. Selesaikan popup otentikasi Confluence Cloud yang muncul. Tinjau izin yang diminta dan pilih **Terima** untuk mengotorisasi Amazon Quick untuk mengakses konten Confluence Anda.

### Buat basis pengetahuan
<a name="confluence-kb-setup-create"></a>

1. Di bawah **Buat basis pengetahuan**, masukkan **Nama** untuk basis pengetahuan Anda.

1. (Opsional) Masukkan **Deskripsi** dengan catatan tentang bagaimana basis pengetahuan akan digunakan.

1. Di bawah **URL Confluence, rekatkan URL** spasi Confluence, blog, atau halaman yang ingin Anda sertakan. Pilih **Tambah** setelah setiap URL.
**catatan**  
URL yang mengikuti struktur `https://{{company}}.atlassian.net/wiki/spaces/{{space-key}}/overview` diperlakukan sebagai URL halaman, bukan URL spasi. Untuk mengindeks seluruh ruang, gunakan URL spasi tanpa `/overview` (misalnya,`https://{{company}}.atlassian.net/wiki/spaces/{{space-key}}`).

1. Pilih **Berikutnya: Pengaturan tambahan** untuk mengonfigurasi kontrol akses dan opsi pengindeksan, atau pilih **Buat** untuk membuat basis pengetahuan dengan pengaturan default.

### Konfigurasikan pengaturan tambahan
<a name="confluence-kb-setup-settings"></a>

1. Untuk mengaktifkan kontrol akses tingkat dokumen, pilih **Kontrol akses dokumen** dengan ACL. **Opsi ini hanya tersedia jika Anda memberikan kredensyal admin Atlassian dalam metode Otentikasi.** Saat diaktifkan, Amazon Quick menyinkronkan daftar kontrol akses dari Confluence dan memverifikasi izin setiap pengguna pada waktu kueri. Untuk informasi selengkapnya tentang cara kerja kontrol akses, lihat[Document-level kontrol akses](confluence-kb-acl.md).

   Jika Anda tidak mengaktifkan ACL, akses dikontrol pada tingkat basis pengetahuan. Siapa pun yang memiliki akses ke basis pengetahuan bisa mendapatkan wawasan dari semua konten di dalamnya. Ketika ACL diaktifkan, akses dikontrol pada tingkat dokumen. Pengguna yang memiliki akses ke basis pengetahuan hanya melihat jawaban dari dokumen yang diizinkan untuk mereka akses di Confluence.
**penting**  
Manajemen ACL tidak dapat diubah setelah basis pengetahuan dibuat. Jika Anda perlu mengubah pengaturan ini, Anda harus membuat basis pengetahuan baru.
**catatan**  
Jika Anda tidak memberikan kredensyal admin Atlassian dalam **metode Otentikasi**, opsi ini dinonaktifkan. Untuk mengaktifkan ACL, pilih **Kembali** atau batalkan wizard dan mulai lagi dengan akun tersambung yang menyertakan kredensyal admin.

1. Di bawah **Multi-media konten, ukuran file, dan pola file**, konfigurasikan opsi pengindeksan berikut sesuai kebutuhan:
   + **Konten visual dalam dokumen** — Mengindeks konten visual seperti gambar dan bagan yang disematkan dalam dokumen.
   + **File audio** - Indeks lampiran file audio.
   + **File video** - Indeks lampiran file video.
   + **Ukuran file tunggal maksimum - Ukuran** file maksimum untuk lampiran individual (default: 50 MB).

1. Pilih **Buat**.

## Jenis konten yang didukung
<a name="confluence-kb-content-types"></a>
+ Halaman pertemuan dan posting blog
+ Lampiran halaman dan posting blog

Saat Anda menambahkan URL ruang Confluence, Amazon Quick merayapi semua halaman dan posting blog di dalam ruang tersebut. Untuk jenis file lampiran yang didukung dan batas ukuran, lihat[Ukuran file dan batas konten](knowledge-base-integrations.md#file-size-and-content-limits).

## Kelola basis pengetahuan
<a name="confluence-kb-management"></a>

### Edit basis pengetahuan yang ada
<a name="confluence-kb-edit"></a>

1. Di konsol Amazon Quick, pilih **Basis pengetahuan**.

1. Pilih basis pengetahuan Confluence Cloud Anda dari daftar.

1. Pilih ikon tiga titik di bawah **Tindakan**, lalu pilih **Edit basis pengetahuan**.

1. Perbarui pengaturan konfigurasi Anda sesuai kebutuhan dan pilih **Simpan**.

## Pemecahan Masalah
<a name="confluence-kb-troubleshooting"></a>

Untuk mengedit, membagikan, atau menghapus integrasi Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).

Untuk pemecahan masalah basis pengetahuan umum, termasuk masalah sinkronisasi dan dokumen yang hilang, lihat. [Memecahkan masalah basis pengetahuan](troubleshooting-knowledge-bases.md)

### Otorisasi aplikasi OAuth yang diblokir
<a name="confluence-kb-troubleshooting-blocked-oauth"></a>

**Gejala:**
+ Pesan galat: “Admin situs Anda harus mengotorisasi aplikasi ini untuk situs {{instance-name}} .atlassian.net sebelum aplikasi dapat mengakses akun Anda.”
+ Memilih **Terima** dalam dialog persetujuan tidak berpengaruh.

**Penyebab:**

Administrator situs Atlassian Anda telah memblokir aplikasi OAuth yang diinstal pengguna. Saat pengaturan ini diaktifkan, hanya administrator situs atau organisasi yang dapat mengotorisasi aplikasi pihak ketiga yang baru.

**Langkah-langkah resolusi:**

Gunakan salah satu opsi berikut untuk mengatasi masalah ini.
+ **Opsi 1 (Disarankan): Admin mengotorisasi aplikasi secara langsung**

  1. Administrator situs Atlassian menavigasi ke Amazon Quick dan memulai penyiapan basis pengetahuan baru dengan Confluence Cloud.

  1. Karena administrator memiliki izin tingkat situs, layar persetujuan bersih muncul tanpa kesalahan.

  1. Administrator memilih **Terima** untuk menginstal aplikasi.

  Setelah administrator mengotorisasi aplikasi, semua pengguna lain di situs dapat terhubung tanpa masalah.
+ **Opsi 2: Izinkan sementara aplikasi yang diinstal pengguna** — Administrator pergi ke`admin.atlassian.com`, menavigasi ke **Aplikasi, Aplikasi** **Atlassian, lalu memilih tautan untuk aplikasi** pihak ketiga dan Marketplace. Di bawah **Pengaturan**, temukan **Aplikasi yang Diinstal Pengguna** dan alihkan untuk mengizinkan aplikasi pengguna. Setelah pengguna mengotorisasi Amazon Quick, alihkan pengaturan kembali untuk memblokir aplikasi pengguna.

**penting**  
Otorisasi admin berlaku per situs Atlassian, bukan per organisasi. Jika perusahaan Anda memiliki beberapa situs (misalnya, `team-a.atlassian.net` dan`team-b.atlassian.net`), setiap situs memerlukan otorisasi terpisah.

**catatan**  
Sementara aplikasi yang diinstal pengguna tidak diblokir (Opsi 2), setiap pengguna di situs dapat mengotorisasi aplikasi OAuth apa pun. Re-enable blok segera setelah pengguna terhubung.

### Popup otentikasi gagal
<a name="confluence-kb-troubleshooting-auth-popup"></a>

**Gejala:**
+ Popup otentikasi tidak segera muncul atau ditutup.
+ Popup muncul tetapi gagal menyelesaikan aliran OAuth.

**Langkah-langkah resolusi:**

1. Verifikasi bahwa browser Anda mengizinkan popup dari domain konsol Amazon Quick.

1. Pastikan instans Confluence Cloud Anda dapat diakses dari jaringan Anda.

1. Coba gunakan browser lain atau bersihkan cache browser Anda.

### Konten yang hilang dalam basis pengetahuan
<a name="confluence-kb-troubleshooting-missing-content"></a>

**Gejala:**
+ Sinkronisasi basis pengetahuan selesai tetapi konten yang diharapkan tidak diindeks.
+ Hasil pencarian tidak menyertakan konten dari spasi atau halaman tertentu.
+ Hanya satu dokumen yang diindeks untuk seluruh ruang.

**Langkah-langkah resolusi:**

1. Verifikasi bahwa pengguna Confluence Cloud yang diautentikasi memiliki akses ke spasi dan halaman yang Anda pilih selama penyiapan.

1. Periksa apakah jenis konten yang dipilih didukung (halaman, posting blog, dan lampiran).

1. Tinjau pemilihan konten dalam konfigurasi basis pengetahuan Anda untuk mengonfirmasi spasi dan halaman yang benar disertakan.

1. Periksa URL Confluence Anda untuk akhiran. `/overview` URL yang diakhiri dengan `/wiki/spaces/{{space-key}}/overview` diperlakukan sebagai URL halaman tunggal, bukan spasi penuh. Jika Anda bermaksud mengindeks seluruh ruang, gunakan URL spasi tanpa `/overview` (misalnya,`https://{{company}}.atlassian.net/wiki/spaces/{{space-key}}`).

### ACL-related masalah
<a name="confluence-kb-troubleshooting-acl"></a>

**Tidak ada hasil dari ACL-enabled knowledge base**
+ Verifikasi bahwa pengguna akhir telah masuk ke Confluence saat diminta selama kueri pertama mereka. Masuk diperlukan untuk verifikasi izin waktu nyata.
+ Verifikasi bahwa pengguna akhir memiliki akses ke konten Confluence yang relevan dalam instance Confluence mereka.

**Dokumen dilewati selama sinkronisasi**
+ Jika laporan sinkronisasi menampilkan item dengan status SKIPPED, verifikasi bahwa pengguna yang mengautentikasi memiliki akses ke spasi Confluence dan halaman yang disertakan dalam basis pengetahuan.
+ Untuk informasi selengkapnya tentang memverifikasi akses dokumen, lihat[Periksa akses dokumen (verifikasi ACL)](sync-reports-observability.md#sync-reports-acl-verification).