AI

Dokumentácia a používateľské príručky

Šablóna znalostnej položky pripravenej pre AI alebo RAG

/

Táto šablóna slúži na vytvorenie samostatnej znalostnej položky, ktorú môže používať človek, interné vyhľadávanie, AI asistent alebo RAG riešenie.

Jedna znalostná položka má riešiť jednu konkrétnu tému, postup, pravidlo alebo problém. Nemá spájať viac nesúvisiacich oblastí do jedného dokumentu.

1. Základné údaje

Názov znalostnej položky:

Interný identifikátor:

Typ znalosti:

  • pracovný postup
  • pravidlo
  • riešenie problému
  • opis funkcionality
  • konfigurácia
  • obmedzenie
  • známy problém
  • vysvetlenie pojmu
  • iné:

Modul alebo oblasť systému:

Produkt:

Verzia produktu:

Prostredie:

  • produkcia
  • testovacie prostredie
  • vývojové prostredie
  • všetky prostredia
  • iné:

Rozsah platnosti:

  • Core
  • Custom
  • Core s klientskou výnimkou
  • konkrétny zákazník:

Používateľská rola:

Cieľová skupina:

  • používateľ
  • administrátor
  • technická podpora
  • tester
  • vývojár
  • integrátor
  • AI asistent
  • iná:

2.

…
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

Metadáta a pôvod informácie: čo musí AI vedieť o každom zdroji

/

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

Reálny problém z praxe

Pracovníčka supportu riešila objednávku, ktorá po úspešnej platbe zostala v stave Čaká na platbu. Interného AI asistenta sa opýtala:

„Ako máme opraviť stav objednávky po úspešnej platbe?“

AI našla konkrétny postup:

  1. Skontrolovať výsledok platby v platobnej bráne.
…
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.…

Ako testovať..., Testovanie umelej inteligencie

Testovanie AI

/

Testovanie AI (umelej inteligencie) sa líši od klasického testovania softvéru hlavne tým, že výsledok nie je vždy jednoznačný a očakávaný výstup môže byť do istej miery „približný“ alebo „pravdepodobný“. Napriek tomu existujú overené prístupy, ako testovať AI systematicky:

1. Typy AI, ktoré testujeme
Najčastejšie testované sú:
• ML modely (napr.…

Ako testovať..., Testovanie umelej inteligencie

Ukážka ako testovať manuálne AI – postup

/

Nižšie nájdeš konkrétnu šablónu manuálneho testovacieho prípadu pre AI-chatbota, ktorú si môžeš priamo skopírovať a vyskúšať. Stačí si pripraviť prístup do konzoly/chat-UI, zadať vstupy a podľa výstupov doplniť stĺpce „Skutočný výstup“, „Výsledok“ a „Poznámka“.

 

Šablóna manuálneho testu (Markdown)

ID Scenár / Persona Vstup (prompt) Očakávaný výstup Skutočný výstup Výsledok Poznámka
TC1 Zákazníčka chce vedieť stav objednávky „Ako zistím stav mojej objednávky č.
…
Ako testovať..., Testovanie umelej inteligencie

Sprievodca testovania AI

/

1. Plánovanie testovania AI-aplikácie

  1. Definuj rozsah a ciele

    • Funkčná časť: čo má aplikácia poskytovať (knihovňa klasifikácie, chatbot, doporučovací engine…).
    • Nefunkčná časť: výkon, latencia, bezpečnosť, etickosť (biznis pravidlá).

  2. Identifikuj komponenty systému

    • Predspracovanie dát (cleaning, tokenizácia, normalizácia).
    • Model (ML pipeline, inferenčný engine).
    • Ovládacie API / UI (rozhranie pre zadanie vstupu/výstupu).
…
Ako testovať..., Testovanie umelej inteligencie

Slovník AI a Machine Learning pojmov

/

Prehľad kategórií

  1. Základné pojmy AI/ML
  2.  Typy Machine Learningu
  3. Jazykové modely (LLM) a generatívna AI
  4. Parametre, roly a kontext LLM
  5. Architektúry modelov
  6. Dátová kvalita a integrita
  7. Monitorovanie a údržba modelov
  8. Etické princípy a regulácie AI
  9. Praktická práca s AI a agentmi
  10. Automatizácia a infraštruktúra
  11. Nástroje a frameworky

Základné pojmy AI/ML

Artificial Intelligence (AI)
Umelá inteligencia – schopnosť systému učiť sa, rozhodovať a adaptovať sa na základe dát bez explicitného programovania.…

Návrat hore