Znalostná báza pre AI

Ako písať znalostnú bázu pre AI

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Najčastejšie chyby pri príprave dokumentácie pre AI a ich dopad na odpovede

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Pracovníčka supportu sa interného AI asistenta opýta: „Kedy sa servisná požiadavka automaticky uzavrie?“ Asistent odpovie: „Po piatich dňoch bez reakcie zákazníka.“

Odpoveď vychádza zo skutočného dokumentu. Päťdňové automatické uzavretie však platí iba pre jedného zákazníka s úpravou systému na mieru.…

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Ako pripraviť dokumentáciu ako vstup pre RAG systém

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Tím chce, aby interný AI asistent pomáhal supportu pri chybách synchronizácie objednávok. Vyberie existujúce návody, support záznamy a release notes a sprístupní ich RAG systému.

Pri skúšobnej otázke „Môžem po chybe spustiť synchronizáciu objednávky znova?“…

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Citácie a hranice odpovede: kedy má AI uviesť zdroj a kedy povedať, že odpoveď nenašla

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Predstavme si, že pracovníčka supportu sa interného AI asistenta opýta: „Môžem po chybe synchronizácie objednávky spustiť synchronizáciu ručne znova?“

Asistent nájde support položku o tejto chybe. Dokument vysvetľuje, ktoré údaje treba skontrolovať a kedy incident odovzdať integračnému tímu.…

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Prístupové práva a citlivé údaje v znalostnej báze pre AI

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Pracovníčka supportu sa interného AI asistenta opýtala, ako riešiť neúspešnú synchronizáciu objednávky. Dostala použiteľný postup, ale aj časť internej poznámky: meno zákazníka, identifikátor jeho objednávky a informáciu o zmluvne dohodnutej výnimke.

Postup bol vecne správny.…

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Aktuálnosť znalostnej bázy: vlastník, verzia, platnosť a archivácia

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Po vydaní novej verzie systému sa zmenil postup prideľovania používateľských oprávnení. Predtým mohol administrátor prideliť rolu priamo. Nový postup vyžadoval najprv schválenie žiadosti zodpovednou osobou.

Administrátorský manuál bol aktualizovaný. V znalostnej báze však zostala staršia support položka s pôvodným postupom.…

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Tabuľky, screenshoty a PDF: čo sa pri spracovaní dokumentácie môže stratiť

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Support sa spýta interného AI asistenta: „Môžem po chybe zopakovať import faktúr?“

Asistent nájde administrátorskú príručku a odpovie: „Áno. Opravte súbor a spustite import znova.“

V príručke však postup závisí od toho, v akom stave sa import skončil.…

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Konzistentná terminológia, synonymá a skratky ako podmienka spoľahlivého vyhľadávania

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Pracovníčka supportu riešila používateľa, ktorý sa po niekoľkých neúspešných pokusoch nemohol prihlásiť do systému. Interného AI asistenta sa opýtala:

„Ako odblokujem používateľa po troch nesprávnych heslách?“

AI jej ponúkla postup na obnovenie zabudnutého hesla.…

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Core, Custom, verzia a zákazník: ako zabrániť miešaniu odpovedí

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Pracovníčka supportu sa interného AI asistenta opýtala:

„Ako môžem zákazníkovi znovu vystaviť faktúru?“

AI odpovedala konkrétnym postupom:

  1. Otvorte detail objednávky.
  2. Prejdite do časti Fakturácia.
  3. Vyberte možnosť Znovu vystaviť faktúru.
  4. Skontrolujte fakturačné údaje.
  5. Potvrďte vystavenie a odoslanie nového dokladu.
…
Dokumentácia a používateľské príručky, Znalostná báza pre AI

Chunkovanie podľa významu: ako rozdeliť dokument bez straty kontextu

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Interný AI asistent mal pomáhať supportu pri riešení problémov s objednávkami. Do znalostnej bázy sme preto pridali dokument, ktorý opisoval celý proces platby:

  • vytvorenie objednávky,
  • výber spôsobu platby,
  • komunikáciu s platobnou bránou,
  • zmeny stavov objednávky,
  • opakovanie neúspešnej platby,
  • zákaznícke výnimky,
  • diagnostiku chýb.
…
Dokumentácia a používateľské príručky, Znalostná báza pre AI

Stručnosť nestačí: koľko kontextu potrebuje AI na správnu odpoveď

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Testerka požiada interného AI asistenta:

„Priprav mi testovacie scenáre pre zmenu spôsobu platby.“

AI vytvorí prehľadný zoznam testov. Overí výber platobnej metódy, úspešnú platbu, zamietnutie platby aj zobrazenie chybovej správy. Odpoveď pôsobí profesionálne a na prvý pohľad jej nič nechýba.…

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Ako štruktúrovať dokumentáciu pre človeka aj AI

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Používateľ nahlásil, že po odoslaní objednávky nedostal potvrdzovací e-mail.

V znalostnej báze sme našli tri dokumenty:

  • „Odosielanie e-mailov“
  • „Notifikácie objednávok“
  • „Riešenie problémov s objednávkami“

Prvý dokument opisoval nastavenie e-mailového servera. Druhý obsahoval zoznam udalostí, pri ktorých systém posiela notifikácie.…

Dokumentácia a používateľské príručky, Znalostná báza pre AI

Znalostná báza pre AI nie je iba priečinok s dokumentmi

Séria: Ako písať dokumentáciu a manuály v IT projekte

Reálny problém z praxe

Firma sa rozhodne nasadiť AI asistenta pre support. Do nástroja pripojí priečinok s návodiami, export starých tiketov, FAQ a niekoľko interných dokumentov.

Po prvých otázkach prichádza sklamanie.

Používateľ sa opýta, prečo sa mu nevytvorila faktúra.…

Návrat hore