View a markdown version of this page

Integrasi basis pengetahuan Atlassian Confluence Cloud - Amazon Quick
Sebelum kamu memulaiMengatur integrasi basis pengetahuanJenis konten yang didukungKelola basis pengetahuanPemecahan Masalah

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

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.

Sebelum kamu memulai

Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.

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

Mengatur integrasi basis pengetahuan

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

Otentikasi akun Anda

  1. Di konsol Amazon Quick, pilih Pengetahuan.

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

  3. 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.

  4. 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

  5. (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

  6. Pilih Berikutnya.

  7. 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

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

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

  3. 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).

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

Konfigurasikan pengaturan tambahan

  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, lihatDocument-level kontrol akses.

    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.

  2. 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).

  3. Pilih Buat.

Jenis konten yang didukung

  • 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, lihatUkuran file dan batas konten.

Kelola basis pengetahuan

Edit basis pengetahuan yang ada

  1. Di konsol Amazon Quick, pilih Basis pengetahuan.

  2. Pilih basis pengetahuan Confluence Cloud Anda dari daftar.

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

  4. Perbarui pengaturan konfigurasi Anda sesuai kebutuhan dan pilih Simpan.

Pemecahan Masalah

Untuk mengedit, membagikan, atau menghapus integrasi Anda, lihatMengelola integrasi yang ada.

Untuk pemecahan masalah basis pengetahuan umum, termasuk masalah sinkronisasi dan dokumen yang hilang, lihat. Memecahkan masalah basis pengetahuan

Otorisasi aplikasi OAuth yang diblokir

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.

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

    3. 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 keadmin.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 danteam-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

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.

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

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

Konten yang hilang dalam basis pengetahuan

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.

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

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

  4. 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

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, lihatPeriksa akses dokumen (verifikasi ACL).