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

# 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. Untuk format dan batas ukuran yang didukung, lihat[Ukuran file dan batas konten](knowledge-base-integrations.md#file-size-and-content-limits).
+ **Ukuran file terlalu besar** — Verifikasi file berada dalam batas ukuran. Lihat perinciannya di [Ukuran file dan batas konten](knowledge-base-integrations.md#file-size-and-content-limits).
+ 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** — URL atau pengaturan koneksi sumber data yang 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.
+ **Document-level kesalahan** — 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. Untuk daftar lengkap format dan batasan yang didukung, lihat[Ukuran file dan batas konten](knowledge-base-integrations.md#file-size-and-content-limits).

**Untuk mengatasi masalah format:**

1. Verifikasi file Anda memenuhi persyaratan format dan ukuran.

1. Konversi 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.
+ **SSL/TLS masalah** — Masalah sertifikat dengan koneksi aman.

**Untuk menyelesaikan:**

1. **Verifikasi kredensi otentikasi** — Konfirmasikan bahwa kredensil 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.

## Kesalahan validasi ACL
<a name="acl-validation-errors"></a>

Jika laporan sinkronisasi Anda menampilkan item dengan status **SKIPPED** dan tipe kesalahan **VALIDATION\_ERROR** dengan pesan “File tidak memiliki ACL sementara CrawlaCl benar, melewatkan konsumsi,” pendaftaran aplikasi yang digunakan oleh konektor basis pengetahuan Anda tidak memiliki izin ACL yang diperlukan.

**Untuk menyelesaikan:**

1. Verifikasi bahwa pendaftaran aplikasi memiliki izin API yang benar untuk crawling ACL. Izin yang diperlukan bervariasi menurut konektor. Lihat bagian izin di dokumentasi penyiapan konektor Anda.

1. Konfirmasikan bahwa persetujuan admin telah diberikan untuk semua izin yang diperlukan.

1. Re-run sinkronisasi penuh setelah memperbaiki izin.