Chatbot eszközök

Áttekintés

A Chatbot eszköz kategória a Yaplet AI ügynökét fedi le — azt, amit az irányítópult Vex néven ismer. Módosíthatod a beállításait, dokumentumokon keresztül tudást adhatsz neki, és kivizsgálhatod, amikor helytelen vagy váratlan választ ad.

Jogosultságok: a manage_chatbot és a diagnose_ai_response a Vex jogosultságot igényli — a jogosultsági listában Vex AI néven jelenik meg. A manage_chatbot_document ehelyett a ContentSources (Tartalomforrások) jogosultságot igényli, mert a tudás a márkához tartozik, nem az ügynökhöz. A kategória termék eszközei szintén a Tartalomforrások jogosultságot használják.

Egy márkának legfeljebb egy AI ügynöke van, és a tudás a márkához tartozik, nem az ügynökhöz. A manage_chatbot_document egy chatbotId alá írja a dokumentumot, de amit hozzáadsz, az a márka készletébe kerül, és onnan olvas a márka chat AI-ja, a hangügyintézői és az AI közösségi posztolása is. Az irányítópulton ezek a dokumentumok a Márka → Tudás oldalon jelennek meg.

manage_chatbot

Létrehoz egy új AI ügynököt vagy frissíti egy meglévő beállításait.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`id`	string	Nem	Chatbot azonosító. Hagyd el a létrehozáshoz, add meg a frissítéshez.
`name`	string	Feltételes	Megjelenített név. Létrehozáskor kötelező.
`active`	boolean	Nem	Az ügynök engedélyezése vagy letiltása.
`noContextBehavior`	string	Nem	Mit csináljon az AI, ha nem talál releváns tudást: `"decline"` (udvariasan elutasít) vagy `"offer_agent"` (Igen/Nem kérdéssel embert ajánl, és csak akkor, ha tényleg van elérhető ügyintéző).
`allowAgentRequest`	boolean	Nem	Az AI átadhat-e emberi ügyintézőnek. Csak frissítéskor.
`agentRequestThreshold`	number	Nem	Üzenetek száma az automatikus átadás előtt (1–20). Csak frissítéskor.

Hogyan működik

Ügynök létrehozása:

Csak a name kötelező. Az ügynök ésszerű alapértelmezésekkel jön létre:
- Típus: AI
- Kontextus nélküli viselkedés: decline (udvariasan elutasítja az ismeretlen kérdéseket)
- Ügyintézőnek átadás: engedélyezve, 6 üzenetes küszöb
- Keresési mélység: pontos (újrarangsorolás bekapcsolva)
- Adatvédelmi maszkolás: letiltva
Az ügynök alapértelmezetten inaktívként indul. Állítsd active: true-ra az azonnali engedélyezéshez.

Az átadási mondat nem állítható be. Az a sor, amelyet a látogató közvetlenül az ügyintézőhöz kapcsolás előtt olvas — „Máris kapcsollak az egyik ügyintézőnkhöz." —, a Yaplet saját szövege, azon a nyelven, amelyen a látogató olvas. Nincs hozzá mező, és az eszköz nem fogad el agentRequestMessage paramétert — ha átadsz egyet, az nem hiba, egyszerűen nem történik semmi. Ha valaki át szeretné fogalmazni ezt a mondatot, mondd el neki, hogy nem módosítható.

Ügynök frissítése:

Add meg az id-t és csak azokat a mezőket, amelyeket változtatni szeretnél.
A noContextBehavior az a beállítás, amely leginkább befolyásolja a válaszok minőségét:
- "decline" — Az AI udvariasan közli, hogy nincs információja az adott témáról. Ez a biztonságos alapértelmezés.
- "offer_agent" — Az AI felajánlja, hogy összeköti a látogatót egy emberrel. Ehhez be kell lennie kapcsolva az ügyintézőnek átadásnak; ha ki van kapcsolva, a beállítás csendben decline-ra esik vissza.
A fenti paraméterek az egyetlen ügynök-beállítások, amelyeket bármely eszköz írni tud. Itt semmi nem módosítja az ügynök válaszutasításait (a szabad szöveges promptját) vagy az emoji beállítását — pedig ez a két beállítás dönti el, hogyan ír. Ezeket a Márka → Vex → Személyiség oldalon szerkeszted.

Az itt létrehozott ügynök nem tartozik egyetlen márkához sem. A manage_chatbot nem állítja be a márkát, így az MCP-n keresztül létrehozott új ügynök nem jelenik meg a Márka → Vex oldalon, és egyetlen widget sem használja. Az ügynököt inkább a Márka → Vex oldalon hozd létre, és utána ezekkel az eszközökkel állítsd be és töltsd fel tudással.

Példa promptok

Aktiváld az AI ügynökömet.
Állítsd be az ügynököt, hogy 3 megválaszolatlan üzenet után emberi ügyintézőnek adja át.
Változtasd a kontextus nélküli viselkedést elutasításra ügyintéző ajánlása helyett.
Tiltsd le az ügyintézőnek átadást.
Nevezd át az AI ügynökömet Adára.
Kapcsold ki egyelőre az AI ügynökömet.

manage_chatbot_document

Szöveges dokumentumot hoz létre vagy frissít a márka tudásában. A dokumentumok automatikusan feldolgozásra kerülnek, hogy az AI használhassa őket a kérdések megválaszolásához.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`id`	string	Nem	Dokumentum azonosító. Hagyd el a létrehozáshoz, add meg a frissítéshez.
`chatbotId`	string	Feltételes	Létrehozáskor kötelező. Az AI ügynök, amely alá a dokumentum kerül.
`name`	string	Feltételes	Dokumentum cím. Létrehozáskor kötelező.
`content`	string	Feltételes	Dokumentum tartalma (szöveg/HTML). Létrehozáskor kötelező.

Hogyan működik

Dokumentum létrehozása:

Add meg a chatbotId-t, name-et és content-et.
A tartalom megtisztításra, darabolásra és indexelésre kerül, hogy az AI lekérhesse, amikor kérdésekre válaszol.
Az indexelés után az AI azonnal használhatja ezt a tudást — chaten, telefonon, az inbox javasolt válaszaiban és az AI közösségi posztokban.

Dokumentum frissítése:

Add meg az id-t és a változtatni kívánt mezőket (name és/vagy content).
Frissítéskor a régi indexbejegyzések törlődnek, és újraépülnek az új tartalomból.
Ez azt jelenti, hogy a változtatások azonnal érvénybe lépnek — az AI rögtön a frissített tudást használja.

Tipp: Ezt az eszközt gyakran a diagnose_ai_response után használják, ha tudáshiányt azonosít. Ha az AI nem tudott válaszolni egy kérdésre, mert hiányoztak az információk, azonnal hozzáadhatsz egy dokumentumot a javításhoz.

Példa promptok

Adj hozzá egy dokumentumot a visszatérítési szabályzatunkról: az ügyfelek 30 napon belül teljes visszatérítést kaphatnak.
Hozz létre egy tudásdokumentumot az árszintjeinkről.
Frissítsd a szállítási szabályzat dokumentumot az új nemzetközi szállítási díjakkal.
Nevezd át a GYIK dokumentumot erre: Gyakran Ismételt Kérdések - 2026.
Adj hozzá egy dokumentumot ezekről a témákról: fiók beállítás, jelszó visszaállítás és számlázási kérdések.
Javítsd a tudáshiányt — adj hozzá egy dokumentumot a visszaküldési folyamatunkról. (jellemzően egy diagnosztikai lépés után)

diagnose_ai_response

Elemzi, hogy az AI miért adott egy konkrét választ. Részletes diagnosztikai jelentést ad vissza a feltett kérdéssel, a kapott válasszal, azzal a tudással, amit ténylegesen elolvasott, az ügynök beállításaival és megvalósítható javaslatokkal.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`messageId`	string	Igen	A diagnosztizálandó AI chatbot válaszüzenetének azonosítója.

Hogyan működik

Megtalálja az AI interakciót, amely az üzenethez kapcsolódik — a látogató kérdését, az AI válaszát, a lefuttatott keresési lekérdezéseket, minden elolvasott tudásrészlet pontos szövegét relevanciaértékkel, minden hívott API eszközt azzal együtt, mit küldött és mit kapott vissza, valamint a használt modellt.
Osztályozza az eredményt — A válasz releváns tudáson alapult? Az AI-nak hiányzott a kontextus? A látogató emberi ügyintézőhöz lett átirányítva? Technikai hiba történt?
Jelenti azokat a beállításokat, amelyek hozzájárulhattak: az ügynök teljes válaszutasításait szó szerint, a kontextus nélküli viselkedését, az átadási beállításait, a keresési mélységét, és hogy be van-e kapcsolva az adatvédelmi maszkolás.
Megvalósítható javaslatokat ad — általában azt javasolva, hogy adj hozzá egy tudásdokumentumot a hiány pótlásához, vagy módosítsd az ügynök beállításait.

Hogyan kapd meg az üzenet azonosítót

Használd a get_conversation_messages-t a beszélgetés üzeneteinek olvasásához. Az AI válaszok egyértelműen meg vannak jelölve az eredményekben. Az AI válasz üzenet id-ja az, amit a diagnose_ai_response-nak átadsz. Azokat a válaszokat, amelyek még azelőtt születtek, hogy a Yaplet elkezdte volna az AI eseményeket az üzenetekhez kötni, az eszköz nem tudja automatikusan elemezni — helyette ad egy közvetlen hivatkozást az adott márka Vex → Jelentések oldalára, ahol a táblázatban megkeresed a választ, és a sorát kinyitva ugyanezt a részletességet látod.

Példa promptok

Az AI rossz választ adott az X beszélgetésben. Ki tudod diagnosztizálni, mi történt? (először olvassa az üzeneteket, megtalálja az AI választ, majd diagnosztizál)
Miért nem tudott válaszolni az AI az ügyfél árazással kapcsolatos kérdésére?
Diagnosztizáld az AI választ arra az üzenetre, ahol a szállításról beszélt.
Ellenőrizd, miért adta át az AI emberi ügyintézőnek a legutóbbi beszélgetésben.
Az AI valami helytelen dolgot mondott — diagnosztizáld és javítsd a tudást. (diagnosztizál, azonosítja a hiányt, majd a manage_chatbot_document-tel hozzáadja a hiányzó információt)

Általános munkafolyamat minták

Teljes AI ügynök beállítás

Hozd létre az ügynököt a Márka → Vex oldalon (az irányítópulton, hogy a márkádhoz tartozzon)
Tudásdokumentumok hozzáadása → manage_chatbot_document (ismételd meg minden témánál)
Aktiválás → manage_chatbot az active: true beállítással

Példa prompt: Adj hozzá dokumentumokat a visszatérítési szabályzatunkról és a szállítási információkról az AI ügynökömhöz, majd aktiváld.

Diagnosztizálás és javítás

Beszélgetés megkeresése → search_conversations vagy list_records
Üzenetek olvasása → get_conversation_messages
AI válasz diagnosztizálása → diagnose_ai_response
Tudáshiány pótlása → manage_chatbot_document

Példa prompt: Keress beszélgetéseket, ahol az AI nem tudott válaszolni, diagnosztizáld a legutóbbit, és adj hozzá egy dokumentumot a probléma megoldásához.