Kembali ke blog
Panduan

Cara menulis basis pengetahuan yang benar-benar bisa dipakai AI Anda

Lima aturan praktis untuk merestrukturisasi dokumentasi agar AI yang mengutamakan penalaran menghasilkan jawaban yang presisi dan berkualitas tinggi — plus cara mengukur apakah basis pengetahuan Anda benar-benar bekerja.

Respondo Team19 Mei 20269 menit baca

Poin utama

  • Kualitas dukungan pelanggan AI sebagian besar adalah kualitas basis pengetahuan — dokumentasi yang Anda berikan ke AI adalah tuas tunggal terbesar yang Anda kendalikan, lebih dari model atau arsitektur.
  • Ikuti lima aturan: satu topik per artikel, judul bergaya pertanyaan, instruksi langkah-demi-langkah yang spesifik, blok konteks di bagian atas, dan metadata yang terkini.
  • Dokumentasi yang dioptimalkan untuk manusia mengasumsikan seseorang menjelajah dan memindai; dokumentasi yang dioptimalkan untuk AI memetakan tiap artikel dengan rapi ke satu pertanyaan spesifik sehingga retrieval semantik tetap presisi.
  • Anda tidak harus menulis ulang semuanya sekaligus — mulai dari 20 kategori pertanyaan teratas yang mencakup ~80% volume tiket, terapkan, lalu gunakan pola eskalasi AI untuk menemukan dan mengisi celah.
  • Tim yang mengikuti lima aturan ini mendapat penyelesaian otomatis 60–70%; ukur keberhasilan dengan tingkat penyelesaian otomatis, alasan eskalasi, tingkat tindak lanjut, dan CSAT pada tiket yang ditangani AI.

Penentu tunggal terbesar kualitas dukungan pelanggan AI bukanlah model AI-nya. Melainkan basis pengetahuan yang dibaca AI. Tim menerapkan dukungan AI, mendapat hasil biasa-biasa saja, dan menyalahkan AI — padahal masalah sebenarnya adalah mereka memberinya dokumentasi yang ditulis untuk manusia yang menjelajah pusat bantuan, bukan untuk AI yang menjawab pertanyaan spesifik.

Tulisan ini tentang menulis basis pengetahuan yang menghasilkan jawaban AI yang benar-benar bagus. Ia relevan baik saat Anda menerapkan dukungan AI untuk pertama kali maupun saat berusaha meningkatkan kualitas sistem AI yang sudah Anda miliki. Ditulis untuk pemimpin dukungan dan founder yang memegang basis pengetahuan, tidak harus untuk technical writer.

Mengapa yang dioptimalkan untuk manusia dan untuk AI berbeda

Basis pengetahuan yang ditulis untuk manusia mengasumsikan seseorang menjelajah, memindai judul, melompat-lompat, menggunakan pertimbangan untuk menemukan bagian relevan dari artikel yang panjang. Manusia pandai dalam hal ini. Mereka menoleransi artikel 2.000 kata berjudul "Mengelola Akun Anda" karena mereka bisa memindai ke bagian yang mereka butuhkan.

AI membaca dengan cara berbeda. Ia melakukan retrieval semantik — mencocokkan pertanyaan pelanggan dengan konten untuk menemukan bagian paling relevan, lalu menyusun jawaban darinya. Artikel panjang yang mencakup 15 sub-topik lebih buruk untuk ini daripada 15 artikel yang terfokus, karena retrieval-nya kurang presisi dan AI mungkin menarik bagian yang salah atau memadukan bagian secara keliru.

Pergeseran pola pikirnya: berhenti menulis artikel untuk seseorang yang menjelajah, mulai menulis artikel untuk sebuah pertanyaan yang sedang dijawab. Tiap potong konten harus terpetakan dengan rapi ke pertanyaan spesifik yang mungkin diajukan pelanggan.

Aturan 1: Satu topik per artikel

Aturan terpenting. Jangan menulis "Cara mengelola akun Anda" yang mencakup ganti email, reset password, pembaruan tagihan, dan perubahan langganan. Tulis artikel terpisah yang terfokus: "Cara mengganti email Anda", "Cara mereset password Anda", "Cara memperbarui detail tagihan Anda", "Cara mengganti paket langganan Anda".

Mengapa ini penting bagi AI: retrieval semantik bekerja berdasarkan kemiripan antara pertanyaan dan konten. Artikel yang terfokus soal reset password cocok dengan pertanyaan reset-password secara presisi. Artikel pengelolaan-akun yang melebar cocok dengannya secara lemah, terencerkan oleh semua konten lain yang dikandungnya.

Uji praktisnya: kalau sebuah artikel bisa menjawab lebih dari satu pertanyaan pelanggan yang berbeda, ia sebaiknya dipecah.

Aturan 2: Beri judul tiap artikel sebagai pertanyaan yang sungguh diajukan pengguna

Pelanggan tidak mencari "Pengaturan autentikasi dua faktor". Mereka bertanya "Bagaimana cara mengaktifkan autentikasi dua faktor?" atau "Bagaimana cara membuat akun saya lebih aman?"

Beri judul artikel Anda sebagai pertanyaan, dirumuskan sebagaimana pelanggan merumuskannya. Ini secara dramatis meningkatkan retrieval karena AI mencocokkan pertanyaan pelanggan dengan judul-judul Anda. Semakin dekat judul Anda dengan cara pelanggan sungguh bertanya, semakin baik kecocokannya.

Uji praktisnya: bacakan judul artikel Anda dengan lantang. Apakah kedengarannya seperti hal yang akan diketik atau diucapkan pelanggan? Atau kedengarannya seperti nama fitur internal? Nama fitur perlu diubah menjadi pertanyaan.

Aturan 3: Instruksi spesifik ketimbang yang generik

Bandingkan dua versi dari instruksi yang sama:

Generik: "Buka pengaturan keamanan Anda dan aktifkan fiturnya."

Spesifik: "Klik ikon profil Anda di kanan atas, pilih Settings, lalu Security, lalu alihkan Two-Factor Authentication ke On."

AI menyalin tingkat kespesifikan dalam basis pengetahuan Anda. Kalau dokumentasi Anda kabur, jawaban AI kabur. Kalau dokumentasi Anda memberi langkah yang persis, AI memberi langkah yang persis. Pelanggan bisa mengikuti instruksi spesifik; mereka tersangkut pada yang generik.

Uji praktisnya: bisakah seseorang yang sama sekali tak mengenal produk Anda mengikuti instruksi itu tanpa tersangkut? Kalau tidak, ia terlalu generik.

Aturan 4: Tambahkan blok konteks di bagian atas

Sebagian besar fitur produk punya syarat — berlaku untuk paket tertentu, wilayah tertentu, jenis akun tertentu, atau membutuhkan izin tertentu. AI perlu mengetahui syarat-syarat ini untuk memberi jawaban yang benar dan terfilter.

Mulai tiap artikel dengan blok konteks ringkas: "Ini berlaku untuk paket Pro dan Enterprise." "Hanya tersedia di UE." "Membutuhkan izin admin." "Hanya berlaku untuk akun yang dibuat setelah Januari 2025."

Mengapa ini penting: tanpa konteks, AI mungkin memberitahu pelanggan paket Starter cara memakai fitur Pro, menciptakan frustrasi saat mereka tak bisa menemukannya. Dengan konteks, AI bisa berkata "Fitur itu tersedia di paket Pro — begini cara upgrade, atau ini padanannya di paket Anda saat ini."

Uji praktisnya: untuk tiap artikel, tanyakan "apakah ini benar untuk setiap pelanggan, atau hanya sebagian?" Kalau hanya sebagian, syarat-syaratnya sepatutnya masuk ke blok konteks.

Aturan 5: Jaga metadata tetap terkini

Tiap artikel harus membawa metadata: kapan terakhir diperbarui, berlaku untuk paket mana, berkaitan dengan fitur mana. AI memakai ini untuk memprioritaskan konten yang terkini dan relevan ketimbang konten yang usang.

Ini paling penting untuk produk yang berubah. Sebuah fitur didesain ulang, artikel lama menjelaskan alur lama, dan tanpa metadata terakhir-diperbarui AI tak bisa membedakan versi mana yang terkini. Pelanggan mendapat instruksi untuk UI yang sudah tidak ada.

Uji praktisnya: kalau Anda mengubah sebuah fitur enam bulan lalu, apakah basis pengetahuan Anda masih menjelaskan versi lamanya di suatu tempat? Konten usang secara aktif merusak kualitas AI karena AI dengan percaya diri memberi jawaban yang salah.

Aturan bonus: hindari mengandalkan screenshot untuk langkah kritis

AI membaca teks jauh lebih baik daripada membaca gambar. Kalau instruksi kritis hanya berada di dalam screenshot — "klik tombol yang ditunjukkan di sini" — AI tak bisa menyampaikannya dengan andal.

Jelaskan langkah kritis dalam teks, lalu gunakan screenshot untuk konfirmasi visual. "Klik tombol Save biru di bagian bawah formulir" plus screenshot jauh lebih berguna bagi AI daripada screenshot saja dengan panah yang menunjuk ke tombol itu.

Ini bukan berarti menghapus screenshot. Ini berarti tidak bergantung padanya untuk informasi yang perlu diekstrak AI.

Seperti apa ini dalam praktik

Ambil artikel basis pengetahuan yang khas berantakan:

"Pengelolaan Akun — Di bagian ini Anda akan belajar tentang mengelola berbagai aspek akun Anda termasuk informasi profil, pengaturan keamanan, tagihan dan metode pembayaran, pengelolaan langganan, dan preferensi notifikasi. Untuk memulai, buka area akun Anda tempat Anda akan menemukan semua opsi ini..."

Ini buruk untuk AI: satu artikel mencakup lima topik yang berbeda, judul generik, instruksi kabur, tanpa blok konteks, tanpa kespesifikan.

Versi ramah-AI-nya adalah lima artikel:

  1. "Bagaimana cara memperbarui informasi profil saya?" — konteks: semua paket; langkah spesifik; terkini per [tanggal]
  2. "Bagaimana cara mengubah pengaturan keamanan saya?" — konteks: semua paket; langkah spesifik; terkini per [tanggal]
  3. "Bagaimana cara memperbarui metode pembayaran saya?" — konteks: paket berbayar saja; langkah spesifik; terkini per [tanggal]
  4. "Bagaimana cara mengganti paket langganan saya?" — konteks: semua paket; langkah spesifik termasuk perilaku upgrade/downgrade; terkini per [tanggal]
  5. "Bagaimana cara mengelola preferensi notifikasi saya?" — konteks: semua paket; langkah spesifik; terkini per [tanggal]

Informasi yang sama, direstrukturisasi. Versi pertama menghasilkan jawaban AI yang biasa-biasa saja. Yang kedua menghasilkan jawaban yang presisi.

Seberapa banyak kerja ini, sebenarnya?

Jawaban jujurnya: lebih sedikit daripada yang ditakutkan tim, lebih banyak daripada yang mereka harapkan.

Untuk SaaS khas dengan 50–100 artikel bantuan, merestrukturisasi ke format ramah-AI adalah proyek satu hingga dua minggu untuk satu orang. Ini bukan pekerjaan yang glamor, tetapi ini investasi berdaya-ungkit tertinggi yang bisa Anda lakukan pada kualitas dukungan AI.

Kabar baiknya: Anda tidak harus melakukannya semua sekaligus. Pendekatan yang masuk akal:

  1. Mulai dari 20 kategori pertanyaan teratas Anda (ini mencakup ~80% volume tiket)
  2. Tulis atau tulis ulang 20 itu sebagai artikel ramah-AI
  3. Terapkan dukungan AI dengan fondasi itu
  4. Gunakan pola eskalasi AI untuk mengidentifikasi celah — saat AI mengeskalasi karena tak punya jawaban, itu sinyal untuk menambah atau memperbaiki sebuah artikel
  5. Iterasi selama minggu-minggu berikutnya

Pendekatan bertahap ini memberi Anda sistem dukungan AI yang berfungsi dengan cepat, lalu memperbaikinya berdasarkan data nyata tentang apa yang sungguh ditanyakan pelanggan.

Cara mengukur apakah basis pengetahuan Anda bekerja

Setelah penerapan, metrik yang memberi tahu Anda apakah basis pengetahuan Anda cukup baik:

Tingkat penyelesaian otomatis AI. Kalau di bawah 50%, basis pengetahuan Anda kemungkinan punya celah. Basis pengetahuan yang baik mendukung penyelesaian otomatis 60–70%.

Alasan eskalasi. Saat AI mengeskalasi, kenapa? "Tidak ditemukan artikel yang relevan" berarti celah konten. "Beberapa artikel yang saling bertentangan" berarti masalah struktur (kemungkinan perlu dipecah atau digabung).

Tingkat tindak lanjut pelanggan. Kalau pelanggan sering menulis balik setelah jawaban AI, jawabannya tidak lengkap. Sering kali masalah kespesifikan — jawabannya benar arahnya tetapi kurang detail untuk benar-benar menyelesaikan masalah.

CSAT pada tiket yang ditangani AI. Kalau tiket yang ditangani AI punya CSAT lebih rendah daripada yang ditangani manusia, kualitas basis pengetahuan adalah penyebab yang lazim.

Metrik-metrik ini mengubah perbaikan basis pengetahuan dari tebak-tebakan menjadi umpan balik yang berulang. AI memberi tahu Anda di mana celahnya; Anda mengisinya; kualitas membaik.

Intinya

Kualitas dukungan pelanggan AI sebagian besar adalah kualitas basis pengetahuan. Model penting, arsitektur penting, tetapi tuas tunggal terbesar yang Anda kendalikan adalah dokumentasi yang Anda berikan ke AI.

Lima aturan itu — satu topik per artikel, judul bergaya pertanyaan, instruksi spesifik, blok konteks, metadata terkini — sederhana untuk dinyatakan dan berdampak tinggi untuk diterapkan. Tim yang mengikutinya mendapat penyelesaian otomatis 60–70%. Tim yang menempelkan dokumentasi lama berorientasi-manusia dan mengharapkan keajaiban mendapat hasil biasa-biasa saja dan menyalahkan AI.

Basis pengetahuan adalah bagian dari dukungan AI yang sepenuhnya Anda kendalikan. Ia layak diinvestasikan.

Di mana Respondo berperan

Integrasi basis pengetahuan Respondo meng-crawl otomatis dokumentasi yang sudah Anda miliki sebagai titik awal, lalu menyoroti peluang untuk merestrukturisasi demi performa AI yang lebih baik. AI yang mengutamakan penalaran memanfaatkan sepenuhnya konten yang terstruktur baik — ia memahami konteks dan menyusun jawaban spesifik alih-alih sekadar mengambil artikel terdekat.

Dashboard menampilkan metrik yang memberi tahu Anda apakah basis pengetahuan Anda bekerja: tingkat penyelesaian otomatis, alasan eskalasi, tingkat tindak lanjut. Ini mengubah perbaikan basis pengetahuan menjadi umpan balik berbasis data alih-alih tebak-tebakan.

Uji coba 14 hari memberi Anda waktu untuk menghubungkan basis pengetahuan Anda, melihat kualitas AI awal, dan mengidentifikasi di mana restrukturisasi paling membantu.

Ingin melihat seberapa baik AI menangani dokumentasi Anda saat ini? Mulai uji coba gratis 14 hari Anda — hubungkan basis pengetahuan Anda dan lihat tingkat penyelesaian otomatis pada tiket asli Anda.

Bagikan artikel ini

Pertanyaan yang sering diajukan

Restrukturisasi dokumentasi Anda di sekitar pertanyaan spesifik alih-alih untuk seseorang yang menjelajah pusat bantuan. Artikel ini merekomendasikan lima aturan: satu topik per artikel, judul yang dirumuskan sebagai pertanyaan yang sungguh diajukan pelanggan, instruksi langkah-demi-langkah yang spesifik alih-alih yang generik, blok konteks di bagian atas yang menyatakan syarat seperti paket atau wilayah, dan metadata terkini seperti tanggal terakhir-diperbarui. Ini membuat retrieval semantik presisi sehingga AI menyusun jawaban yang akurat dan detail.

Penyebab paling umum bukan model AI-nya — melainkan basis pengetahuan yang dibacanya. Tim sering memberi AI dokumentasi yang ditulis untuk manusia yang menjelajah pusat bantuan alih-alih untuk AI yang menjawab pertanyaan spesifik. Artikel panjang yang mencakup banyak sub-topik mengencerkan retrieval, dan dokumentasi yang kabur menghasilkan jawaban yang kabur karena AI menyalin tingkat kespesifikan dalam konten Anda. Konten usang juga merusak, karena AI dengan percaya diri memberi instruksi untuk fitur yang sejak itu telah berubah.

Satu topik per artikel adalah aturan terpenting. Satu artikel yang mencakup ganti email, reset password, tagihan, dan langganan cocok dengan satu pertanyaan mana pun secara lemah karena terencerkan oleh semua konten lain. Memecahnya menjadi artikel terfokus seperti "Bagaimana cara mereset password saya?" membuat retrieval semantik mencocokkan tiap pertanyaan secara presisi. Uji praktisnya: kalau sebuah artikel bisa menjawab lebih dari satu pertanyaan pelanggan yang berbeda, ia sebaiknya dipecah.

Basis pengetahuan yang terstruktur baik mendukung sekitar 60–70% penyelesaian otomatis AI. Kalau tingkat penyelesaian otomatis Anda di bawah 50%, basis pengetahuan Anda kemungkinan punya celah. Artikel ini memperlakukan tingkat penyelesaian otomatis sebagai sinyal utama apakah dokumentasi Anda cukup baik setelah penerapan.

Lacak empat metrik setelah penerapan: tingkat penyelesaian otomatis AI (di bawah 50% menandakan celah, 60–70% bagus), alasan eskalasi ("tidak ditemukan artikel yang relevan" berarti celah konten, "beberapa artikel yang saling bertentangan" berarti masalah struktur), tingkat tindak lanjut pelanggan (sering menulis balik biasanya berarti jawaban kurang spesifik), dan CSAT pada tiket yang ditangani AI versus yang ditangani manusia. Metrik-metrik ini mengubah perbaikan basis pengetahuan menjadi umpan balik berulang di mana AI menunjukkan di mana celahnya sehingga Anda bisa mengisinya.

Untuk SaaS khas dengan 50–100 artikel bantuan, merestrukturisasi ke format ramah-AI adalah proyek satu hingga dua minggu untuk satu orang. Anda tidak harus melakukannya semua sekaligus: mulai dari 20 kategori pertanyaan teratas Anda yang mencakup sekitar 80% volume tiket, tulis ulang itu, terapkan, lalu gunakan pola eskalasi AI untuk mengidentifikasi dan mengisi sisa celah selama minggu-minggu berikutnya. Pendekatan bertahap ini memberi Anda sistem yang berfungsi dengan cepat dan memperbaikinya berdasarkan data nyata.

Siap menerapkan dukungan AI?

14 hari gratis. Platform lengkap. Kami memindahkan datamu untukmu.