Cara Bina Pangkalan Pengetahuan: Artikel, Carian, Kebenaran dan Jawapan AI

Pangkalan pengetahuan ialah perpustakaan jawapan yang boleh dicari: cara melakukan sesuatu, cara membetulkan sesuatu, apakah peraturannya. Untuk membinanya, anda memerlukan artikel yang dikumpulkan dalam beberapa kategori yang jelas, editor yang benar-benar digunakan oleh penulis anda, carian yang menjumpai artikel yang tepat daripada perkataan yang benar-benar ditaip orang, dan keputusan tentang siapa yang boleh membaca apa — orang ramai, pelanggan yang log masuk, atau kakitangan sahaja. Pembina aplikasi AI boleh menghasilkan struktur, editor dan carian dalam satu sesi pendek. Apa yang menjadikan pangkalan pengetahuan berguna ialah penulisan dan penyelenggaraannya, jadi reka untuk penyuntingan yang mudah dan untuk mengesan artikel yang sudah lapuk dari hari pertama.

Tentukan untuk siapa dahulu

Fungsi yang sama berkhidmat untuk laman yang sangat berbeza:

• Pusat bantuan awam — untuk pelanggan dan bakal pelanggan. Mesti pantas, boleh diindeks oleh enjin carian, dan ditulis dalam bahasa mereka.
• Dokumentasi khusus pelanggan — di sebalik log masuk, untuk pelanggan berbayar atau rakan kongsi.
• Pangkalan pengetahuan dalaman — dasar, proses, cara-cara untuk kakitangan. Mesti persendirian; carian dan kesegaran lebih penting daripada reka bentuk.

Mencampurkan artikel awam dan dalaman dalam satu laman ialah punca kebocoran yang paling biasa. Jika anda memerlukan kedua-duanya, beri setiap artikel tetapan keterlihatan yang jelas, atau jalankan dua laman berasingan.

Apa yang aplikasi perlukan

Data

Dua medan melakukan banyak kerja: pemilik (siapa yang memastikan artikel ini tepat) dan kali terakhir disemak (bila seseorang kali terakhir mengesahkan ia masih benar). Bersama-sama, ia membolehkan anda menyenaraikan artikel yang tiada siapa semak selama enam bulan.

Halaman

• Pembaca: halaman utama dengan carian dan kategori, halaman kategori, halaman artikel dengan kandungan jadual, artikel berkaitan dan gesaan "Adakah ini membantu?".
• Editor: senarai artikel dengan penapis (draf, lapuk, rating rendah), editor dengan pratonton, dan sejarah semakan.
• Admin: kategori, pengguna dan peranan, serta laporan carian yang tiada hasil.

Kebenaran

Pembaca melihat artikel diterbitkan yang mereka dibenarkan lihat. Editor mencipta dan menyunting artikel, mungkin terhad kepada kategori tertentu. Admin menerbitkan, mengarkibkan dan menguruskan pengguna. Untuk pangkalan pengetahuan dalaman, semua orang memerlukan log masuk; untuk pusat bantuan awam, hanya penulis yang perlu.

Keputusan dan pertukaran

Editor: Markdown atau rich text

Markdown pantas, mudah alih dan sesuai dengan sejarah versi, tetapi sesetengah penulis berasa tidak selesa dengannya. Editor rich text dengan tajuk, senarai, imej, kotak nota dan blok kod terasa biasa. Apa pun pilihan anda, simpan kandungan dalam format yang boleh dieksport kemudian.

Carian

Carian teks pangkalan data asas sudah memadai untuk beberapa ratus artikel jika anda mencari tajuk, ringkasan dan kandungan, dengan padanan tajuk diberi kedudukan lebih tinggi. Selepas itu, atau jika kesilapan ejaan dan sinonim penting ("invois" berbanding "bil"), gunakan carian teks penuh yang betul atau perkhidmatan carian yang dihoskan. Panduan kami tentang menambah carian menerangkan pilihannya. Log setiap pertanyaan yang tidak mendapat hasil: ia senarai percuma artikel yang perlu anda tulis.

Jawapan AI

Kotak "tanya soalan" yang menjawab daripada artikel anda kini biasa. Ia berfungsi dengan mendapatkan petikan paling relevan dan meminta model bahasa menjawab hanya daripadanya — lihat apa itu RAG. Sentiasa tunjukkan artikel sumber, benarkan jawapan "saya tidak tahu", dan ingat bahawa ia akan dengan yakin mengulang apa-apa yang lapuk dalam artikel anda. Bina ciri ini selepas artikel berada dalam keadaan baik, bukan sebelumnya.

Versi dan semakan

Simpan semakan supaya anda boleh melihat siapa yang menukar apa dan membuat asal semula. Untuk kandungan berperaturan (dasar HR, prosedur keselamatan), tambah langkah kelulusan sebelum sebarang perubahan diterbitkan.

Prompt pertama yang berfungsi

Bina pusat bantuan awam untuk Parcelly, aplikasi label penghantaran untuk kedai dalam talian kecil. Halaman utama dengan kotak carian besar dan enam kategori (Bermula, Mencetak label, Pembawa, Bil, Pulangan, Penyelesaian masalah). Artikel mempunyai tajuk, ringkasan, kandungan dalam Markdown dengan imej dan kotak nota, kategori, tag, status (draf, diterbitkan, diarkibkan), pemilik dan tarikh semakan terakhir. Halaman artikel menunjukkan kandungan jadual, artikel berkaitan dan "Adakah ini membantu?" ya/tidak dengan ulasan pilihan. Carian meliputi tajuk, ringkasan dan kandungan dengan padanan tajuk di kedudukan pertama, dan mencatat setiap pertanyaan serta sama ada ia mendapat hasil. Ruang editor (perlu log masuk, peranan editor dan admin) menyenaraikan draf, artikel yang tidak disemak dalam 180 hari, dan artikel dengan skor membantu yang rendah, serta menyimpan sejarah semakan. Setiap artikel mempunyai tajuk halaman dan meta description sendiri untuk enjin carian. Reka bentuk yang bersih, tenang dan mudah dibaca. Utamakan telefon bimbit.

Langkah membina

1. Senaraikan 20–30 artikel pertama daripada soalan sokongan sebenar sebelum membina apa-apa. Senarai itu akan membentuk kategori.
2. Jana laman dan semak bacaan pada telefon — panjang baris, tajuk, imej.
3. Editor dan peranan. Penulis perlu menambah dan membetulkan artikel tanpa bertanya kepada pembangun.
4. Carian, kemudian uji dengan perkataan yang sebenarnya digunakan pelanggan, termasuk kesilapan ejaan.
5. Maklum balas dan log carian.
6. Laporan artikel lapuk berdasarkan pemilik dan tarikh semakan terakhir.
7. Asas SEO untuk laman awam: tajuk unik, penerangan, URL kemas, peta laman. Lihat SEO untuk laman web yang dibina dengan AI.
8. Pautkan dari produk anda dan balasan sokongan anda, kemudian pantau log tanpa hasil setiap minggu.
9. Jawapan AI, apabila kandungan sudah kukuh.

Kesilapan biasa

• Menyusun mengikut jabatan dan bukannya mengikut apa yang pembaca cuba lakukan.
• Artikel panjang yang meliputi lima tugas. Satu tugas bagi setiap artikel, dengan tajuk yang menyatakan apa yang diselesaikannya.
• Tiada pemilik bagi setiap artikel. Tiada siapa mengemas kini apa-apa, dan kepercayaan merosot selepas jawapan salah yang pertama.
• Nota dalaman dalam artikel awam. Gunakan keterlihatan berasingan dan semak sebelum menerbitkan.
• Carian yang hanya sepadan dengan tajuk. Pembaca menaip simptom, bukan nama artikel.
• Tangkapan skrin tanpa teks alternatif atau konteks. Ia cepat lapuk; terangkan langkah dalam perkataan juga.

Bila produk siap sedia adalah pilihan yang lebih baik

Jika pasukan anda sudah menggunakan alat dokumentasi atau wiki, pangkalan pengetahuan dalaman di situ biasanya laluan paling mudah — perbandingan Notion vs Confluence kami meliputi dua pilihan biasa. Jika anda menggunakan produk helpdesk, pusat bantuan terbina dalamnya memautkan artikel kepada tiket dan mencadangkan artikel kepada pelanggan, yang sukar untuk ditiru. Penjana laman dokumentasi sesuai untuk dokumentasi pembangun yang disimpan bersama kod.

Bina sendiri apabila anda memerlukan struktur atau kebenaran sendiri (artikel setiap pelanggan, setiap lokasi, atau setiap peranan), mahu pangkalan pengetahuan berada dalam produk anda dan bukan di laman berasingan, memerlukan langkah semakan dan kelulusan yang tidak dikuatkuasakan oleh wiki, atau mahukan jawapan AI ke atas kandungan anda tanpa langganan lain. Ia sesuai dengan helpdesk tersuai.

Membina dengan Mythex

Di Mythex, anda menerangkan pangkalan pengetahuan dalam sembang dan ia dibina dalam pratonton langsung; artikel, semakan dan maklum balas disimpan dalam pangkalan data Postgres yang ditambah oleh ejen apabila diperlukan, dan imej masuk ke storan fail projek. Log masuk editor menggunakan pendekatan pengesahan yang anda pilih, kerana Mythex tiada log masuk pengguna akhir terbina dalam. Untuk jawapan AI, anda menggunakan kunci API pembekal AI anda sendiri yang disimpan sebagai rahsia projek, dan penggunaannya dibilkan kepada akaun pembekal anda, bukan kredit Mythex (resipi AI). Aplikasi Mythex baharu lalai kepada aplikasi React satu halaman sisi klien, yang lebih lemah untuk enjin carian, jadi untuk pusat bantuan awam, minta persediaan yang mesra statik atau dipaparkan di pelayan seperti Next.js (resipi SEO).

Untuk prompt permulaan, cuba templat hab pengetahuan produk atau aplikasi dokumentasi pasukan.

Soalan lazim