Ako vytvoriť znalostnú bázu: články, vyhľadávanie, oprávnenia a odpovede AI

Znalostná báza je prehľadateľná knižnica odpovedí: ako niečo urobiť, ako niečo opraviť, aké je pravidlo. Na jej vytvorenie potrebujete články zoskupené do niekoľkých jasných kategórií, editor, ktorý vaši autori naozaj použijú, vyhľadávanie, ktoré nájde správny článok podľa slov, ktoré ľudia skutočne zadávajú, a rozhodnutie, kto môže čo čítať — verejnosť, prihlásení zákazníci alebo len zamestnanci. Nástroj na tvorbu aplikácií s AI dokáže štruktúru, editor a vyhľadávanie pripraviť v krátkom sedení. Užitočnosť znalostnej bázy však určuje písanie a údržba, preto navrhujte pre jednoduché úpravy a odhaľovanie zastaraných článkov od prvého dňa.

Najprv rozhodnite, pre koho je

Rovnaké funkcie slúžia veľmi rozdielnym webom:

• Verejné centrum pomoci — pre zákazníkov a záujemcov. Musí byť rýchle, indexovateľné vyhľadávačmi a napísané ich slovami.
• Dokumentácia len pre zákazníkov — za prihlásením, pre platiacich zákazníkov alebo partnerov.
• Interná znalostná báza — pravidlá, procesy, návody pre zamestnancov. Musí byť súkromná; vyhľadávanie a aktuálnosť sú dôležitejšie než dizajn.

Miešanie verejných a interných článkov na jednom webe je miesto, kde vzniká väčšina únikov. Ak potrebujete oboje, nastavte každému článku jasnú viditeľnosť, alebo prevádzkujte dva samostatné weby.

Čo aplikácia potrebuje

Dáta

Dve polia odvádzajú veľa práce: vlastník (kto udržiava článok presný) a naposledy skontrolovaný (kedy niekto naposledy potvrdil, že je stále pravdivý). Spolu vám umožnia vypísať články, ktoré nikto neoveril šesť mesiacov.

Stránky

• Čitateľ: domovská stránka s vyhľadávaním a kategóriami, stránky kategórií, stránky článkov s obsahom, súvisiace články a výzva „Bol tento článok užitočný?“.
• Editor: zoznam článkov s filtrami (koncepty, zastarané, s nízkym hodnotením), editor s náhľadom a história revízií.
• Administrátor: kategórie, používatelia a roly, a prehľady vyhľadávaní bez výsledkov.

Oprávnenia

Čitatelia vidia publikované články, ktoré môžu vidieť. Editori vytvárajú a upravujú články, prípadne len v určitých kategóriách. Administrátori publikujú, archivujú a spravujú používateľov. Pre internú znalostnú bázu sa každý musí prihlásiť; pre verejné centrum pomoci len autori.

Rozhodnutia a kompromisy

Editor: Markdown alebo formátovaný text

Markdown je rýchly, prenosný a dobre sa spája s históriou verzií, ale niektorých autorov odradzuje. Editor formátovaného textu s nadpismi, zoznamami, obrázkami, upozorneniami a blokmi kódu pôsobí známo. Nech zvolíte čokoľvek, ukladajte obsah v formáte, ktorý neskôr viete exportovať.

Vyhľadávanie

Základné textové vyhľadávanie v databáze stačí pre niekoľko stoviek článkov, ak prehľadáva názvy, zhrnutia a texty a výsledky s zhodou v názve radí vyššie. Pri väčšom množstve, alebo ak záleží na preklepoch a synonymách („faktúra“ vs „účet“), použite poriadne fulltextové vyhľadávanie alebo hostovanú vyhľadávaciu službu. Náš sprievodca pridaním vyhľadávania prejde možnosti. Zapisujte každý dotaz, ktorý nevráti nič: je to bezplatný zoznam článkov, ktoré treba napísať.

Odpovede AI

Políčko „opýtajte sa“, ktoré odpovedá z vašich článkov, je dnes bežné. Funguje tak, že vyhľadá najrelevantnejšie pasáže a požiada jazykový model, aby odpovedal iba z nich — pozrite si čo je RAG. Vždy zobrazte zdrojové články, povoľte odpoveď „neviem“ a pamätajte, že model si s istotou zopakuje všetko zastarané, čo je vo vašich článkoch. Vytvorte ho až potom, ako sú články v dobrom stave, nie pred tým.

Verzie a kontrola

Uchovávajte revízie, aby ste videli, kto čo zmenil, a mohli sa vrátiť. Pri regulovanom obsahu (interné smernice, bezpečnostné postupy) pridajte schvaľovací krok pred publikovaním zmeny.

Prvý prompt, ktorý funguje

Vytvor verejné centrum pomoci pre Parcelly, aplikáciu na štítky k zásielkam pre malé online obchody. Domovská stránka s veľkým vyhľadávacím poľom a šiestimi kategóriami (Začíname, Tlač štítkov, Prepravcovia, Fakturácia, Vrátenia, Riešenie problémov). Články majú názov, zhrnutie, text v Markdown s obrázkami a upozorneniami, kategóriu, značky, stav (koncept, publikovaný, archivovaný), vlastníka a dátum poslednej kontroly. Stránky článkov zobrazujú obsah, súvisiace články a otázku „Bol tento článok užitočný?“ áno/nie s voliteľným komentárom. Vyhľadávanie pokrýva názvy, zhrnutia a texty, zhody v názvoch sú na prvom mieste a každý dotaz sa zapíše spolu s tým, či vrátil výsledky. Redakčná sekcia (vyžaduje prihlásenie, roly editor a administrátor) zobrazuje koncepty, články bez kontroly 180 dní a články s nízkym hodnotením užitočnosti a uchováva históriu revízií. Každý článok má vlastný názov stránky a meta popis pre vyhľadávače. Čistý, pokojný a čitateľný dizajn. Najprv pre mobil.

Postup

1. Zostavte prvých 20–30 článkov podľa skutočných otázok podpory, ešte pred stavaním. Tento zoznam určí kategórie.
2. Vygenerujte web a skontrolujte čítanie na telefóne — dĺžka riadkov, nadpisy, obrázky.
3. Editor a roly. Autori musia pridávať a opravovať články bez toho, aby žiadali vývojára.
4. Vyhľadávanie, potom ho otestujte slovami, ktoré zákazníci naozaj používajú, vrátane preklepov.
5. Spätná väzba a záznam vyhľadávaní.
6. Prehľad zastaraných článkov podľa vlastníka a dátumu poslednej kontroly.
7. Základy SEO pre verejný web: jedinečné názvy, popisy, čisté URL, sitemapa. Pozrite si SEO pre weby vytvorené AI.
8. Prepojte ju z vášho produktu a z odpovedí podpory, potom každý týždeň sledujte záznam dotazov bez výsledkov.
9. Odpovede AI, keď je obsah solídny.

Časté chyby

• Organizácia podľa oddelení namiesto toho, čo sa čitateľ snaží urobiť.
• Dlhé články pokrývajúce päť úloh. Jedna úloha na článok s názvom, ktorý hovorí, čo rieši.
• Žiadny vlastník článku. Nikto nič neaktualizuje a dôvera klesne po prvej zlej odpovedi.
• Interné poznámky vo verejných článkoch. Používajte oddelenú viditeľnosť a kontrolujte pred publikovaním.
• Vyhľadávanie, ktoré hľadá len v názvoch. Čitatelia zadávajú príznaky problému, nie názvy článkov.
• Snímky obrazovky bez alt textu alebo kontextu. Rýchlo zastarajú; krok opíšte aj slovami.

Kedy je lepšia hotová služba

Ak váš tím už pracuje v nástroji na dokumentáciu alebo wiki, interná znalostná báza tam je zvyčajne najmenší odpor — naše porovnanie Notion vs Confluence pokrýva dve bežné voľby. Ak používate helpdesk, jeho vstavané centrum pomoci prepája články s tiketmi a navrhuje články zákazníkom, čo je ťažké zopakovať. Generátory dokumentačných webov sú ideálne pre vývojárskú dokumentáciu uloženú spolu s kódom.

Vlastnú znalostnú bázu stavte vtedy, keď potrebujete vlastnú štruktúru alebo oprávnenia (články pre klienta, pobočku alebo rolu), keď chcete znalostnú bázu v rámci svojho produktu namiesto na samostatnom webe, keď potrebujete kroky kontroly a schvaľovania, ktoré wiki nevynucuje, alebo keď chcete odpovede AI nad svojím obsahom bez ďalšieho predplatného. Dobre sa k tomu hodí vlastný helpdesk.

Vytvorenie s Mythex

Na Mythex opíšete znalostnú bázu v chate a vytvorí sa v živom náhľade; články, revízie a spätná väzba sa ukladajú do databázy Postgres, ktorú agent pridá podľa potreby, a obrázky idú do súborového úložiska projektu. Prihlásenie editorov používa prístup k autentifikácii, ktorý si zvolíte, keďže Mythex nemá vstavané prihlásenie koncových používateľov. Pre odpovede AI používate kľúč API vášho poskytovateľa AI uložený ako tajomstvo projektu a spotreba sa účtuje u vášho poskytovateľa, nie ako kredity Mythex (recept na AI). Nové aplikácie Mythex sa predvolene renderujú ako klientská React single-page aplikácia, ktorá je pre vyhľadávače slabšia, takže pri verejnom centre pomoci si vyžiadajte nastavenie vhodné pre statický obsah alebo renderovanie na serveri, napríklad Next.js (recept na SEO).

Ako východiskový prompt vyskúšajte šablóny hub s produktovými znalosťami alebo aplikácia tímovej dokumentácie.

Otázky