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. AI nájde starý workaround, ktorý platil iba pre jedného klienta, a odporučí ho ako všeobecné riešenie.
Dokumenty existovali. AI ich vedela prečítať. Napriek tomu odpoveď nebola použiteľná.
Čo sa tu vlastne pokazilo (analýza systému)
Znalostná báza nie je súbor dokumentov uložených na jednom mieste.
Aby sa z nej dalo spoľahlivo čerpať, musí byť jasné:
- pre ktorý modul a verziu systému informácia platí
- či ide o Core funkciu alebo klientsku úpravu
- aký je symptóm, príčina a odporúčaný postup
- či je postup aktuálny, dočasný alebo zastaraný
- kto za obsah zodpovedá
- na ktoré súvisiace incidenty, bugy alebo návody položka nadväzuje
AI nevie sama rozhodnúť, či je starý dokument stále platný. Ak dostane dve protichodné informácie bez kontextu, môže ich spojiť do odpovede, ktorá vyzerá presvedčivo, ale používateľovi nepomôže.
Problém teda nie je v tom, že firma má málo dokumentov. Problém je, že dokumenty netvoria riadený systém znalostí.
Skutočné náklady (čas, chaos, riziko)
Neusporiadaná znalostná báza vytvára rovnaké problémy pre ľudí aj pre AI.
Support musí overovať odpovede u seniorov. Nový kolega nevie, ktorý návod je správny. Tester pri regresii nevie, či je popísané správanie aktuálne alebo len historická výnimka.
Pri AI sa riziko zrýchli:
- AI môže odporučiť neplatný workaround
- môže zameniť klientsku úpravu za štandardné správanie
- môže preskočiť dôležitý krok diagnostiky
- support musí každú odpoveď kontrolovať
- dôvera v dokumentáciu aj v AI postupne klesá
Ak tím musí odpoveď vždy overovať ručne, AI neznižuje záťaž. Len pridáva ďalší zdroj, ktorý treba kontrolovať.
Minimálny model riešenia
Každá položka znalostnej bázy nemusí byť dlhá. Musí však mať jednotnú a použiteľnú štruktúru.
Minimálny model môže vyzerať takto:
| Časť položky | Čo obsahuje |
|---|---|
| Symptóm | Čo používateľ alebo support reálne vidí |
| Rozsah | Modul, verzia, Core alebo konkrétny klient |
| Príčina | Overený dôvod problému |
| Diagnostika | Čo treba skontrolovať pred zásahom |
| Riešenie | Presný odporúčaný postup |
| Stav | Aktívne riešenie, workaround alebo zastaraný postup |
| Väzby | Súvisiaci bug, incident, konfigurácia alebo návod |
| Vlastník | Kto potvrdzuje správnosť a aktualizáciu obsahu |
Príklad:
Používateľovi sa nevytvorí faktúra.
Samotný názov článku nestačí. Záznam musí rozlišovať, či príčinou je chýbajúca konfigurácia, neuzavretá objednávka, integračná chyba alebo klientská úprava procesu. Až potom môže support alebo AI nájsť postup, ktorý patrí k danému prípadu.
Dôležité je aj označenie neplatných postupov. Starý workaround nemusí byť odstránený, ak pomáha pri analýze historického incidentu. Musí však byť jasne označený ako nepoužiteľný pre aktuálnu prevádzku.
Prepojenie na kvalitu a workflow
Znalostná báza sa nestane pripravenou pre AI jednorazovým presunom dokumentov do nového nástroja.
Vzniká v bežnom workflow projektu:
- pri incidente sa zapíše overená príčina a riešenie
- pri oprave bugu sa aktualizuje súvisiaci návod
- pri zmene konfigurácie sa preverí dopad na support položky
- pri release sa označia postupy, ktoré už neplatia
- pri klientskom rozšírení sa oddelí Custom správanie od Core
Toto má byť súčasť Definition of Done. Nie iba technické dokončenie zmeny, ale aj overenie, či zmena potrebuje nový alebo upravený záznam v znalostnej báze.
Takáto báza pomáha aj bez AI. Skracuje onboarding, znižuje závislosť na konkrétnych ľuďoch a dáva supportu opakovateľný postup. AI potom pracuje nad usporiadanými a kontrolovanými znalosťami, nie nad náhodným archívom textov.
Krátke zhrnutie
Znalostná báza pre AI nie je priečinok s dokumentmi.
Je to systém, v ktorom má každá informácia kontext, vlastníka, stav a väzbu na reálny proces. Ak sa podľa nej nedá bezpečne rozhodnúť človek bez telefonátu seniorovi, nebude podľa nej spoľahlivo odpovedať ani AI.