Widget eszközök | Yaplet HU

Áttekintés

Az irányítópultod asszisztensén, a Vexen vagy egy csatlakoztatott AI alkalmazáson keresztül egy AI beolvashatja és módosíthatja a chat widgeteidet: a beállításaikat, a kinézetüket, a Kezdőlapot, hogy melyik AI ügynököt és súgóközpontot használja a márka, mikor vannak általában online az ügyintézői, valamint a telepítőkódot. A lenti műveleteket a find_actions segítségével keresi meg, és mindegyiket a fajtájához tartozó futtató eszközzel futtatja — lásd: MCP Szerver. A Vexben minden módosítás előbb a Megerősítés gombodra vár.

Szükséges jogosultság:Brands — a jogosultsági listában Márkák és chat widgetek néven jelenik meg. A böngészős bejelentkezéssel csatlakoztatott alkalmazásnál a bejelentkezési képernyőn a Brands területet (copilot:widgets) is be kell pipálni. Két művelethez a saját terület jogosultsága is kell, ugyanúgy, mint az irányítópulton: a widgets.set_public_help-hez Knowledgebase (súgóközpont) vagy Documentation (dokumentáció), a widgets.set_ai_agent-hez pedig Vex (Vex AI ügynök néven látszik).

Műveletek

Művelet	Szint	Mit csinál
`widgets.get`	Olvasás	Beolvassa egy widget beállításait: színek, indítógomb, a Kezdőlap háttere és elrendezése, viselkedés, menük, valamint a Kezdőlap köszöntése, kártyái és gyorsgombjai az azonosítóikkal.
`widgets.install_code`	Olvasás	Megadja a kódrészletet, amellyel a widget egy weboldalra telepíthető.
`widgets.create`	Módosítás	Új widgetet hoz létre a megadott névvel és nyelvvel, alapbeállításokkal, és vele együtt egy ugyanilyen nevű új, üres márkát, amelyhez tartozik.
`widgets.update_settings`	Módosítás	Módosítja a widget nevét, a márkája nyelvét, a viselkedését (e-mail-cím kérése, értékelés, csapat mutatása, kezdőképernyő, böngésző nyelve, nyelvválasztó, dokumentációs link) és azt, hogy mely menüfülek látszanak.
`widgets.update_design`	Módosítás	Módosítja a színeket, a Kezdőlap hátterét, a kártyák színezését, a sarkokat és az indítógombot.
`widgets.update_home_texts`	Módosítás	Módosítja a Kezdőlap köszöntését és az alatta lévő sort, a márka saját nyelvén.
`widgets.set_home_cards`	Módosítás	Lecseréli a Kezdőlap kártyáit egy új listára.
`widgets.set_quick_buttons`	Módosítás	Lecseréli az AI mező alatti gyorsgombokat egy új listára.
`widgets.set_ai_agent`	Módosítás	Az egyik AI ügynöködet teszi a widget márkájának ügynökévé, vagy leveszi a márkáról az ügynököt anélkül, hogy törölné.
`widgets.set_public_help`	Módosítás	Egy tudásbázist vagy dokumentációt tesz közzé a márka nyilvános súgóközpontjaként vagy dokumentációjaként, vagy leveszi onnan. Semmi nem törlődik.
`widgets.set_roadmap_board`	Módosítás	Kiválasztja a táblát, amelyet a widget roadmapként mutat, vagy leveszi.
`brands.get_team_hours`	Olvasás	Beolvassa, mikor vannak általában online egy márka ügyintézői — egy márkáét, vagy az összes elérhető márkáét, mindegyiket a nevével és egy közérthető összefoglalóval.
`brands.set_team_hours`	Módosítás	Lecseréli egy márka teljes heti beosztását, vagy törli azt.

Hogyan működnek a widget műveletek

Widget létrehozása

A widgets.create a widget nevét (a weboldal vagy vállalkozás, amelyhez készül) és opcionálisan a nyelvét kéri (ha kimarad, angol). A megadott névvel és nyelvvel hoz létre egy widgetet alapbeállításokkal, és egy ugyanilyen nevű új márkát, amelyhez tartozik. Ez a márka üresen indul: nem kapja meg a meglévő tudásbázisodat, dokumentációdat vagy roadmapedet, és nincs nyilvános címe, amíg be nem állítasz egyet.
Az új widget kinézetét és Kezdőlapját az AI ezután a módosító műveletekkel állítja be. A Vexben ez több egymás utáni megerősítő kártyát jelent; az Összes megerősítése gomb együtt hagyja jóvá őket.
Ha egy meglévő widgetedet akarod átszínezni, az AI azt módosítja, nem hoz létre újat.

Csak az változik, amit kérsz

Minden módosító művelet csak azokat a beállításokat írja, amelyeket megkap; minden más marad, ahogy volt. Egy menüfül elrejtése a többit nem érinti, és egy szín módosítása megtartja a kinézet többi részét.

Színek és a Kezdőlap háttere

A színek négy döntésből állnak össze: a widget háttérszíne, egy-három márkaszín, mi kerül a köszöntés mögé (semmi, halvány árnyalat, tömör sáv vagy színátmenet), és hogyan jelenik meg a márkaszín a gombokon (egyszínű vagy színátmenetes). Minden más szín ezekből számolódik, és ellenőrizzük, hogy olvasható maradjon.
A Kezdőlap háttere rétegekből áll — a köszöntés mögötti háttér, egy feltöltött fénykép, lágy fényfoltok és vékony vonalak —, és bármely kombináció érvényes. Magát a fényképet az irányítópulton töltöd fel.
Az indítógombnak (a weboldaladon lévő gomb, amely megnyitja a chatet) saját alakja van, és a márkaszíneidet követi, amíg nem adsz neki saját színeket.
Az indítógomb ikonja három közül választható: üzenet buborék, AI ikon vagy a Kabalafigura. A Kabalafigura esetén az animált Vex kabalafigura maga a gomb, buborék, gyűrű és alak nélkül; az alak- és a gyűrűbeállítás megmarad, de amíg ez van kiválasztva, nem jelenik meg. Az új widgetek Kabalafigurával indulnak, a meglévők megtartják a gombjukat.

A Kezdőlap szövegei, kártyái és gyorsgombjai

A köszöntés, az alatta lévő sor, a kártyák és a gombok szövegei a márka saját nyelvén íródnak. Az általad írt szöveg csak ezen az egy nyelven létezik, míg a Yaplet beépített köszöntése minden látogató saját nyelvén szól. Amíg le nem fordítod a szövegeidet a widget Nyelvek fülén (Minden nyelv lefordítása, ingyenes), a más nyelven olvasó látogatók úgy látják a szövegedet, ahogy megírtad. Az AI minden szövegmódosítás után szól erről.
Az üres szöveg visszahozza a Yaplet beépített szövegét.
Az AI azt az utasítást kapja, hogy a köszöntést és az alatta lévő sort csak akkor módosítsa, ha új Kezdőlap-szövegeket kérsz.
A kártyák és a gyorsgombok mindig teljes listaként mennek. Az AI előbb beolvassa a widgetet a widgets.get segítségével: az a kártya vagy gomb, amely megtartja az azonosítóját, minden nyelvű szövegét is megtartja, az új bekerül, a kihagyott pedig törlődik.
Egy gyorsgomb elküldhet egy mondatot, megnyithat egy linket, egy űrlapot, egy cikket, egy hírt vagy a dokumentációt, vagy elindíthat egy munkafolyamatot — ennek a widget márkájához tartozó, bekapcsolt munkafolyamatnak kell lennie.
Ugyanazok a csomagkorlátok érvényesek, mint az irányítópulton: űrlap, cikk, dokumentáció, hír vagy munkafolyamat csak akkor kerülhet a listára, ha a csomagod tartalmazza az adott funkciót.
A Kezdőlap tetején lévő AI mező és a folyamatban lévő beszélgetés kártyája mindig ott van, és nem része a listának.

Nyelv

A widgets.update_settings által beállított nyelv a márka nyelve — ugyanaz a beállítás, mint a Márkabeállítások → Általános oldalon. Ez dönti el azt is, hogyan keres a tudásban és milyen nyelven ír az AI. Az a látogató, aki a widgetben maga választ nyelvet, megtartja a választását.

Ügyintézők elérhetősége

A beosztás ugyanaz, mint a Márkabeállítások → Ügyintézők elérhetősége oldalon: mikor vannak általában online a márka ügyintézői — nem a nyitvatartásod, az a tudásba tartozik. Ha meg van adva, Vex megmondja a látogatóknak, mikor érhetnek el egy embert, és ha senki sem elérhető, a weboldali chat üzenethagyó kártyája (Messengeren és Instagramon a „jelenleg minden ügyintézőnk offline” üzenet) megmondja, mikor lesz általában újra elérhető a csapat; ha nincs megadva, sehol nem esik szó az időpontokról.
A brands.set_team_hours a teljes heti beosztást lecseréli: egy időzónát (például Europe/Budapest), és minden napra, amikor valaki online van, egy kezdés–befejezés tartományt, például 09:00–17:00. A kihagyott nap azt jelenti, hogy aznap senki sincs online; a 24:00 éjfélig tartót jelent, és egy nap tartománya nem nyúlhat át rajta. Ha semmit nem adsz meg, a beosztás törlődik. Az elutasított értékek: nem 24 órás időpont, a kezdésnél nem későbbi befejezés, ismeretlen időzóna. Ha az AI csak egy részét módosítja, előbb beolvassa a mostanit a brands.get_team_hours-szal.
Az a csapattag, aki csak néhány márkát ér el, csak azoknak a beosztását olvashatja és módosíthatja.
Mire jó a beosztás részletesen: Márkabeállítások.

AI ügynök és nyilvános súgó

Egy márkának legfeljebb egy AI ügynöke van, és az automatikusan válaszol a márka widgetjén, ezért a widgets.set_ai_agent ritkán kell. Csak AI ügynök választható, munkafolyamat soha. Az ügynök levétele megtartja az ügynököt és a beállításait, de a márkának ezután nincs AI ügynöke.
A widgets.set_public_help a márka saját választását írja — ugyanazt, amit a Márka → Tudás oldalon állítasz. Az általa közzétett tudásbázis vagy dokumentáció jelenik meg a márka nyilvános címén, az előző pedig lekerül onnan. Semmi nem törlődik abból, amit megtanult, így a későbbi újbóli közzététel azonnali és ingyenes. Ha az AI ezután a tanítási adatok frissítését említi, nincs mit frissíteni. Csak olyan tudásbázis vagy dokumentáció tehető közzé, amely már ehhez a márkához tartozik; egy másik márkáét elutasítja — előbb helyezd át ehhez a márkához a Márka → Tudás oldalon.

Amit egy AI itt nem tehet meg

Widget vagy márka törlése. Widgetet a widget-tervező Funkciók fülének alján törölsz, márkát a Márkabeállítások → Veszélyzóna alatt.
Widget hozzáadása egy már meglévő márkához. A widget létrehozása mindig új márkát hoz létre. Widget nélküli márka a saját Chat widget oldalán, a Chat widget hozzáadása gombbal kap widgetet.
Widget létrehozása és megformázása egy lépésben. A létrehozás csak a nevet és a nyelvet kéri; a kinézetet és a Kezdőlapot az AI rögtön utána, külön módosító műveletekkel állítja be.
Képek feltöltése. A logót, a Widget ikont (csak a csapatod látja; a látogatók mindig Vexet látják) és a Kezdőlap fényképét a widget Megjelenés fülén töltöd fel.
Szövegek írása más nyelveken. Az AI csak a márka saját nyelvén ír; a többit a widget Nyelvek fülén fordítod le.
A Yaplet saját szövegeinek átfogalmazása. Az értékelés kérdését, a fülneveket és az „Egy csapattagunk csatlakozik a beszélgetéshez.” mondatot a widget minden látogató saját nyelvén mondja. Nincs mit beállítani rajtuk, sem itt, sem máshol.
A widget személyazonosság-ellenőrző titkának megjelenítése vagy cseréje. Ez a widget Telepítés fülén található.

Példa promptok

Hogy néz ki most a widgetem, és milyen gyorsgombjai vannak?
Adj a widgetemnek #1A1A2E hátteret, #E94560 márkaszínt és színátmenetet a köszöntés mögé.
Rejtsd el a Hírek és a Roadmap fület, és kérd meg a látogatókat, hogy értékeljék a beszélgetéseiket.
Tartsd meg az első két gyorsgombomat, a többit töröld, és adj hozzá egyet, ami a visszaküldési űrlapunkat nyitja meg.
Add meg a widgetem telepítőkódját.
A csapatunk hétfőtől péntekig 9:00–17:00 között válaszol a chatekre, budapesti idő szerint. Ezt állítsd be az ügyintézők elérhetőségének.