Kako napraviti bazu znanja: članci, pretragu, dozvole i AI odgovore

Baza znanja je pretraživa biblioteka odgovora: kako nešto uraditi, kako nešto popraviti, koje je pravilo. Da je napravite, potrebni su vam članci grupisani u nekoliko jasnih kategorija, uređivač koji će vaši pisci stvarno koristiti, pretraga koja pronalazi pravi članak iz reči koje ljudi zaista kucaju i odluka ko šta može da čita — javnost, kupci koji su prijavljeni ili samo zaposleni. AI alat za izradu može da napravi strukturu, uređivač i pretragu u kratkoj sesiji. Ono što čini bazu znanja korisnom jeste pisanje i održavanje, pa dizajnirajte za lako uređivanje i za uočavanje zastarelih članaka od prvog dana.

Prvo odlučite za koga je

Iste funkcije služe veoma različitim sajtovima:

• Javni centar za pomoć — za kupce i potencijalne kupce. Mora da bude brz, dostupan pretraživačima i napisan njihovim rečima.
• Dokumentacija samo za kupce — iza prijave, za plaćajuće kupce ili partnere.
• Interna baza znanja — politike, procesi, uputstva za zaposlene. Mora da bude privatna; pretraga i svežina su važniji od dizajna.

Mešanje javnih i internih članaka na jednom sajtu je mesto gde se najčešće dešavaju curenja. Ako su vam potrebne obe vrste, dajte svakom članku jasno podešavanje vidljivosti ili pokrenite dva odvojena sajta.

Šta aplikacija treba

Podaci

Dva polja rade najviše posla: vlasnik (ko drži članak tačnim) i poslednji pregled (kada je neko poslednji put potvrdio da je još uvek tačan). Zajedno vam omogućavaju da vidite članke koje niko nije proverio šest meseci.

Stranice

• Čitalac: početna sa pretragom i kategorijama, stranice kategorija, stranice članaka sa sadržajem, srodnim člancima i pitanjem „Da li vam je ovo bilo korisno?“.
• Uređivač: lista članaka sa filterima (nacrti, zastareli, slabo ocenjeni), uređivač sa pregledom i istorija revizija.
• Administrator: kategorije, korisnici i uloge, i izveštaji o pretragama bez rezultata.

Dozvole

Čitaoci vide objavljene članke koje smeju da vide. Urednici prave i menjaju članke, možda ograničeno na određene kategorije. Administratori objavljuju, arhiviraju i upravljaju korisnicima. Za internu bazu znanja svi treba da imaju nalog; za javni centar za pomoć prijavljuju se samo pisci.

Odluke i kompromisi

Uređivač: Markdown ili bogati tekst

Markdown je brz, prenosiv i dobro radi sa istorijom verzija, ali neki pisci ga ne vole. Uređivač bogatog teksta sa naslovima, listama, slikama, istaknutim porukama i blokovima koda deluje poznato. Šta god da izaberete, čuvajte sadržaj u formatu koji možete kasnije da izvezete.

Pretraga

Osnovna tekstualna pretraga baze podataka dovoljna je za nekoliko stotina članaka ako pretražujete naslove, sažetke i sadržaj i dajete prednost podudaranjima u naslovima. Preko toga, ili ako su greške u kucanju i sinonimi važni („faktura“ naspram „račun“), koristite pravu full-text pretragu ili hostovanu uslugu pretrage. Naš vodič za dodavanje pretrage prolazi kroz opcije. Beležite svaki upit koji ne vrati nijedan rezultat: to je besplatna lista članaka koje treba napisati.

AI odgovori

Polje „postavi pitanje“ koje odgovara iz vaših članaka je sada uobičajeno. Radi tako što preuzima najrelevantnije odlomke i traži od jezičkog modela da odgovori samo na osnovu njih — vidite šta je RAG. Uvek prikažite izvorne članke, omogućite „ne znam“ i zapamtite da će samouvereno ponavljati sve zastarelo iz vaših članaka. Napravite ga tek kada su članci u dobrom stanju, ne pre.

Verzije i pregled

Čuvajte revizije da vidite ko je šta promenio i da možete da vratite stanje. Za regulisan sadržaj (HR politika, bezbednosne procedure) dodajte korak odobrenja pre objave izmene.

Prvi upit koji funkcioniše

Napravi javni centar za pomoć za Parcelly, aplikaciju za štampanje nalepnica za male onlajn prodavnice. Početna stranica sa velikim poljem za pretragu i šest kategorija (Prvi koraci, Štampanje nalepnica, Prevoznici, Naplata, Povraćaji, Rešavanje problema). Članci imaju naslov, sažetak, sadržaj u Markdown-u sa slikama i istaknutim porukama, kategoriju, oznake, status (nacrt, objavljen, arhiviran), vlasnika i datum poslednjeg pregleda. Stranice članaka prikazuju sadržaj, srodne članke i pitanje „Da li vam je ovo bilo korisno?“ sa da ili ne i opcionalnim komentarom. Pretraga obuhvata naslove, sažetke i sadržaj, a podudaranja u naslovima su prva; svaki upit i to da li je dao rezultate se beleži. Uređivačka oblast (potrebna prijava, uloge urednik i administrator) prikazuje nacrte, članke nepregledane 180 dana i članke sa niskim ocenama korisnosti, i čuva istoriju revizija. Svaki članak ima svoj naslov stranice i meta opis za pretraživače. Čist, miran i čitljiv dizajn. Prvo za telefon.

Koraci za izradu

1. Napravite listu prvih 20–30 članaka na osnovu pravih pitanja podrške pre nego što bilo šta gradite. Ta lista određuje kategorije.
2. Napravite sajt i proverite čitanje na telefonu — dužinu reda, naslove, slike.
3. Urednici i uloge. Pisci treba da dodaju i ispravljaju članke bez pitanja programera.
4. Pretraga, pa je testirajte rečima koje kupci stvarno koriste, uključujući pogrešno kucanje.
5. Povratne informacije i evidencija pretrage.
6. Izveštaj o zastarelim člancima na osnovu vlasnika i datuma poslednjeg pregleda.
7. Osnove SEO-a za javni sajt: jedinstveni naslovi, opisi, čisti URL-ovi, mapa sajta. Vidite SEO za sajtove napravljene pomoću AI-ja.
8. Povežite ga iz svog proizvoda i svojih odgovora podrške, pa nedeljno pratite evidenciju bez rezultata.
9. AI odgovori, kada sadržaj bude čvrst.

Česte greške

• Organizovanje po odeljenjima umesto po tome šta čitalac pokušava da uradi.
• Dugački članci koji pokrivaju pet zadataka. Jedan zadatak po članku, s naslovom koji kaže šta rešava.
• Nema vlasnika po članku. Niko ništa ne ažurira, a poverenje opada posle prve pogrešne informacije.
• Interne beleške u javnim člancima. Koristite posebnu vidljivost i pregledajte pre objave.
• Pretraga koja poklapa samo naslove. Čitaoci kucaju simptome, a ne nazive članaka.
• Snimci ekrana bez alt teksta ili konteksta. Brzo zastare; opišite korak i rečima.

Kada je gotov proizvod bolji izbor

Ako vaš tim već radi u alatu za dokumentaciju ili viki, interna baza znanja tamo je obično najlakši put — naše poređenje Notion-a i Confluence-a pokriva dva česta izbora. Ako koristite alat za helpdesk, njegov ugrađeni centar za pomoć povezuje članke sa tiketima i predlaže članke kupcima, što je teško ponoviti. Generatori sajtova sa dokumentacijom su idealni za dokumentaciju za programere koja se čuva uz kod.

Napravite sopstvenu kada su vam potrebni sopstvena struktura ili dozvole (članci po klijentu, po lokaciji, po ulozi), kada baza treba da bude unutar vašeg proizvoda, a ne na posebnom sajtu, kada vam trebaju koraci pregleda i odobrenja koje viki ne sprovodi, ili kada želite AI odgovore nad svojim sadržajem bez još jedne pretplate. Prirodno se uklapa uz prilagođeni helpdesk.

Izgradnja uz Mythex

Na Mythex-u opišete bazu znanja u čatu i ona se gradi u živom pregledu. Članci, revizije i povratne informacije čuvaju se u Postgres bazi koju agent dodaje kad zatreba, a slike idu u skladište fajlova projekta. Prijave urednika koriste pristup za autentifikaciju koji sami birate, jer Mythex nema ugrađenu prijavu za krajnje korisnike. Za AI odgovore koristite ključ API-ja svog AI provajdera, sačuvan kao tajna projekta; korišćenje se naplaćuje kod vašeg provajdera, a ne u Mythex kreditima (AI recept). Nove Mythex aplikacije podrazumevano su klijentski renderovani React SPA, što je slabije za pretraživače, pa za javni centar za pomoć zatražite podešavanje pogodno za statičko ili serversko renderovanje, kao što je Next.js (SEO recept).

Za početni upit probajte šablone baza znanja za proizvod ili aplikacija za dokumentaciju tima.

Pitanja