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

Áttekintés

A Súgó eszköz kategória kezeli a nyilvános súgó tartalmaidat — mind a Tudásbázisokat (HTML cikkek, amelyeket az ügyfeleid olvasnak), mind a Dokumentációt (Markdown oldalak technikai/fejlesztői portálokhoz). Manuálisan vagy AI segítségével hozhatsz létre tartalmat, kategóriákba szervezheted, és szabályozhatod a közzétételt.

Szükséges jogosultság:Knowledgebase a tudásbázis eszközökhöz, Documentation a dokumentáció eszközökhöz.

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.

Tudásbázis eszközök

manage_knowledgebase

Egységes eszköz a tudásbázisok, kategóriáik és cikkeik kezeléséhez. Az action paraméterrel választod ki a műveletet.

Műveletek

Művelet	Leírás	Kötelező paraméterek
`create`	Tudásbázis portál létrehozása	`name`
`update`	Tudásbázis portál frissítése	`id`
`create_category`	Kategória létrehozása a KB-ban	`knowledgebaseId`, `name`
`update_category`	Kategória frissítése	`id`
`create_article`	Cikk létrehozása (HTML)	`knowledgebaseId`, `title`, + `content` vagy `generateContent`
`update_article`	Cikk frissítése	`id`

Paraméterek

Paraméter	Típus	Használja	Leírás
`action`	string	Mind	A végrehajtandó művelet
`id`	string	update, update_category, update_article	Cél azonosító
`knowledgebaseId`	string	create_category, create_article	Szülő tudásbázis azonosító
`name`	string	create, create_category, update, update_category	KB portál vagy kategória név
`language`	string	create, update, create_article, update_article	Tartalom nyelve (alapértelmezés: `"en"`)
`description`	string vagy null	create_category, update_category	Kategória leírás
`parentId`	string vagy null	create_category, update_category	Szülő kategória azonosító beágyazáshoz
`position`	number	create_category, update_category, create_article, update_article	Rendezési pozíció (0-alapú). Kihagyás esetén automatikusan a végére kerül. Ha foglalt, a meglévő elemek lejjebb tolódnak.
`title`	string	create_article, update_article	Cikk címe. Automatikusan generál URL slug-ot.
`content`	string	create_article, update_article	HTML tartalom cikkekhez
`generateContent`	string	create_article, update_article	Írd le a cikket, és az AI generálja a HTML-t. Kölcsönösen kizárja a `content`-et.
`published`	boolean	create_article, update_article	Közzétételi státusz. Létrehozáskor alapértelmezetten `false`. Változtatása elindítja a beágyazási folyamatot.
`categoryId`	string vagy null	create_article, update_article	A cikk kategória hozzárendelése. Adj meg `null`-t a hozzárendelés megszüntetéséhez.

Hogyan működik

Tudásbázis portál: Konténer, amely kategóriákat és cikkeket tartalmaz. Hozd létre name-mel, frissítsd az átnevezéshez vagy nyelv módosításhoz.

Kategóriák: Szervezd a cikkeket szekciókba. Támogatja a hierarchikus beágyazást parentId-vel. A slug automatikusan generálódik a névből.

Cikkek: HTML-ben íródnak. Támogatják az AI tartalom generálást a generateContent-en keresztül. A slug-ok automatikusan generálódnak a címekből.

A generateContent egyenleget vagy előfizetést igényel. Ha az AI-val íratsz meg egy cikket vagy oldalt, azt ugyanúgy számlázzuk, mint bármelyik másik AI-generálást, és egy olyan szervezetet, aminek egyik sincs, ezzel utasítunk vissza: „AI generation needs credits. Top up your balance in Billing to keep generating." Ez korábban ingyen futott az előfizetés nélküli szervezeteknek. Ha te adod meg a content mezőt, az semmibe nem kerül.

Közzététel és AI indexelés:

Egy cikk közzététele azonnal indexeli azt, annak a márkának, amelyhez a tudásbázis tartozik.
A közzététel visszavonása eltávolítja az indexbejegyzést.
Közzétett cikk tartalmának frissítése automatikusan újraindexeli.
A published azt jelenti, hogy „ez az egy cikk egyáltalán megjelenik”. Hogy a teljes tudásbázis kiszolgálásra kerül-e a márka nyilvános címén, az egy másik beállítás — az irányítópulton a nyilvános oldalon néven szerepel, és minden forrás Élő vagy Rejtett jelölést kap a Márka → Tudás oldalon. Erre nincs MCP eszköz, és soha nem hívjuk közzétételnek.
A language a tudásbázis vagy az egyes cikk tartalmi nyelve. Azt dönti el, hogyan keresünk a szövegben; nem fordít le semmit.

Példa promptok

Hozz létre egy Támogatás nevű tudásbázist.
Hozz létre egy magyar nyelvű tudásbázist Sugó névvel.
Nevezd át a tudásbázisomat Ügyfélszolgálati dokumentáció-ra.
Hozz létre egy Első lépések kategóriát a Támogatás tudásbázisomban.
Hozz létre egy cikket Első lépések címmel a fiók beállításáról szóló tartalommal.
Írj egy cikket a visszatérítési szabályzatunkról — generáld a tartalmat AI-val.
Tedd közzé az Első lépések cikkemet.
Mozgasd a Számlázási GyIK cikket a Fiókkezelés kategóriába.

Dokumentáció eszközök

manage_documentation

Egységes eszköz a dokumentációs portálok, kategóriák és oldalak kezeléséhez. Az action paraméterrel választod ki a műveletet. A közzétételt külön a publish_documentation kezeli.

Műveletek

Művelet	Leírás	Kötelező paraméterek
`create`	Dokumentációs portál létrehozása	`title`
`update`	Dokumentációs portál frissítése	`id`
`create_category`	Kategória létrehozása	`documentationId`, `name`
`update_category`	Kategória frissítése	`id`
`create_page`	Oldal létrehozása (Markdown)	`documentationId`, `title`, `categoryId`, + `content` vagy `generateContent` (hacsak nem `isGroup`)
`update_page`	Oldal frissítése	`id`

Paraméterek

Paraméter	Típus	Használja	Leírás
`action`	string	Mind	A végrehajtandó művelet
`id`	string	update, update_category, update_page	Cél azonosító
`documentationId`	string	create_category, create_page	Szülő dokumentáció azonosító
`title`	string	create, create_page, update, update_page	Dokumentáció vagy oldal cím
`language`	string	create, update	Tartalom nyelve (alapértelmezés: `"en"`)
`name`	string	create_category, update_category	Kategória neve
`description`	string vagy null	create_category, update_category, create_page, update_page	Leírás
`content`	string	create_page, update_page	Markdown tartalom
`generateContent`	string	create_page, update_page	AI generál Markdownt. Kölcsönösen kizárja a `content`-et.
`categoryId`	string	create_page, update_page	Kategória hozzárendelés. Létrehozáskor kötelező.
`parentId`	string vagy null	create_page, update_page	Szülő oldal hierarchikus beágyazáshoz
`isGroup`	boolean	create_page, update_page	Strukturális csoport oldal (nem szükséges tartalom). Alapértelmezetten `false`.
`position`	number	create_category, update_category, create_page, update_page	Rendezési pozíció (0-alapú). Kihagyás esetén automatikusan a végére kerül. Ha foglalt, a meglévő elemek lejjebb tolódnak.

Hogyan működik

Dokumentációs portál: Konténer, amely kategóriákat és oldalakat tartalmaz. Hozd létre title-lal, frissítsd az átnevezéshez vagy nyelv módosításhoz.

Kategóriák: Szervezd az oldalakat szekciókba. A slug automatikusan generálódik a névből. Az új kategóriák közzé nem tett státusszal jönnek létre — használd a publish_documentation-t a közzétételükhöz.

Oldalak: Markdown-ban íródnak. Támogatják az AI tartalom generálást, hierarchikus beágyazást parentId-vel, és strukturális csoportokat (isGroup). A slug-ok automatikusan generálódnak a címekből. Az új oldalak közzé nem tett státusszal jönnek létre.

Megjegyzés: Ez az eszköz nem kezeli a közzétételt. Használd a publish_documentation-t a kategóriák és oldalak közzétételéhez vagy visszavonásához.

Példa promptok

Hozz létre egy Developer Docs nevű dokumentációt.
Hozz létre egy Első lépések kategóriát a dokumentációmban.
Hozz létre egy dokumentációs oldalt a REST API végpontjainkról.
Generálj egy első lépések útmutatót az SDK-t használó fejlesztőknek.
Hozz létre egy Útmutatók csoport oldalt és adj hozzá két gyermek oldalt alá.
Frissítsd a hitelesítési oldalt az új OAuth folyamat részletekkel.
Rendezd át az API referencia oldalt a 0-s pozícióba (első).

publish_documentation

Közzétesz vagy visszavon dokumentációs kategóriákat vagy oldalakat. Kezeli a függőségi validálást és a rekurzív műveleteket.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`type`	string	Igen	Mit teszel közzé: `"category"` vagy `"page"`
`id`	string	Igen	Kategória vagy oldal azonosító
`published`	boolean	Igen	`true` a közzétételhez, `false` a visszavonáshoz

Hogyan működik

Közzétételi szabályok:

Kategória közzététel: Beágyazza a kategória összes már közzétett oldalát AI lekéréshez.
Kategória visszavonás: A kategória összes oldalát közzé nem tett státuszra állítja és eltávolítja az AI index bejegyzéseiket.
Oldal közzététel: Szükséges, hogy a szülő oldal (ha van) ÉS a kategória már közzé legyen téve. Beágyazza az oldalt AI lekéréshez.
Oldal visszavonás: Rekurzívan visszavonja az összes gyermek oldalt és eltávolítja az AI index bejegyzéseiket.

Példa promptok

Tedd közzé az Első lépések kategóriát.
Vond vissza a régi API v1 kategóriát és az összes oldalát.
Tedd közzé a hitelesítési oldalt.
Vond vissza az elavult végpontok oldalt és gyermekeit.

Általános munkafolyamat minták

Teljes tudásbázis felépítése

Tudásbázis létrehozása → manage_knowledgebase az action: "create" beállítással
Szervezés kategóriákkal → manage_knowledgebase az action: "create_category" beállítással
Cikkek írása → manage_knowledgebase az action: "create_article" + generateContent beállítással
Cikkek közzététele → manage_knowledgebase az action: "update_article" + published: true beállítással

Összekapcsolási lépés nincs. Egy márka legfeljebb egy tudásbázist és egy dokumentációt szolgál ki a nyilvános címén, és hogy melyiket, azt az irányítópulton a Márka → Tudás oldalon választod.

Fejlesztői dokumentáció felépítése

Dokumentáció létrehozása → manage_documentation az action: "create" beállítással
Kategóriák létrehozása → manage_documentation az action: "create_category" beállítással
Oldalak írása → manage_documentation az action: "create_page" + generateContent beállítással
Hierarchia szervezése → manage_documentation az action: "create_page" + parentId beállítással
Kategóriák közzététele → publish_documentation a type: "category" beállítással
Oldalak közzététele → publish_documentation a type: "page" beállítással