Kako napraviti bazu znanja: članci, pretraga, dopuštenja i AI odgovori

Baza znanja je pretraživa knjižnica odgovora: kako nešto učiniti, kako nešto popraviti, koje je pravilo. Za njezinu izradu potrebni su vam članci grupirani u nekoliko jasnih kategorija, uređivač koji će vaši pisci doista koristiti, pretraga koja pronalazi pravi članak iz riječi koje ljudi stvarno upisuju te odluka o tome tko što smije čitati — javnost, prijavljeni kupci ili samo zaposlenici. AI graditelj aplikacija može u kratkoj sesiji napraviti strukturu, uređivač i pretragu. Ono što baza znanja čini korisnom jest pisanje i održavanje, zato dizajnirajte za jednostavno uređivanje i za prepoznavanje zastarjelih članaka od prvog dana.

Prvo odlučite za koga je

Iste značajke služe vrlo različitim stranicama:

• Javni centar za pomoć — za kupce i potencijalne kupce. Mora biti brz, indeksibilan u tražilicama i napisan njihovim riječima.
• Dokumentacija samo za kupce — iza prijave, za plaćajuće kupce ili partnere.
• Interna baza znanja — politike, procesi i upute za zaposlenike. Mora biti privatna; pretraga i svježina važniji su od dizajna.

Miješanje javnih i internih članaka na jednoj stranici najčešći je izvor curenja podataka. Ako su vam potrebni oboje, dodijelite svakom članku jasnu postavku vidljivosti ili vodite dvije zasebne stranice.

Što aplikacija treba

Podaci

Dva polja obavljaju puno posla: vlasnik (tko održava članak točnim) i zadnji pregled (kada je netko zadnji put potvrdio da je još istinit). Zajedno vam omogućuju popis članaka koje nitko nije provjerio šest mjeseci.

Stranice

• Čitatelj: početna s pretragom i kategorijama, stranice kategorija, stranice članaka s sadržajem, povezanim člancima i upitom „Je li ti ovo bilo korisno?”.
• Uređivač: popis članaka s filterima (nacrti, zastarjeli, nisko ocijenjeni), uređivač s pregledom i povijest revizija.
• Administrator: kategorije, korisnici i uloge te izvještaji o pretragama bez rezultata.

Dopuštenja

Čitatelji vide objavljene članke koje smiju vidjeti. Urednici stvaraju i uređuju članke, možda ograničeno na određene kategorije. Administratori objavljuju, arhiviraju i upravljaju korisnicima. Za internu bazu znanja svi trebaju prijavu; za javni centar za pomoć prijavu trebaju samo pisci.

Odluke i kompromisi

Uređivač: Markdown ili formatirani tekst

Markdown je brz, prenosiv i dobro funkcionira s poviješću verzija, ali neki pisci ga doživljavaju kao prepreku. Uređivač formatiranog teksta s naslovima, popisima, slikama, istaknutim napomenama i blokovima koda djeluje poznato. Što god odaberete, spremajte sadržaj u formatu koji kasnije možete izvesti.

Pretraga

Osnovna tekstualna pretraga baze dovoljna je za nekoliko stotina članaka ako pretražujete naslove, sažetke i sadržaj te rangirate podudaranja u naslovu više. Iznad toga, ili ako su tipfeleri i sinonimi važni („račun” i „faktura”), koristite pravu full-text pretragu ili hostiranu uslugu pretrage. Naš vodič za dodavanje pretrage prolazi kroz mogućnosti. Bilježite svaki upit bez rezultata: to je besplatan popis članaka koje trebate napisati.

AI odgovori

Okvir „postavi pitanje” koji odgovara na temelju vaših članaka danas je uobičajen. Radi tako da dohvaća najrelevantnije odlomke i traži od jezičnog modela da odgovori samo na temelju njih — pogledajte što je RAG. Uvijek prikažite izvorne članke, dopustite odgovor „ne znam” i zapamtite da će samouvjereno ponoviti sve zastarjelo što je u vašim člancima. Izradite ga nakon što su članci u dobrom stanju, a ne prije.

Verzioniranje i pregled

Čuvajte revizije kako biste vidjeli tko je što promijenio i mogli se vratiti na raniju verziju. Za regulirani sadržaj (pravilnici o radu, sigurnosni postupci) dodajte korak odobravanja prije objave promjene.

Prvi upit koji radi

Izradi javni centar za pomoć za Parcelly, aplikaciju za otisak dostavnih naljepnica za male online trgovine. Početna stranica s velikim okvirom za pretragu i šest kategorija (Početak rada, Ispis naljepnica, Dostavljači, Naplata, Povrati, Rješavanje problema). Članci imaju naslov, sažetak, sadržaj u Markdownu sa slikama i istaknutim napomenama, kategoriju, oznake, status (nacrt, objavljeno, arhivirano), vlasnika i datum zadnjeg pregleda. Stranice članaka prikazuju sadržaj, povezane članke i upit „Je li ti ovo bilo korisno?” da/ne s dodatnim komentarom. Pretraga obuhvaća naslove, sažetke i sadržaj, a podudaranja u naslovu imaju prednost, i bilježi svaki upit i je li vratio rezultate. Uređivačko područje (potrebna prijava, uloge urednik i administrator) prikazuje nacrte, članke koji nisu pregledani 180 dana i članke s niskim ocjenama korisnosti te čuva povijest revizija. Svaki članak ima vlastiti naslov stranice i meta opis za tražilice. Čist, smiren, čitljiv dizajn. Prvo mobilni.

Koraci izrade

1. Popišite prvih 20–30 članaka iz stvarnih pitanja korisničke podrške prije nego što išta gradite. Taj popis oblikuje kategorije.
2. Generirajte stranicu i provjerite čitanje na telefonu — duljinu redaka, naslove, slike.
3. Uređivač i uloge. Pisci trebaju dodavati i popravljati članke bez traženja pomoći programera.
4. Pretraga, zatim testirajte s riječima koje kupci stvarno koriste, uključujući pogrešno napisane.
5. Povratne informacije i bilježenje pretraga.
6. Izvještaj o zastarjelim člancima na temelju vlasnika i datuma zadnjeg pregleda.
7. Osnove SEO-a za javnu stranicu: jedinstveni naslovi, opisi, čiste URL-ove, mapa stranice. Vidi SEO za web stranice izrađene uz AI.
8. Poveznica iz vašeg proizvoda i vaših odgovora podrške, zatim tjedno pregledavajte dnevnik upita bez rezultata.
9. AI odgovori, kada sadržaj bude čvrst.

Česte pogreške

• Organiziranje po odjelima umjesto prema tome što čitatelj pokušava učiniti.
• Dugi članci koji pokrivaju pet zadataka. Jedan zadatak po članku, s naslovom koji kaže što rješava.
• Nema vlasnika za svaki članak. Nitko ništa ne ažurira, a povjerenje pada nakon prvog pogrešnog odgovora.
• Interne bilješke u javnim člancima. Koristite zasebnu vidljivost i pregledajte prije objave.
• Pretraga koja se podudara samo s naslovima. Čitatelji upisuju simptome, a ne nazive članaka.
• Snimke zaslona bez alt teksta ili konteksta. Brzo zastare; korak opišite i riječima.

Kada 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ša usporedba Notiona i Confluencea 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 stranica dokumentacije idealni su za dokumentaciju za programere koja se čuva uz kod.

Izradite vlastitu kada trebate vlastitu strukturu ili dopuštenja (članci po klijentu, lokaciji ili ulozi), želite bazu znanja unutar svog proizvoda umjesto na zasebnoj stranici, trebate korake pregleda i odobravanja koje wiki ne provodi ili želite AI odgovore nad svojim sadržajem bez još jedne pretplate. Prirodno se nadovezuje na prilagođeni helpdesk.

Izrada s Mythexom

Na Mythexu opišete bazu znanja u chatu i ona se gradi u živom pregledu; članci, revizije i povratne informacije spremaju se u Postgres bazu podataka koju agent doda kad je potrebno, a slike idu u pohranu datoteka projekta. Prijava urednika koristi pristup za autentikaciju koji odaberete, jer Mythex nema ugrađenu prijavu za krajnje korisnike. Za AI odgovore koristite vlastiti API ključ svog AI pružatelja pohranjen kao tajna projekta, a potrošnja se naplaćuje kod vašeg pružatelja, a ne kao Mythex krediti (AI recept). Nove Mythex aplikacije zadano su React single-page aplikacija renderirana na klijentu, što je slabije za tražilice, pa za javni centar za pomoć zatražite postavku prikladnu za statički sadržaj ili renderiranu na poslužitelju, poput Next.js-a (SEO recept).

Za početni upit isprobajte predloške centar znanja proizvoda ili aplikacija za dokumentaciju tima.

Pitanja