Két eszköz, két feladat
A Yapletben kétféleképpen tehetsz közzé tartalmat, amelyet az ügyfeleid és a csapatod olvashat:
- Tudásbázis — szöveges súgócikkek végfelhasználóknak. A látogatók a widget Browse lapjáról és egy nyilvános súgóközpont-URL-ről érhetik el. A Vex AI automatikusan tanul minden közzétett cikkből.
- Dokumentáció — hosszabb, markdown-alapú oldalak fejlesztőknek vagy haladó felhasználóknak. Külön nyilvános portálon jelenik meg. A widget Browse lapján nem érhető el.
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, ha strukturált, kód-intenzív formátumot igénylő technikai tartalmaid vannak.
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 (Browse lap).
- A tartalom köznyelvi: „Hogyan állítom vissza a jelszavam?", „Mit csinál az X gomb?"
- Azt szeretnéd, hogy a Vex AI hivatkozzon a cikkre, amikor automatikusan válaszol 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.
- Kódblokkokra van szükséged szintaxiskiemelő jelölőkkel (pl. ` ```javascript `), MDC-komponensekre (callout, steps) vagy mélyen egymásba ágyazott oldalstruktúrára.
- Megfelel neked egy külön nyilvános portál — a dokumentáció nem jelenik meg a widget Browse lapján.
A főbb különbségek egy táblázatban
| Jellemző | Tudásbázis | Dokumentáció |
|---|---|---|
| Szerkesztő | Szöveges (Tiptap / HTML) | Markdown MDC-komponensekkel |
| Elsődleges célközönség | Végfelhasználók | Fejlesztők / technikai felhasználók |
| Widget Browse lap | Igen | Nem |
| Vex AI tudásforrás | Igen — automatikusan | Igen — ha az oldalak közzé vannak téve |
| Nyilvános portál | Igen | Igen (külön URL-en) |
| Kérdezd az AI-t a nyilvános portálon | Nem | Igen — a látogatók egy AI-jal cseveghetnek, amely a doksijaid alapján válaszol |
| Többnyelvűség | Igen — cikkenként fordítások | Dokumentációnkénti nyelvi beállítás |
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. A két termék független egymástól; normál külső URL-ekkel hivatkozhatsz egyikből a másikra.
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.