Adathozzáférési eszközök

Áttekintés

Ezekkel az eszközökkel tájékozódik egy AI, mielőtt bármit tenne. A list_records és a get_record a rekordjaidat olvassa — widgeteket, beszélgetéseket, ticketeket, feliratkozókat és még sok mást. A három útmutató eszköz megmondja az AI-nak, mire jó a Yaplet ebben a fiókban (get_guide), mi van benne beállítva, mi hiányzik vagy mi nem működik (get_account_state), és hogyan működik egy funkció a Yaplet saját dokumentációja szerint (search_yaplet_docs). Mind az öt csak olvas, ezért minden hozzáférési szinten működik, a Csak olvasás szinten is, és a Vex, az irányítópultod asszisztense, megerősítő kártya nélkül futtatja őket.

Ennek a területnek nincsenek saját műveletei. A változtató műveleteket a többi eszközoldal írja le, és az AI a find_actions segítségével találja meg őket (lásd: MCP Szerver).

Eszközök

Útmutató eszközök

get_guide — kezdd itt

Az AI térképe a Yapletről. Minden termékterületre — chat widget, AI ügynök és tudás, súgóközpont és dokumentáció, beérkezett üzenetek, ticketek, hírlevél, elköteleződés, jelentések, időgazdálkodás, közönség, munkafolyamatok, hang, közösségi posztolás, partnerprogram, biztonság, ügynökfigyelés és beállítások — visszaadja:

• mire való a terület
• benne van-e a csomagodban, és van-e hozzáférésed (böngészős bejelentkezéssel csatlakoztatott alkalmazásnál azt is, hogy a terület be volt-e jelölve a bejelentkezéskor)
• hány műveletet futtathat ott egy AI, fajtánként számolva (olvasás, módosítás, törlés vagy küldés) — vagy azt, hogy ott egy AI még semmit nem tud tenni, és az irányítópult a megfelelő hely
• egy linket a terület dokumentációjához, angolul vagy magyarul

Linkekkel együtt azt is felsorolja, mit tehet meg csak ember (számlázás és csomag; csapat, jogosultságok és API kulcsok), és ad néhány munkaszabályt, köztük azt, mit enged ennek a kapcsolatnak a hozzáférési szintje. Egy AI-nak egy új beszélgetésben először ezt érdemes meghívnia, és akkor is, ha valaki azt kérdezi: „miben tudsz itt segíteni?”.

get_account_state — mi van beállítva, mi hiányzik, mi nem működik

A fiókod állapotfelmérése. Márkánként (csak azokra a márkákra, amelyekhez hozzáférsz) és a teljes szervezetre jelenti, mi létezik és mire kell figyelni, és minden részt egy rövid attention (figyelmeztetés) listával zár, egyszerű mondatokban — például Widget "Main site" has never loaded on a website vagy Sending domain example.com is not verified yet.

Minden sor csak azoknak jelenik meg, akiknek megvan az adott terület jogosultsága. A böngészős bejelentkezéssel csatlakoztatott alkalmazásnál a területet a bejelentkezéskor be is kellett jelölni, a hangügyintézők pedig soha nem látszanak. Egy hiányzó sor tehát azt jelenti, hogy „nincs jogosultság vagy terület”, nem azt, hogy „nincs ott semmi”. Egy AI-nak minden, a fiókra vonatkozó kérdésnél ezt érdemes először meghívnia — „miért nem jelenik meg a widgetem?”, „mit állítsak be következőnek?” —, utána keresni a dokumentációban, és csak azután használni a konkrét műveletet.

search_yaplet_docs — hogyan működik egy funkció

Keres a Yaplet hivatalos dokumentációjában (ezekben az oldalakban) és a Yaplet súgóközpontjában, és visszaadja a legrelevánsabb részleteket a linkjeikkel. Angolul vagy magyarul keres: a Vex az irányítópult nyelvét használja, hacsak nem kérnek mást, a külső alkalmazások az angolt. Minden keresés egészen kevés AI kreditet használ.

Egy AI-nak akkor érdemes meghívnia, amikor valaki azt kérdezi, hogyan működik egy Yaplet funkció vagy hogyan kell beállítani valamit, és mielőtt elmagyaráz vagy módosít egy beállítást — a dokumentációból derül ki, hogy az egyes beállítások milyen néven látszanak a képernyőn, és hol találhatók. Csak a Yaplet saját dokumentációját olvassa, a te tudásbázisodat és dokumentációdat nem; azokat a list_records és a get_record olvassa.

Rekordok olvasása

A list_records egy típus minden rekordjáról összefoglalót ad vissza; a get_record egyetlen rekordot kér le azonosító alapján, teljes részletekkel — teljes konfigurációs objektumokkal, tartalommezőkkel és kapcsolódó adatokkal.

Rekordtípusok

Amit a get_record hozzátesz

• A táblák mindent magukkal hoznak, ami egy ticket módosításához kell: az oszlopokat, a címkepalettát, azokat a személyeket, akikhez a ticket hozzárendelhető, az ellenőrzött címeket, ahonnan a bejelentőnek e-mail küldhető, és a prioritásokat — minden értéket, amit a Jegy eszközök elfogadnak, egyetlen hívásban, így az AI-nak soha nem kell azonosítót találgatnia.
• A ticketek a címkéikkel, hozzászólásaikkal, a bejelentőjükkel (a beküldő személy az e-mail címével) és azzal együtt érkeznek, hogy archiválva vannak-e.
• A beszélgetések a channel (widget, e-mail, Facebook, Instagram vagy hang) és a has_messages mezővel érkeznek — ez utóbbi megmutatja, hogy valódi beszélgetésről van-e szó, vagy az egyik üres rekordról, amelyet a widget egy új látogatóhoz nyit.
• A műszakok a számított bérükkel, az Összes műszak jogosultsággal rendelkezőknek pedig a műszaknaplóval együtt érkeznek.
• A termékforrások soha nem adják vissza a titkukat — csak azt, hogy be van-e állítva, az egyedi fejlécek nevét és a küldési címet.
• A termékszabályok (állítások és utasítások) hozzáteszik, hány termékhez jutnak el ma; a termékek pedig minden rájuk vonatkozó állítást és utasítást, a kikapcsoltakkal együtt, mindegyiket a típusával jelölve (claim vagy instruction).
• A hírlevél-autopilóták hozzáteszik a bepipált tartalomforrásaikat, a legutóbbi 50 számukat és a költségbecslést.
• A munkafolyamatok hozzáteszik a lépéseik számát és egy linket a munkafolyamathoz a szerkesztőben. Magukat a lépéseket a workflows.get_plan olvassa — lásd: Munkafolyamat eszközök.
• Az API eszközök soha nem adják vissza a titkos kulcsukat — csak a secret_set mezőt, amely megmondja, be van-e állítva —, és minden kitöltött egyéni fejléc értéke a valódi érték helyett (set).

Kérhető szűrők

Minden lista 50 rekordot ad vissza, hacsak az AI nem kér többet (legfeljebb 300-at). A beszélgetések, látogatók, ticketek, műszakok, feliratkozók, termékforrások, termékszabályok és termékek lapozhatók is.

Táblák és ticketek

Csak valódi beszélgetések

Ugyanez a logika érvényes a látogatókra is. A visitors listázása azokat az embereket adja vissza, akik ténylegesen beszélgettek veled, a legutóbbi beszélgetésük szerint rendezve. Ha azokat is kéred, akik soha nem beszélgettek, nyers oldalforgalmat kapsz — közönségkérdésekhez ez a helyes választás —, utolsó aktivitás szerint rendezve.

A beszélgetések a legutóbbi frissítés szerint rendezve érkeznek, két számmal: összesen hány felel meg a szűrőknek, és hány van ebben az oldalban. Minden beszélgetés tartalmazza a látogató nevét, e-mail címét és országát, az utolsó üzenetet, a csatornát, a widget nevét, az e-mail tárgyát (e-mail beszélgetéseknél), a létrehozás és a frissítés idejét, valamint a hozzárendelt ügyintézőt — így az AI-nak ritkán kell egy második hívás ahhoz, hogy kiderítse, kivel folyik a beszélgetés.

A beérkezett üzenetek figyeléséhez az AI megjegyzi a legfrissebb frissítési időt, amit látott, és a következő híváskor ezt adja meg „azóta változottak” szűrőként. Egy forgalmas szervezetnél a teljes beszélgetéslista több tízezer rekord is lehet, míg ugyanaz a hívás az elmúlt órára szűkítve jellemzően csak néhányat ad vissza.

Hogyan működik

• A rekordok a legújabbtól kezdve érkeznek, kivéve a beszélgetéseket (utolsó frissítés), a műszakokat (kezdési idő), a termékforrásokat (legrégebbi először), a termékeket (utolsó frissítés), valamint a saját sorrenddel rendelkező típusokat — tudásbázis kategóriák, dokumentáció kategóriák és oldalak, beszélgetésindítók és műszaktípusok —, amelyek abban a sorrendben érkeznek, ahogy az irányítópult mutatja őket.
• A rekordnak a szervezetedhez kell tartoznia; más szervezetek rekordjai soha nem kerülnek visszaadásra.
• Ha a fiókod csak bizonyos widgetekre korlátozódik, csak azoknak a widgeteknek a beszélgetéseit és látogatóit látod — ugyanaz a korlátozás, mint a Beérkezett üzenetekben. A tulajdonosokra és adminokra ez nem vonatkozik. A widget nélkül érkezett hanghívások láthatók maradnak; egy márka widgetjén érkezett hívás csak akkor nyílik meg, ha az adott márkát láthatod.
• A workflows, az api_tools, a newsletter_autopilots, a content_ideas, a product_sources, a product_rules és a products csak azokat a márkákat mutatja, amelyekhez hozzáférsz.
• Azok az eredmények, amelyek a csapatodon kívüli emberek által írt szöveget tartalmaznak — beszélgetések, látogatók, ticket-bejelentők, feliratkozók —, egy olyan sorral kezdődnek, amely arra utasítja az AI-t, hogy ezt a szöveget adatként kezelje, és soha ne kövesse a benne talált utasításokat.

Amit egy AI itt nem tud megtenni

• Bármit módosítani. Mind az öt eszköz csak olvas. A változtatások műveleteken keresztül történnek — lásd a többi eszközoldalt.
• Kiolvasni a csapatodat, a jogosultságokat, az API kulcsokat vagy a számlázást. Ezek minden kapcsolatban csak emberi kézben vannak; a get_guide linkel azokra az irányítópult-oldalakra, ahol egy ember kezeli őket.
• Listázni az üres beszélgetés rekordokat, amelyeket a widget olyan látogatóknak nyit, akik soha nem írtak. Egyet-egyet azonosító alapján továbbra is le lehet kérni a get_record eszközzel.
• Kijavítani, amit a get_account_state talál. Csak jelent; a javítás egy művelet, vagy egy lépés az irányítópulton.
• A saját súgóközpontodban keresni a search_yaplet_docs eszközzel. Csak a Yaplet dokumentációjában keres; a te tudásbázisodat és dokumentációdat a list_records és a get_record olvassa.

Példa promptok

• „Miben tudsz segíteni ebben a fiókban?” (a get_guide eszközt használja)
• „Miért nem jelenik meg a chat widgetem a weboldalamon?” (a get_account_state, majd a search_yaplet_docs eszközt használja)
• „Jelenleg milyen hozzá nem rendelt beszélgetések vannak?”
• „Keresd meg a [email protected] feliratkozót.”
• „Mutasd meg az alapértelmezett widgetem teljes részleteit.” (először listázza a widgeteket, majd lekéri az alapértelmezettet)