Hol található mindkettő
A tudásbázis és a dokumentáció is olyan tartalom, amit az ügyfeleid elolvashatnak és az AI-d is felhasználhat a válaszaihoz, és mindkettő ugyanazon a képernyőn van: Márka → Tudás. A felső táblázat felsorolja az összeset, ami a márkádhoz tartozik (lásd: mi a márka a Yapletben).
Egy cikk vagy oldal közzététele az, amitől az AI-d olvashatja. Semmit nem kell előtte összekötni — ehhez nem kell sem AI ügynök, sem chat widget.
Két eszköz, két feladat
- Tudásbázis — végfelhasználóknak írt, formázott súgócikkek. A látogatók a chat widget Súgó füléről és a márkád nyilvános webcíméről érik el őket. Minden közzétett cikk bekerül az AI-d tudásába.
- Dokumentáció — hosszabb, markdown-alapú oldalak fejlesztőknek vagy haladó felhasználóknak. Ugyanazon a webcímen, de külön útvonalon szolgálódik ki, és nem jelenik meg a widget Súgó fülén. A dokumentáció fizetős kiegészítő modul havi 19 amerikai dollárért, így egy vadonatúj fiókhoz nem jár.
Ha nem tudod, melyikkel kezdj, a legtöbb csapatnak a válasz: kezdd a tudásbázissal. A dokumentációt később is hozzáadhatod, amikor már van strukturált, kód-intenzív formázást igénylő technikai tartalmad.
Akkor válaszd a tudásbázist, ha…
- A célközönséged végfelhasználó — valaki, aki megvette a terméked, és segítségre van szüksége a használathoz.
- Azt szeretnéd, hogy a cikk elérhető legyen a chat widgetből (a Súgó fülről).
- A tartalom köznyelvi: „Hogyan állítom vissza a jelszavam?”, „Mit csinál az X gomb?”
- Azt szeretnéd, hogy az AI-d automatikusan ebből válaszoljon a látogatók kérdéseire.
- A cikkek rövid–közepes hosszúságúak, képekkel, felsorolásokkal és lépésről lépésre haladó útmutatókkal.
Akkor válaszd a dokumentációt, ha…
- A célközönséged fejlesztő vagy rendszergazda.
- A tartalom strukturált és technikai: API-referenciák, SDK-útmutatók, konfigurációs kézikönyvek.
- Nyelvi címkével ellátott kódblokkokra, MDC-komponensekre (callout, steps) vagy mélyen egymásba ágyazott oldalstruktúrára van szükséged.
- Megfelel neked egy külön nyilvános oldal — a dokumentáció nem jelenik meg a widget Súgó fülén, viszont a fülön lehet rá mutató link.
A főbb különbségek egy táblázatban
| Jellemző | Tudásbázis | Dokumentáció |
|---|---|---|
| Szerkesztő | Formázott szöveg | Markdown MDC-komponensekkel |
| Elsődleges célközönség | Végfelhasználók | Fejlesztők / technikai felhasználók |
| Jár egy új fiókhoz | Igen | Nem — fizetős modul havi 19 amerikai dollárért |
| Widget Súgó fül | Igen — a cikkek ott listázódnak és kereshetők | Nem — de a fülön megjelenhet rá mutató link |
| Az AI-d olvassa | Igen — abban a pillanatban, ahogy közzéteszel egy cikket | Igen — abban a pillanatban, ahogy közzéteszel egy oldalt |
| Nyilvános webcím | Igen, itt: /k/ |
Igen, itt: /d/ |
| Kérdezd az AI-t a nyilvános oldalon | Nem — csak keresés | Igen — a látogatók egy AI-val cseveghetnek, amely az oldalaidból válaszol |
| Nyelvek | Nyelvenként egy cikk, egyesével lefordítva | Dokumentációnként egy nyelv |
Használhatom mindkettőt?
Igen — és sok csapat ezt teszi. Gyakori megoldás, hogy a tudásbázist ügyfélszolgálati cikkekhez, a dokumentációt pedig API-referenciához vagy integrációs útmutatóhoz használják. Függetlenek egymástól, és egyszerre egy-egy lehet belőlük a márkád nyilvános webcímén.
A kezdéshez válaszd azt, amelyik az első tartalmadhoz illik. Ha végfelhasználóidnak szánt súgócikkeket szeretnél írni, hozd létre az első tudásbázis-cikkedet. Ha fejlesztői referenciát építesz, állítsd be a dokumentációs oldaladat.