Dokumentációk

Egy dokumentáció egy teljes dokumentációs portál, amely egy márkához tartozik. A kategóriák oldalakat tartalmaznak, egy oldal közzététele nyilvánossá teszi és egyben a márka AI-ját is tanítja, és egyszerre egy dokumentáció lehet a márka nyilvános webcímén.

Dokumentációk

A dokumentáció a legfelső szintű konténer, amely egy teljes oldalcsomagot tartalmaz. A dokumentációk sorokként jelennek meg itt: Márka → Tudás, a márka tudásbázisai mellett — a menüben már nincs külön Dokumentáció menüpont.

Egy márkához több dokumentáció is tartozhat, és mindegyik táplálja a márka AI-ját. Egyszerre viszont csak egy kerülhet ki a márka nyilvános webcímére; hogy melyik, azt a Nyilvános oldal oszlop mutatja, Élő vagy Rejtett jelöléssel.

A Dokumentáció fizetős modul — havi 19 dollár a csomagod árán felül (forintos számlázás esetén 5 990 Ft). Nem része annak a hozzáférésnek, amit egy új szervezet alapból megkap. Ha nincs meg, az Új gomb továbbra is megnyitja a menüjét, de a benne lévő dokumentáció-sor kiszürkítve, lakat ikonnal jelenik meg, és a „Dokumentáció — csomagváltással” feliratot mutatja. (Olyan márkánál, amelynek még se tudásbázisa, se dokumentációja nincs, ugyanez a felirat nem menüsorként, hanem letiltott gombként jelenik meg.)

Létrehozás, törlés és megosztás márkák között

A Tudás képernyő Új gombjával hozhatsz létre egyet: válaszd az Új dokumentáció lehetőséget. Az alapértelmezett Dokumentáció névvel jön létre, és rögtön a szerkesztőjében találod magad.

Törölni a sor menüjéből tudsz. A megerősítés megnevezi, mi vész el („12 oldal és a kategóriáik”), közli, hogy az AI-d azonnal abbahagyja a válaszolást ebből a tartalomból, és egy második bekezdést is hozzátesz, ha éppen ez a dokumentáció van a nyilvános címeden — az a cím semmit nem fog mutatni, amíg mást nem teszel oda. Ez nem vonható vissza.

Ugyanez a menü kínálja a Másolás másik márkába… és az Áthelyezés másik márkába… lehetőséget. Mindkettő szürke marad, amíg a fiókodban csak egy márka van.

Dokumentáció beállítások

Minden dokumentációnak saját Beállítások oldala van:

  • Cím — a dokumentáció neve
  • Nyelv — az a nyelv, amelyen a tartalom íródott. Ez határozza meg, hogyan keres benne az AI, és semmit nem fordít le. A módosítás az ezután indexelt tartalomra vonatkozik; a már eltárolt oldalak addig a korábbi beállítással maradnak, amíg újra nem publikálod őket.
  • Widgetek — a márka chat widgetje, ha van ilyen, gombként megjelenítve, amely megnyitja a widget-szerkesztőt. Innen semmit nem lehet csatolni vagy leválasztani; erre a Kezelés a márka Tudás oldalán → hivatkozás visz át.
A logót már nem dokumentációnként állítod be. A márkától jön: Márkabeállítások → Márkaképek → Márkalogó. Ez egy fő kép, plusz egy opcionális második változat, amely vagy a világos, vagy a sötét módhoz tartozik — szándékosan nem világos/sötét pár, mert a legtöbb logó mindkét háttéren jól olvasható, a két félig kitöltött mező pedig az egyik módot üresen hagyta. A dokumentáció saját beállítások oldalán most egy értesítés jelzi, hogy a logó a márkához került, Márkabeállítások megnyitása gombbal.
Amíg egy dokumentáció egyetlen márka nyilvános címén sincs rajta, a beállítások oldala ezt mutatja: „Nem nyilvános — Ez a dokumentáció egyetlen márka nyilvános címén sincs rajta, így a látogatók nem érhetik el.” A márka Tudás képernyőjén teheted ki a címre, a sor menüjének Megjelenítés itt: <a-webcímed> pontjával.

Kategóriák

A kategóriák logikai csoportokba rendezik a dokumentációs oldalakat egy dokumentáción belül. Navigációs struktúrát biztosítanak, és segítenek a felhasználóknak gyorsan megtalálni a releváns információkat.

Kategória beállítások

A kategóriák egyszerű beállításokkal rendelkeznek:

  • Név - A kategória megjelenítési neve
  • Leírás - Rövid leírás a kategória listázásokhoz

Kategória kezelés

A kategóriák súly szerint vannak rendezve, ami meghatározza a megjelenítési sorrendjüket. Használd a fel/le nyilakat a kategóriák átrendezéséhez.

Az alacsonyabb súlyszámú kategóriák jelennek meg először. Tervezd meg a kategória sorrendet a felhasználói elvárásoknak megfelelően.

Publikálás és láthatóság

A dokumentációs tartalom publikálható vagy visszavonható mind kategória, mind oldal szinten, így finom kontrollt biztosít afelett, hogy milyen tartalom érhető el nyilvánosan és az AI tudásbázisban.

Kategória publikálás

A kategóriák publikálhatók vagy visszavonhatók a beállítások oldalukon. Amikor egy kategória nincs publikálva:

  • A kategórián belüli összes oldal elérhetetlenné válik az AI feldolgozás számára
  • A kategória eltűnik a nyilvános dokumentáció navigációjából
  • A gyermek oldalak nem publikáltak maradnak, még ha a kategóriát később újra publikálod is
Egy kategória visszavonása automatikusan visszavonja az összes gyermek oldalt és eltávolítja őket az AI tudásbázisból. Egy kategória újbóli publikálása nem publikálja automatikusan az oldalait.

Oldal publikálás

Az egyes oldalak függetlenül publikálhatók vagy visszavonhatók, a következő hatásokkal:

  • Publikált oldalak: Elérhetők a nyilvános dokumentációban és feldolgozásra kerülnek az AI tudásbázis számára
  • Nem publikált oldalak: Rejtettek a nyilvános nézetből és kizártak az AI feldolgozásból
  • Szülő oldal függőség: Egy oldal nem publikálható, ha a szülő oldala nincs publikálva
Használd az állapotjelzőket (zöld pontok a publikáltakhoz, piros pontok a piszkozatokhoz, sárga pontok a publikált oldalakhoz nem publikált gyermekekkel) a hierarchia fában és a kategória fejlécben a tartalmad publikálási állapotának gyors áttekintéséhez.

Tömeges publikálás

Nagy dokumentációs fák kezelésekor egyszerre több oldalt is publikálhatsz vagy visszavonhatsz:

  • Szülő oldal menüjéből: Használd az "Összes gyermek publikálása" vagy "Összes gyermek visszavonása" opciót bármely gyermek oldalakkal rendelkező oldal hárompontos kontextus menüjében. Az "Összes gyermek publikálása" opció csak akkor érhető el, ha maga a szülő oldal már publikálva van.
  • Kategória fejlécből: Kattints a hárompontos menüre a kategória neve mellett az "Összes oldal publikálása" vagy "Összes oldal visszavonása" eléréséhez a kategória összes oldalára. Az "Összes oldal publikálása" megköveteli, hogy a kategória előbb publikálva legyen.
  • Szülő publikálásakor: Miután publikálsz egy oldalt, amelynek nem publikált gyermekei vannak, felkínálásra kerül a gyermekek opcionális publikálása is.

Amikor a céloldalak bármelyikének saját beágyazott gyermekei vannak, választhatsz a csak közvetlen gyermekek vagy összes beágyazott gyermek (beleértve az unokákat és mélyebb szinteket) publikálása között.

A tömeges publikálás csak a jelenleg nem publikált oldalakat érinti (és fordítva a tömeges visszavonásnál). A már célállapotban lévő oldalak kihagyásra kerülnek. Csak az újonnan módosított oldalak kerülnek feldolgozásra az AI tudásbázis számára, így a művelet hatékony marad.

AI tudásbázis integráció

Csak a publikált kategóriákban lévő publikált oldalak kerülnek feldolgozásra az AI tudásbázis számára, és amit táplálnak, az a márka tudása — ugyanaz a készlet, amelyből a márka chatje, a telefonhívások, a beérkezett üzenetek válaszjavaslatai és az AI közösségi posztok is dolgoznak:

  • A tartalom publikálása azonnal hozzáadja a márka tudásához (a feldolgozás egy pillanatot vehet igénybe). Ehhez sem chat widgetnek, sem AI ügynöknek nem kell léteznie.
  • A tartalom visszavonása azonnal eltávolítja a márka tudásából.
  • A rendszer megakadályozza oldalak publikálását nem publikált kategóriákban.
Minden publikált oldalból egy vagy több kereshető darab lesz, amelyeket a márka Tudás képernyőjén az Indexelve oszlop számol. Ezek a darabok a fiókod indexelt elemekre vonatkozó keretét fogyasztják, amely minden márka, minden tudásbázis és minden dokumentáció között közös.

Nyilvános dokumentáció viselkedés

A publikált tartalom a következő szabályokat követi a nyilvános dokumentációban:

  • Csak a publikált kategóriák jelennek meg a navigációs sávban
  • Csak a publikált oldalak érhetők el nyilvános linkeken keresztül
  • A nem publikált tartalom teljesen rejtett a külső felhasználók elől
  • A nem publikált tartalomhoz tartozó megosztási linkek nem működnek

Nyilvános dokumentáció navigáció

Amikor egy dokumentáció egy márka webcímén szolgálódik ki, a kategóriák navigációs sávként jelennek meg a fejléc alatt, ha több kategória van.

A kategóriák navigációs sávként jelennek meg a fejléc alatt, ha több kategória van egy dokumentációban.

A nyilvános dokumentációs felületről további részletekért lásd a nyilvános dokumentáció útmutatónkat.

Ha egy dokumentáció csak egy kategóriát tartalmaz, a navigációs sáv el van rejtve a tisztább olvasási élmény érdekében.

A kategória nevek vagy struktúra módosítása elronthatja a meglévő megosztási linkeket. Fontold meg a hatást, mielőtt jelentős változtatásokat végzel.