Tudás
Márkánként egyetlen képernyő sorolja fel mindazt, amit az AI-d olvashat — tudásbázisokat, dokumentációkat, fájlokat, weboldalakat és kérdés-válasz párokat —, azzal együtt, hogy melyik mennyivel járul hozzá, és melyiket érik el a látogatók a nyilvános webcímeden.
Hol találod
Márka → Tudás. Az oldal fejléce: Tudásforrások.
Nincs többé szervezetszintű tudásbázis-lista, nincs szervezetszintű dokumentáció-lista, és az AI ügynöknek sincs már Kontextus füle. Egyszerre egy márka tudását látod; ha márkát váltasz, a lista is vált.
A képernyő két fele
Tudásbázis és dokumentáció
A felső fele, a képernyőn Tudásbázis és dokumentáció néven. Strukturált tartalom, amit te írsz és rendszerezel: tudásbázisok (cikkek az ügyfeleknek) és dokumentációk (technikai oldalak). Egy-egy közülük a nyilvános webcímeden is kiszolgálható.
Minden más, amit az AI olvas
Az alsó fele. Beillesztett szöveg, kérdés-válasz párok, feltöltött fájlok, weboldalak, amelyeket beolvastunk neked, és API-eszközök. Ezek soha nem nyilvánosak — kizárólag azért vannak, hogy az AI olvassa őket.
Mit jelentenek az oszlopok
| Oszlop | Mit mond el |
|---|---|
| Név | Megnyitja az adott tudásbázis vagy dokumentáció szerkesztőjét. |
| Típus | Tudásbázis vagy Dokumentáció. |
| Nyelv | Az a nyelv, amelyen a tartalom íródott. Ez határozza meg, hogyan keres benne az AI, és semmit nem fordít le. Közvetlenül a táblázatban módosítod; a mellette lévő +n azt jelenti, hogy további fordítások is be vannak állítva. |
| Elemek | Cikkek a tudásbázisban, oldalak a dokumentációban. A piszkozatok is beleszámítanak. |
| Nyilvános oldal | Élő — ezt érik el a látogatók a webcímeden — vagy Rejtett. Egyszerre egy tudásbázis és egy dokumentáció lehet Élő. |
| Indexelve | Hány kereshető darabot tárolt el belőle az AI. Egy cikkből általában több lesz, és csak a közzétett elemek kerülnek be. A gondolatjel azt jelenti, hogy még semmi. |
A közzététel tanítja meg az AI-t
A közzététel azonnal indexeli a cikket. Nem kell hozzá chat widget és nem kell AI ügynök sem, így egy olyan márka is felépíti a tudást, amelynek sehol nincs chatbuborékja — abból válaszol a hangügyintézője és a beérkezett üzenetek javaslata. A visszavonás eltávolítja, egy közzétett cikk szerkesztése pedig csak azt az egy cikket indexeli újra.
Ki nyithatja meg ezt a képernyőt
Egy csapattagnak a három jogosultság bármelyike elég: Vex, Tudásbázis vagy Dokumentáció. Odabent mindkét fél a sajátját ellenőrzi — a tudásbázis-sorokhoz Tudásbázis, a dokumentáció-sorokhoz Dokumentáció kell, az alsó felet pedig csak a Vex jogosultsággal rendelkezők látják. Ha a csomagod nem tartalmazza a Dokumentáció modult, az Új dokumentáció lezárt „Dokumentáció — csomagváltással” bejegyzésként jelenik meg, ahelyett hogy kattintásra hibára futna.
Indexelt elemek az ingyenes csomagban
Tudásbázis vagy dokumentáció
A Yaplet kétféle strukturált tartalmat kínál. Más olvasót szolgálnak ki, és egy márkában mindkettő elfér.
Tudásbázis
Cél: Ügyfeleknek szóló súgócikkek egyszerű, közérthető nyelven
Tartalom stílusa: Szöveg és mondatok, rugalmas HTML-szerkesztéssel
Szerkesztő: HTML cikkszerkesztő
Hol olvassák: A nyilvános webcímeden, ha ez van kiszolgálva, valamint a chat widget Súgó fülén
Leginkább alkalmas: Ügyfélszolgálati kérdésekhez, GYIK-hez, hibaelhárításhoz, termékbemutatókhoz
Dokumentáció
Cél: Műszaki dokumentáció strukturált, fejlesztőknek szóló tartalommal
Tartalom stílusa: Formázott műszaki részletek markdown komponensekből
Szerkesztő: Markdown cikkszerkesztő
Hol olvassák: A nyilvános webcímeden, ha ez van kiszolgálva
Leginkább alkalmas: API-referenciákhoz, műszaki specifikációkhoz, fejlesztői útmutatókhoz, strukturált kézikönyvekhez
Mindkettő pontosan ugyanúgy táplálja az AI-t, függetlenül attól, hogy fent van-e a nyilvános címeden.
Mikor válaszd a tudásbázist
- Ügyfélszolgálati kérdések: „Hogyan állítom vissza a jelszavamat?” vagy „Hogyan válthatok nagyobb csomagra?”
- Termékbemutatók: lépésről lépésre útmutatók a funkciók használatához
- Hibaelhárítás: gyakori problémák és megoldásaik, hétköznapi nyelven
- GYIK jellegű tartalom: bármi, amit a chatbeszélgetésben is elérhetővé tennél
Mikor válaszd a dokumentációt
- API-dokumentáció: specifikációk, végpontok és kódpéldák
- Fejlesztői útmutatók: integrációs utasítások, SDK-dokumentáció, műszaki munkafolyamatok
- Rendszerkonfiguráció: részletes beállítási eljárások
- Műszaki specifikációk: komponensalapú tartalom, ami precíz formázást igényel
Döntési szempontok
- Tudásbázis: ügyfelek, végfelhasználók, nem műszaki közönség
- Dokumentáció: fejlesztők, műszaki csapatok, rendszergazdák :::
- Tudásbázis: rugalmas HTML-cikkek, közvetlen hangnem, gazdag média
- Dokumentáció: strukturált markdown, műszaki komponensek, kódpéldák :::
- Tudásbázis: a nyilvános webcímeden és a chat widget Súgó fülén
- Dokumentáció: a nyilvános webcímeden, műszaki portálként :::
- Tudásbázis: kevesebb támogatási jegy, önkiszolgáló súgó
- Dokumentáció: fejlesztői bevezetés, API-integráció, műszaki referencia ::: ::
Hogyan épül fel a kettő
Mindkettő három szint mély, és a középső szint az, ami mentén az olvasó tájékozódik.
- A tudásbázis kategóriákat tartalmaz, a kategóriák pedig cikkeket. A kategóriák egymásba is ágyazhatók.
- A dokumentáció kategóriákat tartalmaz, a kategóriák pedig oldalakat. Egy oldal alá további aloldalak kerülhetnek, így egyetlen kategória egész fát hordozhat.
Egyiket sem a csomagod adagolja. A csomagod azt dönti el, hogy a Dokumentáció modul egyáltalán elérhető-e neked — nem azt, hány dokumentációt vagy cikket hozhatsz létre.
Olvasd tovább
Kategóriák és cikkek
Rendszerezd a tartalmat beágyazott kategóriákba, tegyél közzé cikkeket, és olvasd el a látogatók értékeléseit.
Cikkek szerkesztése
Cikkbeállítások, az AI írási eszközei, és hogy pontosan mit csinál a Közzétéve kapcsoló.
Dokumentációk
A dokumentációs oldal: hozz létre dokumentációt, rendszerezd a kategóriáit és oldalait, és szabd meg, mi legyen közzétéve.
Dokumentáció írása
Az osztott nézetű markdown szerkesztő, az oldalfa, a kész komponensek és az AI írási eszközei.
Megosztási linkek
Adj át bárkinek egy cikket, oldalt, kategóriát vagy egész forrást linkként — és melyik fajta éli túl az átnevezést.
A nyilvános webcímed
Mit találnak a látogatók a címeden, hogyan választod ki, mi legyen ott, és miért nem töröl semmit a levétel.
Tartalom másolása és áthelyezése márkák között
A Másolás önálló duplikátumot készít, ami piszkozatként érkezik; az Áthelyezés az eredetit adja át mindazzal, amit megtanult.
::