Kako napraviti bazu znanja: članci, pretraga, dozvole i AI odgovori

Baza znanja je pretraživa biblioteka odgovora: kako nešto uraditi, kako nešto popraviti, koje je pravilo. Da biste je napravili, potrebni su vam članci grupisani u nekoliko jasnih kategorija, uređivač koji će vaši pisci zaista koristiti, pretraga koja pronalazi pravi članak na osnovu riječi koje ljudi stvarno kucaju, i odluka ko šta može da čita — javnost, kupci koji su prijavljeni ili samo zaposleni. AI alat za izradu aplikacija može za kratku sesiju napraviti strukturu, uređivač i pretragu. Ono što bazu znanja čini korisnom jeste pisanje i održavanje, zato od prvog dana projektujte za lako uređivanje i za uočavanje zastarjelih članaka.

Prvo odlučite za koga je

Iste funkcije služe veoma različitim sajtovima:

• Javni centar za pomoć — za kupce i potencijalne kupce. Mora biti brz, indeksiran u pretraživačima i napisan njihovim riječima.
• Dokumentacija samo za kupce — iza prijave, za plaćene kupce ili partnere.
• Interna baza znanja — pravila, procesi, uputstva za zaposlene. Mora biti privatna; pretraga i aktuelnost su važniji od dizajna.

Miješanje javnih i internih članaka na jednom sajtu je mjesto gdje se najčešće događaju curenja. Ako su vam potrebna oba, dajte svakom članku jasnu postavku vidljivosti ili pokrenite dva zasebna sajta.

Šta aplikacija treba

Podaci

Dva polja obavljaju mnogo posla: vlasnik (ko održava članak tačnim) i datum posljednjeg pregleda (kada je neko posljednji put potvrdio da je još uvijek tačan). Zajedno omogućavaju da prikažete članke koje niko nije provjerio šest mjeseci.

Stranice

• Čitalac: početna sa pretragom i kategorijama, stranice kategorija, stranice članaka sa sadržajem, povezanim člancima i pitanjem „Da li vam je ovo bilo korisno?”.
• Urednik: spisak članaka s filterima (nacrti, zastarjeli, nisko ocijenjeni), uređivač s pregledom i istorija revizija.
• Admin: kategorije, korisnici i uloge, te izvještaji o pretragama bez rezultata.

Dozvole

Čitaoci vide objavljene članke koje smiju da vide. Urednici kreiraju i uređuju članke, možda samo u određenim kategorijama. Admini objavljuju, arhiviraju i upravljaju korisnicima. Za internu bazu znanja svi moraju imati prijavu; za javni centar za pomoć prijavu imaju samo pisci.

Odluke i kompromisi

Uređivač: Markdown ili formatirani tekst

Markdown je brz, prenosiv i dobro radi s istorijom verzija, ali nekim piscima je neprijatan. Uređivač formatiranog teksta s naslovima, listama, slikama, napomenama i blokovima koda djeluje poznato. Šta god izaberete, čuvajte sadržaj u formatu koji možete kasnije izvesti.

Pretraga

Osnovna tekstualna pretraga baze je dovoljna za nekoliko stotina članaka ako pretražujete naslove, sažetke i tekst, a podudaranja s naslovom rangirate više. Dalje od toga, ili ako su greške u kucanju i sinonimi važni („račun” i „faktura”), koristite pravu full-text pretragu ili hostovanu uslugu pretrage. Naš vodič za dodavanje pretrage prolazi kroz opcije. Zabilježite svaki upit koji ne vrati ništa: to je besplatan spisak članaka koje treba napisati.

AI odgovori

Polje „postavi pitanje” koje odgovara iz vaših članaka je sada uobičajeno. Radi tako što pronalazi najrelevantnije odlomke i traži od jezičkog modela da odgovara samo na osnovu njih — pogledajte šta je RAG. Uvijek prikazujte izvorne članke, dozvolite odgovor „ne znam” i zapamtite da će samouvjereno ponoviti sve zastarjelo što stoji u člancima. Napravite ga kad članci budu u dobrom stanju, a ne prije.

Verzionisanje i pregled

Čuvajte revizije da biste vidjeli ko je šta promijenio i da se možete vratiti. Za sadržaj pod regulativom (HR politike, sigurnosni postupci) dodajte korak odobrenja prije objavljivanja izmjene.

Prvi prompt koji radi

Napravi javni centar za pomoć za Parcelly, aplikaciju za etikete za pošiljke za male online prodavnice. Početna stranica s velikim poljem za pretragu i šest kategorija (Početak, Štampanje etiketa, Kurirske službe, Naplata, Povrati, Rješavanje problema). Članci imaju naslov, sažetak, tekst u Markdownu sa slikama i napomenama, kategoriju, oznake, status (nacrt, objavljeno, arhivirano), vlasnika i datum posljednjeg pregleda. Stranice članaka prikazuju sadržaj, povezane članke i pitanje „Da li vam je ovo bilo korisno?” da/ne s opcionim komentarom. Pretraga obuhvata naslove, sažetke i tekst, a podudaranja s naslovom su prva, i bilježi svaki upit i da li je vratio rezultate. Područje za urednike (potrebna prijava, uloge urednik i admin) prikazuje nacrte, članke koji nisu pregledani 180 dana i članke s niskim ocjenama korisnosti, i čuva istoriju revizija. Svaki članak ima svoj naslov stranice i meta opis za pretraživače. Čist, miran, čitljiv dizajn. Prvo mobilni.

Koraci izrade

1. Napišite prvih 20–30 članaka na osnovu pravih pitanja podrške prije nego što išta gradite. Taj spisak oblikuje kategorije.
2. Generišite sajt i provjerite čitanje na telefonu — dužinu redova, naslove, slike.
3. Uređivač i uloge. Pisci treba da dodaju i ispravljaju članke bez traženja od programera.
4. Pretraga, zatim je testirajte riječima koje kupci zaista koriste, uključujući pogrešno ukucane.
5. Povratne informacije i bilježenje pretraga.
6. Izvještaj o zastarjelim člancima na osnovu vlasnika i datuma posljednjeg pregleda.
7. Osnove SEO-a za javni sajt: jedinstveni naslovi, opisi, čisti URL-ovi, sitemap. Pogledajte SEO za sajtove napravljene AI alatima.
8. Povežite ga iz proizvoda i iz odgovora podrške, pa sedmično pratite dnevnik upita bez rezultata.
9. AI odgovori, kad sadržaj bude čvrst.

Česte greške

• Organizovanje po odjeljenjima umjesto po tome šta čitalac pokušava da uradi.
• Dugi članci koji pokrivaju pet zadataka. Jedan zadatak po članku, s naslovom koji kaže šta rješava.
• Bez vlasnika po članku. Niko ništa ne ažurira, a povjerenje opada nakon prvog pogrešnog odgovora.
• Interne bilješke u javnim člancima. Koristite zasebnu vidljivost i pregledajte prije objavljivanja.
• Pretraga koja se podudara samo s naslovima. Čitaoci kucaju simptome, a ne nazive članaka.
• Snimci ekrana bez alt teksta ili konteksta. Brzo zastarijevaju; opišite korak i riječima.

Kad je gotov proizvod bolji izbor

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

Gradite vlastitu kad su vam potrebni sopstvena struktura ili dozvole (članci po klijentu, lokaciji ili ulozi), kad želite bazu znanja unutar proizvoda, a ne na zasebnom sajtu, kad trebate korake pregleda i odobrenja koje wiki ne sprovodi, ili kad želite AI odgovore nad svojim sadržajem bez još jedne pretplate. Dobro se uklapa uz prilagođeni helpdesk.

Izrada uz Mythex

Na Mythexu opisujete bazu znanja u chatu 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 fajl storage projekta. Prijave za urednike koriste pristup prijavi koji vi birate, jer Mythex nema ugrađenu prijavu za krajnje korisnike. Za AI odgovore koristite API ključ vašeg AI provajdera sačuvan kao tajna projekta, a potrošnja se naplaćuje na računu vašeg provajdera, a ne kao Mythex krediti (AI recept). Novi Mythex projekti podrazumijevano su React aplikacija na jednoj stranici renderovana na klijentu, što je slabije za pretraživače, pa za javni centar za pomoć tražite postavku pogodnu za statički sajt ili renderovanje na serveru, kao što je Next.js (SEO recept).

Za početni prompt probajte šablone centar znanja o proizvodu ili aplikacija s dokumentacijom za tim.

Pitanja