

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

# Basis pengetahuan
<a name="knowledge-base-integrations"></a>

Basis pengetahuan adalah kumpulan dokumen atau konten yang terorganisir dan diindeks dari sumber data yang dioptimalkan untuk pengambilan dan jawaban pertanyaan yang didukung AI generatif. Baik tim Anda menyimpan dokumentasi di Confluence, berkolaborasi SharePoint, atau mengelola file di penyimpanan cloud, Anda dapat membawa semua informasi ini ke dalam satu pengalaman pencarian terpadu dengan membuat basis pengetahuan.

 Integrasi bawaan dapat diatur hanya dengan beberapa klik untuk menyinkronkan data Anda di Quick dan membuatnya mudah untuk memanfaatkan pengetahuan organisasi Anda di Google Drive, Confluence,, S3 OneDrive, dan Web SharePoint Crawler. Baik tim Anda menyimpan dokumentasi di Confluence, berkolaborasi SharePoint, atau mengelola file di penyimpanan cloud, Anda dapat membawa semua informasi ini ke dalam satu pengalaman pencarian terpadu dengan bantuan basis pengetahuan. 

## Cara kerja basis pengetahuan
<a name="how-knowledge-bases-work"></a>

Basis pengetahuan adalah kumpulan dokumen atau konten yang diindeks dari sumber data seperti Google Drive, dioptimalkan untuk pengambilan dan jawaban pertanyaan yang didukung AI generatif. Beberapa basis pengetahuan dapat dibuat dari sumber yang sama, dan semuanya dapat berada dalam Indeks Cepat bersama. Misalnya, jika Anda menyinkronkan dua folder dari Google Drive dan membuat dua basis pengetahuan — satu untuk “Dokumen Kebijakan” untuk menjawab pertanyaan seperti *“Apa kebijakan pengembalian dana kami”* dan satu lagi untuk “Umpan balik pelanggan” untuk menjawab pertanyaan seperti *“Apa keluhan pelanggan umum”* — keduanya dapat menjadi bagian dari indeks yang sama. Cepat membedakan antara mereka menggunakan id basis pengetahuan, sehingga kueri dapat difilter untuk mengambil hanya dokumen yang relevan dari basis pengetahuan yang diinginkan. Hal ini memungkinkan pengguna untuk mengatur, mengamankan, dan mengambil informasi yang relevan dengan domain yang berbeda atau kasus penggunaan, meskipun data yang mendasarinya diindeks bersama-sama.

Basis pengetahuan Anda dapat digunakan secara individual atau dibagikan dengan anggota tim melalui ruang Amazon Quick. Kontrol akses kasar kami memungkinkan keamanan di tingkat basis pengetahuan, memastikan bahwa pengguna hanya menerima informasi dari basis pengetahuan yang diizinkan untuk mereka akses.

### Proses pembuatan
<a name="knowledge-base-creation-process"></a>

Anda dapat membuat basis pengetahuan sambil menyiapkan integrasi akses data baru dan menggunakan integrasi yang ada untuk membuat basis pengetahuan tambahan:

1. **Pengaturan integrasi akses data** - Connect ke sumber data eksternal Anda

1. **Pemilihan konten** - Pilih konten mana yang akan disertakan melalui filter dan pengaturan ruang lingkup

1. **Pengindeksan** - Amazon Cepat memproses dan mengindeks konten yang dipilih

1. **Ketersediaan** - Basis pengetahuan tersedia untuk digunakan di ruang dan oleh agen AI

### Kemampuan
<a name="knowledge-base-capabilities"></a>

Setiap basis pengetahuan menyediakan kemampuan berikut:
+ **Pengindeksan konten** - Memproses teks, dokumen, dan data terstruktur dari sumber eksternal
+ Pencarian **semantik - Mengaktifkan pencarian** bertenaga AI di seluruh konten yang diindeks
+ **Sinkronisasi otomatis** - Menyimpan konten up-to-date dengan jadwal sinkronisasi yang dapat dikonfigurasi
+ **Kontrol akses kasar** - Memastikan bahwa pengguna hanya menerima informasi dari basis pengetahuan yang diizinkan untuk mereka akses.
+ **Penggunaan multi-ruang** - Dapat digunakan di beberapa ruang dan oleh agen AI yang berbeda

## Alur kerja umum
<a name="general-workflow"></a>

Alur kerja khas untuk bekerja dengan basis pengetahuan mengikuti langkah-langkah ini:

1. **Siapkan integrasi sumber data** - Sambungkan ke aplikasi eksternal Anda (seperti SharePoint, Google Drive, atau Confluence) dengan autentikasi yang sesuai. Untuk informasi selengkapnya, lihat [Panduan khusus integrasi](integration-guides.md).

1. **Buat basis pengetahuan** - Anda dapat membuat basis pengetahuan sambil mengonfigurasi integrasi baru Anda. Konfigurasikan filter konten Anda dengan menyiapkan filter, pembatasan jenis file, dan pilihan folder untuk fokus pada konten yang relevan.

1. **Atur jadwal sinkronisasi** - Frekuensi penyegaran data diatur ke harian secara default. Anda dapat mengedit frekuensi sinkronisasi untuk mengonfigurasi seberapa sering basis pengetahuan harus diperbarui dengan konten baru dari sumbernya.

1. **Pantau dan kelola** - Tinjau status sinkronisasi, kelola izin akses.

## Pengaturan konfigurasi umum
<a name="common-configuration-settings"></a>

Basis pengetahuan berbagi pola konfigurasi umum di berbagai integrasi sumber data. Memahami setelan ini membantu Anda mengoptimalkan pengindeksan konten dan mengelola perilaku sinkronisasi secara efektif.

**catatan**  
Meskipun opsi konfigurasi ini tersedia di sebagian besar integrasi, pengaturan spesifik dan opsi yang tersedia dapat bervariasi tergantung pada integrasi sumber data yang Anda pilih.

### Ukuran file dan batas konten
<a name="file-size-and-content-limits"></a>

Konfigurasikan batas ukuran file untuk mengoptimalkan kinerja pemrosesan dan mengelola biaya penyimpanan. Batas spesifik bervariasi menurut jenis konten dan ditampilkan di konsol saat Anda mengonfigurasi basis pengetahuan Anda.

**Dokumen teks standar**  
Berlaku untuk dokumen seperti PDFs, file Word, dan file teks. Batas ukuran file adalah 500 MB.

**File video**  
Tersedia saat pemrosesan video diaktifkan. Format yang didukung meliputi`.mp4`,`.mov`,`.m4v`. Batas ukuran file adalah 10 GB (10240 MB). Indeks Cepat mendukung hingga **10 file video per GB penyimpanan**. Jika kasus penggunaan Anda memerlukan volume video yang lebih tinggi, silakan buka tiket dengan AWS dukungan untuk memperpanjang batas ini.

**File audio**  
Tersedia saat pemrosesan audio diaktifkan. Format yang didukung meliputi`.mp3`,` .wav`,` .m4a`,`.flac`, dan` .ogg`. Batas adalah 2 GB (2048 MB) untuk file audio.  
File dengan teks yang diekstraksi yang melebihi batas sistem 30 MB tidak diindeks, terlepas dari ukuran file aslinya. Jumlah maksimum teks yang dapat diekstraksi dari satu dokumen adalah 30 MB.

**Gambar**  
Indeks Cepat menerapkan batasan berikut untuk gambar:  
+ **Batas per dokumen**: 500 gambar per dokumen
+ **Batas per GB**: 10K gambar per GB penyimpanan indeks
+ **Batas per indeks**: 2 juta gambar per indeks
Jika kasus penggunaan Anda memerlukan volume gambar yang lebih tinggi, silakan buka tiket dengan AWS dukungan untuk memperpanjang batas ini.

### Sinkronkan jadwal dan pengamanan
<a name="sync-schedule-and-safeguards"></a>

Konfigurasikan seberapa sering basis pengetahuan Anda diperbarui dan lindungi dari penghapusan konten yang tidak diinginkan:

#### Frekuensi sinkronisasi
<a name="sync-frequency"></a>

Frekuensi penyegaran data diatur ke harian secara default. Anda dapat mengedit frekuensi sinkronisasi untuk mengonfigurasi seberapa sering basis pengetahuan harus diperbarui dengan konten baru dari sumbernya

#### Perlindungan dari Penghapusan Dokumen
<a name="document-deletion-safeguard"></a>

Lindungi konten Anda yang diindeks dari penghapusan massal yang tidak disengaja dengan menetapkan ambang batas persentase penghapusan maksimum. Jika pekerjaan sinkronisasi akan menghapus lebih banyak dokumen daripada yang diizinkan oleh ambang batas Anda, fase penghapusan dilewati, mempertahankan konten terindeks yang ada.

Perlindungan ini melindungi dari masalah jaringan sementara, perubahan izin, atau masalah sistem sumber yang mungkin membuat konten sementara tidak tersedia.

# Praktik terbaik untuk mengelola ACLs basis pengetahuan
<a name="acl-best-practices-kb"></a>

Saat menggunakan basis pengetahuan dengan daftar kontrol akses (ACLs), Anda bertanggung jawab untuk menjaga identitas dan izin pengguna tetap akurat. Ini memastikan orang yang tepat dapat mengakses dokumen yang tepat. Cepat secara otomatis menyinkronkan identitas dan perubahan ACL tingkat dokumen setiap 24 jam secara default. Setiap pembaruan untuk pengguna atau izin akan memakan waktu hingga satu hari untuk muncul di sistem kecuali Anda telah mengonfigurasi jadwal penyegaran yang berbeda untuk basis pengetahuan Anda.

Untuk informasi selengkapnya tentang mengonfigurasi ACLs sumber data tertentu, lihat[Integrasi Amazon S3](s3-integration.md).

**catatan**  
Cepat memperlakukan semua alamat email sebagai case-insensitive. `JohnDoe@example.com`,`johndoe@example.com`, dan `JOHNDOE@example.com` semuanya dianggap pengguna yang sama.

## Skenario manajemen pengguna yang penting
<a name="acl-user-management-scenarios"></a>

**Memahami pengikatan email**

Alamat email terikat ke pengguna Cepat secara dinamis saat pengguna memulai interaksi obrolan. Pengikatan ini mengikuti first-come-first-serve pendekatan. Pengguna pertama yang mengobrol dengan alamat email tertentu menetapkan pengikatan untuk identitas tersebut di dalam namespace.

**Ketika seorang karyawan meninggalkan organisasi Anda**

Ketika seorang karyawan pergi, segera bersihkan aksesnya:

1. Perbarui file konfigurasi ACL untuk menghapus referensi ke alamat email mereka. Misalnya, di Amazon S3, perbarui file ACL global atau file metadata.

1. Segarkan kembali basis pengetahuan untuk menerapkan perubahan.

Ini mencegah potensi masalah keamanan jika email kemudian dipindahkan ke orang lain.

**Ketika alamat email dipindahkan ke karyawan baru**
+ Akses basis pengetahuan ACL terkunci secara otomatis untuk alamat email yang ditetapkan ulang untuk melindungi keamanan data.
+ Hubungi dukungan Cepat untuk membersihkan akses pengguna sebelumnya sebelum karyawan baru dapat mengakses dokumen yang terkait dengan email tersebut.

## Batasan
<a name="acl-limitations"></a>

Saat mengonfigurasi tingkat dokumen ACLs untuk basis pengetahuan Anda, perhatikan batasan ini:
+ **Konfigurasi ACL tingkat dokumen bersifat permanen** — Anda tidak dapat mengaktifkan basis pengetahuan yang dibuat ACLs tanpa dukungan ACL. Anda juga tidak dapat menonaktifkan ACLs setelah diaktifkan. Untuk mengubah konfigurasi ACL, buat basis pengetahuan baru dengan pengaturan yang Anda inginkan sejak awal.
+ **Alamat email bersama dalam namespace** — Jika beberapa pengguna Quick berbagi alamat email yang sama dalam namespace, sistem menolak akses ke semua orang yang menggunakan email bersama tersebut. Perlindungan ini mencegah pemberian akses dokumen secara tidak sengaja ke orang yang salah.
+ **Cakupan resolusi ACL** — ACLs Semua diselesaikan dalam namespace Cepat pembuat basis pengetahuan. Ini berlaku ACLs apakah ditentukan oleh alamat email atau nama grup. Cepat mencari identitas dalam konteks organisasi pencipta untuk memastikan resolusi identitas yang konsisten.
+ **Waktu daur ulang alamat email** — Jika organisasi Anda menetapkan kembali alamat email dari satu karyawan ke karyawan lain, ada pertimbangan waktu yang penting. Jika karyawan sebelumnya tidak pernah menggunakan Quick untuk obrolan atau interaksi AI, dan email dipindahkan sebelum penyegaran ACL berikutnya, karyawan baru dapat mengakses sementara dokumen yang ditujukan untuk karyawan sebelumnya.

  Untuk menghindari hal ini, selesaikan langkah-langkah berikut secara berurutan:

  1. Perbarui ACLs (jika berlaku, seperti di Amazon S3) untuk menghapus pengguna lama dan menambahkan pengguna baru.

  1. Segarkan basis pengetahuan Anda secara manual, atau tunggu penyegaran harian otomatis.

  1. Tetapkan alamat email ke karyawan baru.

  Ini memastikan izin akses disinkronkan dengan benar sebelum pengguna baru mulai menggunakan Quick.
+ **Kompatibilitas penelitian** — Basis pengetahuan dengan tingkat dokumen ACLs diaktifkan saat ini tidak kompatibel dengan Quick Research. Jika Anda perlu menggunakan dokumen dari basis pengetahuan ACL yang mendukung untuk tujuan penelitian, buat basis pengetahuan terpisah tanpa ACLs dokumen tersebut.

# Memecahkan masalah basis pengetahuan
<a name="troubleshooting-knowledge-bases"></a>

Ketika Anda mengalami masalah dengan basis pengetahuan Cepat Anda, Anda dapat menggunakan panduan pemecahan masalah ini untuk mengidentifikasi dan menyelesaikan masalah umum. Masalah basis pengetahuan biasanya melibatkan sinkronisasi dokumen, kegagalan pekerjaan refresh, atau izin akses.

## Dokumen tidak muncul di basis pengetahuan Anda
<a name="documents-not-appearing"></a>

Ketika dokumen yang Anda harapkan tidak muncul di basis pengetahuan Anda, beberapa faktor dapat menyebabkan masalah ini.

**Penyebab umum:**
+ **Sinkronisasi sedang berlangsung** — Dokumen mungkin masih diproses. Periksa status penyegaran untuk mengonfirmasi penyegaran selesai.
+ **Format file yang tidak didukung** - Verifikasi dokumen Anda dalam format yang didukung: Word, Excel,, PDF, PowerPoint CSV, TXT, RTF, JSON, XML, HTML
+ **Ukuran file terlalu besar** - Setiap file harus kurang dari 50 MB.
+ Izin **akses tidak memadai** — Konfirmasikan basis pengetahuan memiliki izin yang tepat untuk mengakses sumber dokumen.
+ **Pemfilteran dokumen** — Periksa apakah filter atau aturan pengecualian mencegah dokumen tertentu diindeks.

**Untuk memecahkan masalah:**

1. Tinjau riwayat penyegaran untuk pesan galat yang terkait dengan dokumen tertentu yang gagal disinkronkan.

1. Verifikasi format dokumen dan ukuran file Anda memenuhi persyaratan.

1. Periksa izin akses dan pengaturan koneksi Anda.

## Segarkan pekerjaan gagal
<a name="refresh-job-fails"></a>

Pekerjaan penyegaran biasanya gagal ketika ada kesalahan konfigurasi di basis pengetahuan atau koneksi sumber data.

**Penyebab umum:**
+ **Masalah izin** - Integrasi tidak memiliki izin yang cukup untuk mengakses sumber data.
+ **Kesalahan konfigurasi** - Pengaturan koneksi sumber data URLs atau salah.
+ **Keterbatasan sumber daya** — Pembatasan tarif dari sistem sumber.

**Untuk menyelesaikan:**

1. Periksa detail riwayat penyegaran untuk pesan kesalahan tertentu.

1. Verifikasi semua pengaturan koneksi dan izin dikonfigurasi dengan benar.

1. Ambil tindakan yang disarankan berdasarkan pesan kesalahan.

## Segarkan pekerjaan selesai dengan masalah
<a name="refresh-job-completes-with-issues"></a>

Ketika pekerjaan penyegaran selesai dengan masalah, pekerjaan diproses dengan sukses tetapi mengalami masalah dengan beberapa dokumen.

**Apa artinya ini:**
+ **Keberhasilan sebagian** — Beberapa dokumen berhasil disinkronkan sementara yang lain gagal.
+ **Kesalahan tingkat dokumen —** File individu mungkin memiliki masalah pemformatan, korupsi, atau masalah akses.
+ Masalah **metadata — Masalah** dengan metadata dokumen atau informasi terkait.
+ **Pelanggaran ukuran atau format** — Beberapa file mungkin melebihi batas ukuran atau dalam format yang tidak didukung.

**Untuk menyelesaikan:**

1. Tinjau laporan penyegaran terperinci untuk mengidentifikasi dokumen mana yang mengalami masalah.

1. Mengatasi masalah dokumen individu.

1. Jalankan penyegaran lain setelah menyelesaikan masalah.

## Segarkan pekerjaan berhasil tetapi tidak ada dokumen yang muncul
<a name="refresh-job-succeeds-no-documents"></a>

Jika pekerjaan penyegaran menunjukkan keberhasilan tetapi tidak ada dokumen yang muncul di basis pengetahuan Anda, periksa penyebab potensial ini.

**Penyebab umum:**
+ **Sumber kosong** — Lokasi sumber data yang dikonfigurasi tidak berisi dokumen.
+ **Konfigurasi jalur salah** - Jalur sumber atau pengaturan koneksi tidak mengarah ke lokasi yang benar.
+ **Filter dokumen** — Kriteria inklusi atau pengecualian mungkin menyaring semua dokumen.
+ **Izin baca hilang** — Pekerjaan berhasil terhubung tetapi tidak memiliki izin untuk membaca dokumen yang sebenarnya.

**Untuk menyelesaikan:**

1. Verifikasi titik konfigurasi sumber data Anda ke lokasi yang benar.

1. Konfirmasikan dokumen ada di lokasi yang ditentukan.

1. Periksa apakah izin akses yang sesuai dikonfigurasi.

1. Tinjau filter dokumen apa pun yang mungkin mengecualikan konten.

## Masalah format file selama penyegaran
<a name="file-format-issues"></a>

Basis pengetahuan cepat mendukung format file tertentu. File harus memenuhi persyaratan format, ukuran, dan batas karakter.

**Persyaratan:**
+ **Format yang didukung:** Word, Excel,, PDF PowerPoint, CSV, TXT, RTF, JSON, XML, HTML
+ **Batas ukuran file:** 50 MB per file
+ **Kondisi file:** Tidak rusak atau dilindungi kata sandi

**Untuk mengatasi masalah format:**

1. Verifikasi file Anda memenuhi persyaratan format dan ukuran.

1. Konversikan format yang tidak didukung ke format yang didukung.

1. Hapus perlindungan kata sandi dari file.

1. Periksa apakah file tidak rusak.

## Akses kesalahan ditolak
<a name="access-denied-errors"></a>

Kesalahan akses ditolak biasanya terjadi karena masalah otentikasi atau otorisasi.

**Penyebab umum:**
+ **Kredensyal tidak valid** — Token atau kata sandi otentikasi mungkin telah kedaluwarsa.
+ **Izin tidak memadai** — Akun yang digunakan dalam integrasi tidak memiliki akses baca ke sumber data.
+ **Pembatasan jaringan** — Firewall atau kebijakan keamanan memblokir akses.
+ Masalah **SSL/TLS — Masalah** sertifikat dengan koneksi aman.

**Untuk menyelesaikan:**

1. **Verifikasi kredensyal otentikasi** — Konfirmasikan bahwa kredensyal otentikasi terkini dan valid. Edit integrasi untuk mengautentikasi ulang dan menghasilkan token baru.

1. **Untuk sumber data crawler web** — Verifikasi bahwa koneksi aman dikonfigurasi dengan benar dan sertifikat SSL dikonfigurasi dan dipercaya dengan benar.

1. **Hubungi administrator sistem Anda** — Jika Anda terus mengalami masalah akses, hubungi administrator sistem Anda. Mereka mungkin perlu menyesuaikan izin atau pengaturan keamanan.