Súgó eszközök | Yaplet HU

Áttekintés

Az irányítópultod asszisztenséből, a Vexből vagy egy csatlakoztatott AI alkalmazásból egy AI felépítheti a nyilvános súgótartalmaidat: a tudásbázisokat (HTML-ben írt súgócikkek) és a dokumentációkat (Markdown oldalakból álló dokumentációs portálok). Létrehozhatja őket, kategóriákba rendezheti, maga írhat cikkeket és oldalakat vagy AI-jal íratja meg őket, és közzéteheti vagy visszavonhatja őket. Az AI a lenti műveleteket a find_actions eszközzel keresi meg, és mindegyiket a fajtájához tartozó futtató eszközzel indítja el — lásd az MCP Szerver oldalt.

A Vexben az oldalon szereplő minden művelet előbb a Megerősítés gombra vár. Mindegyik bekerül az Audit naplóba AI módosítás bejegyzésként.

Szükséges jogosultság:Knowledgebase a kb.* műveletekhez, Documentation a docs.* műveletekhez.

A közzététel azonnal indexeli az elemet, és ehhez nem kell sem chatbot, sem widget. Az indexelt tartalom a márkához tartozik, így minden, ami az adott márka nevében válaszol — a chat, a telefon, az inbox javasolt válaszai és az AI közösségi posztok — a közzététel pillanatától használhatja.

Műveletek

Művelet	Szint	Mit csinál
`kb.create`	Módosítás	Létrehoz egy tudásbázist egy márkában. A márkát a `brandId`-val kell megnevezni; csak akkor hagyható el, ha csak egyetlen márkához férsz hozzá, a csak bizonyos márkákhoz hozzáférő tag pedig csak ezeket a márkákat használhatja.
`kb.update`	Módosítás	Átnevez egy tudásbázist, vagy megváltoztatja a nyelvét.
`kb.create_category`	Módosítás	Kategóriát hoz létre a cikkeknek egy tudásbázisban, a legfelső szinten vagy egy másik kategórián belül.
`kb.update_category`	Módosítás	Megváltoztatja egy kategória nevét, leírását, szülőkategóriáját vagy helyét a sorrendben.
`kb.create_article`	Módosítás	Cikket hoz létre az AI által megadott HTML szövegből. A cikk közzététel nélkül jön létre.
`kb.update_article`	Módosítás	Megváltoztatja egy cikk címét, szövegét, kategóriáját vagy helyét a sorrendben.
`kb.write_article_with_ai`	Módosítás	Egy rövid leírásból AI-jal megírat egy új cikket, vagy újraíratja egy meglévő cikk szövegét. Az új cikk közzététel nélkül jön létre. AI krediteket használ.
`kb.set_article_published`	Módosítás	Közzétesz vagy visszavon egy cikket a súgóközpontodban.
`kb.list_article_backlinks`	Olvasás	Felsorolja ugyanannak a tudásbázisnak azokat a cikkeit, amelyek egy cikkre hivatkoznak, cikkenként a hivatkozások számával és azzal, hogy közzé van-e téve — ez a szerkesztő Hivatkozó cikkek panelje. Nézd meg, mielőtt visszavonsz vagy lecserélsz egy cikket.
`docs.create`	Módosítás	Létrehoz egy dokumentációt egy márkában. A márkát a `brandId`-val kell megnevezni; csak akkor hagyható el, ha csak egyetlen márkához férsz hozzá, a csak bizonyos márkákhoz hozzáférő tag pedig csak ezeket a márkákat használhatja.
`docs.update`	Módosítás	Átnevez egy dokumentációt, vagy megváltoztatja a nyelvét.
`docs.create_category`	Módosítás	Kategóriát hoz létre egy dokumentációban. A kategória közzététel nélkül jön létre.
`docs.update_category`	Módosítás	Megváltoztatja egy dokumentációs kategória nevét, leírását vagy helyét a sorrendben.
`docs.create_page`	Módosítás	Dokumentációs oldalt hoz létre az AI által megadott Markdown szövegből, vagy csoportoldalt, amely csak más oldalakat tartalmaz. Az oldal közzététel nélkül jön létre.
`docs.update_page`	Módosítás	Megváltoztatja egy dokumentációs oldal címét, szövegét, leírását, kategóriáját, szülőoldalát, csoportoldal-beállítását vagy helyét a sorrendben.
`docs.write_page_with_ai`	Módosítás	Egy rövid leírásból AI-jal megírat egy új dokumentációs oldalt, vagy újraíratja egy meglévő oldal szövegét. Az új oldal közzététel nélkül jön létre. AI krediteket használ.
`docs.set_published`	Módosítás	Közzétesz vagy visszavon egy dokumentációs kategóriát vagy oldalt a nyilvános dokumentációdban.

Hogyan működik a közzététel

Minden, amit itt egy AI létrehoz, közzététel nélkül indul: a cikkek, a dokumentációs oldalak és a dokumentációs kategóriák is. Sem a látogatók, sem az AI ügynököd nem lát belőlük semmit, amíg közzé nem teszed őket, így az AI előbb piszkozatot írhat, és akkor teszi közzé, amikor szólsz.

A közzététel láthatóvá teszi az elemet, és azonnal indexeli a márka AI-ja számára. A visszavonás elrejti, és kiveszi abból, amit az AI tud.
A dokumentációs oldalak szülőinek előbb közzétettnek kell lenniük. Egy oldal csak akkor tehető közzé, ha a kategóriája — és ha van, a szülőoldala is — már közzé van téve.
Egy dokumentációs kategória vagy oldal visszavonása az alatta lévőket is visszavonja — a kategória összes oldalát, illetve az oldal összes aloldalát.
A tudásbázis-kategóriáknak nincs Közzétéve kapcsolójuk. Csak a cikkeknek van.
A megváltozott szöveg és az AI ügynök. Ha egy AI egy közzétett cikk szövegét módosítja, az AI ügynök automatikusan átveszi az új szöveget. Egy közzétett dokumentációs oldalnál ez nem történik meg: nyisd meg az oldalt az irányítópulton, és mentsd el egyszer, hogy frissüljön, amit az AI ügynök tud.
A nyelv azt határozza meg, hogyan keres a rendszer a szövegben. Semmit nem fordít le.

A Közzétéve nem ugyanaz, mint az Élő. Azt, hogy melyik teljes tudásbázist és melyik dokumentációt érik el a látogatók a márkád nyilvános webcímén, a Márka → Tudás képernyőn választod ki (mindegyik Élő vagy Rejtett). Ezt egy AI a widgets.set_public_help művelettel változtathatja meg, amely a Widget eszközök között szerepel, és a Márkák és chat widgetek jogosultságot igényli.

Amit egy AI itt nem tehet meg

Tudásbázist vagy dokumentációt törölni. Egy AI soha nem töröl olyan tárolót, amely a csapatod munkáját tartalmazza. Ezeket az irányítópulton, a Márka → Tudás képernyőn törölheted.
Cikkeket, dokumentációs oldalakat vagy kategóriákat törölni. Erre nincs művelet. Töröld őket az irányítópulton, a tudásbázison vagy dokumentáción belül a Márka → Tudás képernyőn.
Tudásbázist vagy dokumentációt másik márkába áthelyezni. A márkát a létrehozáskor kell megadni, a brandId-val. Utólagos áthelyezéshez vagy másoláshoz használd a sor menüjében az Áthelyezés másik márkába… vagy a Másolás másik márkába… pontot a Márka → Tudás képernyőn.

Példa promptok

„Hozz létre egy Támogatás nevű tudásbázist egy Első lépések kategóriával.”
„Írass AI-jal egy cikket a visszatérítési szabályainkról, és tedd a Számlázás alá. Még ne tedd közzé.”
„Tedd közzé az Első lépések cikket.”
„Hozz létre egy dokumentációs oldalt az API-hitelesítésről az API referencia kategóriában, aztán tedd közzé a kategóriát és az oldalt.”
„Helyezd át a Számlázási GYIK cikket a Fiókkezelés kategóriába.”