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 ügyféloldali súgó központokhoz), 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. A közzétett tartalom automatikusan indexelésre kerül AI lekéréshez.

Szükséges jogosultság:Copilot.Help

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.

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

Egy cikk közzététele automatikus AI/RAG indexelést indít el, hogy a chatbotok hivatkozhassanak rá.
A közzététel visszavonása eltávolítja az AI index bejegyzést.
Közzétett cikk tartalmának frissítése automatikusan újraindexeli.

Példa promptok

Hozz létre egy Súgó Központ 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 Súgó Központomban.
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 súgó központ felépítése (Tudásbázis)

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
Widgethez kapcsolás → link_to_widget (a Widget eszközökből)

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
Widgethez kapcsolás → link_to_widget (a Widget eszközökből)