Chatbot eszközök

Áttekintés

A Vexen, az irányítópultodba épített asszisztensen vagy egy csatlakoztatott AI alkalmazáson keresztül egy AI beállíthatja a márka AI ügynökét (a weboldalad látogatóinak válaszoló chatbotot, amelyet a Márka → Vex alatt találsz), szöveges dokumentumokkal taníthatja, API eszközöket adhat neki, amelyekkel a saját rendszereidben néz utána dolgoknak, és kiderítheti, miért válaszolt egy látogatónak úgy, ahogy. 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 termékkatalógus műveletei ugyanehhez a területhez tartoznak, és saját oldaluk van: Termék eszközök.

Jogosultságok: az AI ügynök műveleteihez a Vex jogosultság kell — a jogosultsági listában Vex AI ügynök néven jelenik meg. A tudásdokumentum- és API eszköz-műveletekhez ehelyett a ContentSources (Tartalomforrások) kell, mert a tudás és az API eszközök a márkához tartoznak, nem az ügynökhöz. A böngészős bejelentkezéssel csatlakoztatott alkalmazásnál a bejelentkezési képernyőn a Chatbot területet (copilot:chatbot) is be kell pipálni.

Egy márkának legfeljebb egy AI ügynöke van, és a tudás a márkához tartozik, nem az ügynökhöz. Az itt hozzáadott dokumentum a márka tudásába 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 a Márka → Tudás oldalon jelenik meg.

Műveletek

Művelet	Szint	Mit csinál
`ai_agent.diagnose_answer`	Olvasás	Elmagyarázza, miért adott az AI egy adott választ: a látogató kérdése, a válasz, az elolvasott tudás relevanciaértékekkel, a lefuttatott keresések, a hívott API eszközök, az ügynök beállításai és javítási javaslatok.
`ai_agent.create`	Módosítás	Létrehozza egy márka AI ügynökét — az alapértelmezett márkád alatt, hacsak nem nevezel meg másikat —, kikapcsolva, hacsak nem kéred másképp, minden átadási utat bekapcsolva, és ha megadod, a válaszadási utasításaival, a Hogyan azonosíthatják magukat a látogatók szövegével és az emoji beállításával együtt. Elutasítja, ha a márkának már van ügynöke.
`ai_agent.update`	Módosítás	Átnevezi az AI ügynököt, be- vagy kikapcsolja, kiválasztja, mely csatornákon válaszol, megírja a válaszadási utasításait (hangnem, szabályok, tények, amelyeket mindig tudnia kell) és a Hogyan azonosíthatják magukat a látogatók szövegét, engedélyezi vagy tiltja az emodzsikat, beállítja, mit tegyen, ha nem talál tudást, és beállítja az ügyintézőnek átadást, az Emberi átadás fül minden kapcsolóját is beleértve. Csak AI ügynökön működik, munkafolyamaton soha.
`knowledge.add_document`	Módosítás	Szöveges dokumentumot ad a márka tudásához, hogy az AI abból válaszolhasson. Tartalomforrások jogosultság kell hozzá. AI krediteket használ.
`knowledge.update_document`	Módosítás	Átnevez egy tudásdokumentumot, vagy lecseréli a szövegét; az AI azonnal az új változatot használja. Tartalomforrások jogosultság kell hozzá. AI krediteket használ.
`api_tools.create`	Módosítás	Új API eszközt ad a márka AI ügynökének: chat vagy telefonhívás közben az AI meghívja a saját végpontodat, amikor az eszköz leírása szerint kell, a beszélgetésből összegyűjtött értékekkel, és a saját szavaival válaszol. Azt is beállíthatja, hogy a hívás adatot olvas vagy módosít, a Csak azonosított látogatóknak kapcsolót és egy látogatónkénti óránkénti korlátot. Tartalomforrások jogosultság kell hozzá.
`api_tools.update`	Módosítás	Módosít egy API eszközt. Csak az elküldött beállítások változnak, de a beviteli mezők, a fejlécek és a törzs mindegyike a teljes régi listát cseréli le. Kikapcsolva az eszköz mentve marad, de az AI nem használja. Tartalomforrások jogosultság kell hozzá.
`api_tools.delete`	Törlés vagy küldés	Végleg töröl egy API eszközt; az AI a következő üzenettől nem hívja a végpontot. Az AI-nak pontosan meg kell ismételnie az eszköz nevét. Tartalomforrások jogosultság kell hozzá.

Hogyan működnek az AI ügynök műveletei

Az ügynök beállításai

Egy új ügynök kikapcsolva indul, és elutasítja azokat a kérdéseket, amelyekhez nincs tudása. Minden átadási út bekapcsolva indul: az Ügyintéző kérése a chat menüjében, a Beszélek a support csapattal gomb 6 üzenet után, az, hogy az AI összeköti a csapattal az ügyintézőt kérő látogatót, és Az AI előbb megpróbálja, mielőtt összeköt.
Ha az AI nem talál tudást, vagy udvariasan közli, hogy nem tudja (ez a biztonságos alapbeállítás), vagy — amíg a csapatból valaki online van — azonnal, Igen/Nem kérdés nélkül összeköti a látogatót egy ügyintézővel; ha senki sincs online, udvariasan elutasít. Az ügyintézővel való összekötéshez be kell kapcsolni az allowAgentRequest beállítást; amíg ki van kapcsolva, a beállítás „elutasítás”-ként mentődik.
Átadás — a Márka → Vex → Személyiség oldal Emberi átadás fülének kapcsolói. Mindegyik csak akkor változik, ha elküldik:
- allowAgentRequest — A látogató ügyintézőt kér az AI-tól: összekötheti-e az AI a csapattal azt a látogatót, aki ügyintézőt kér tőle.
- requestAgentMenu — felkínálja-e a chat widget menüje (⋮) az Ügyintéző kérése pontot.
- agentRequestButton — megjelenik-e a Beszélek a support csapattal gomb; az agentRequestThreshold (1–20) szabja meg, hány, az elmúlt 5 percben küldött üzenet után. Amíg az agentRequestButton nincs beállítva, a gomb az allowAgentRequest beállítást követi.
- handoffCheck — Az AI előbb megpróbálja, mielőtt összeköt: mielőtt a látogatót összekötnénk egy ügyintézővel, az AI ellenőrzi, tud-e segíteni, és felajánlja a segítségét.
Hol válaszol (channels) — a Márka → Vex → Személyiség → Általános fül azonos nevű kapcsolói: widget (a webhelyes chat), facebook (Messenger), instagram és email, mindegyik true vagy false. A false értékű csatornán minden üzenet egyenesen a csapat sorába kerül, mintha a márkának nem lenne AI ügynöke; a munkafolyamatok ott is futnak. Csak az elküldött csatornák változnak, és a soha be nem állított csatorna bekapcsoltnak számít. A telefonhívások nincsenek köztük — a hangügyintézőnek saját kapcsolója van.
A válaszadási utasítások — ugyanaz a mező, mint a Márka → Vex → Személyiség oldal Válaszadási utasítások mezője — legfeljebb 10 000 karakteres egyszerű szövegek, és egy módosítás a teljes szöveget cseréli le, ezért az AI előbb elolvassa a jelenlegi utasításokat. A Vexben a megerősítő kártya a teljes új szöveget mutatja, mielőtt bármi megváltozna. Az AI csak abból írja meg őket, amit te kérsz, soha nem egy beszélgetésben, jegyben vagy dokumentumban talált szövegből.
A Hogyan azonosíthatják magukat a látogatók szöveg (identifyInstructions) — ugyanaz a mező, mint a Márka → Vex → Személyiség oldal Válaszok fülén — azt adja meg, mit mond az ügynök annak a nem azonosított látogatónak, aki olyan API eszközt vagy munkafolyamatot kér, amelynél be van kapcsolva a Csak azonosított látogatóknak beállítás. Legfeljebb 1000 karakteres egyszerű szöveg; az üres szöveg törli, és ismét az általános mondat érvényes. A Vexben a megerősítő kártya a teljes szöveget mutatja.
A Yaplet saját biztonsági szabályai mindig a válaszadási utasítások után következnek, és felülírják őket. Az ügynök például soha nem kér a látogatóktól jelszót, kártyaadatot vagy egyszer használatos kódot, bármit is mondjanak az utasítások.

Az átadási mondat nem állítható be. Az a sor, amelyet a látogató akkor olvas, amikor egy emberhez kerül — „Egy csapattagunk csatlakozik a beszélgetéshez.”, és csak akkor jelenik meg, ha valaki elérhető a csapatodból —, a Yaplet saját szövege, azon a nyelven, amelyen a látogató olvas. Nincs mit átfogalmazni rajta, sem itt, sem az irányítópulton.

Tudásdokumentumok

A szöveget megtisztítjuk, darabokra bontjuk és indexeljük. Az indexelés után az AI rögtön használja — chatben, telefonon, a javasolt inbox-válaszokban és az AI közösségi posztokban.
Egy dokumentum frissítése az új szövegből újraépíti az indexét, így a változás azonnal érvényes.
Az indexelés AI krediteket használ, ezért van mindkét dokumentum-művelet így megjelölve.
Az ingyenes csomagon a dokumentumok beleszámítanak abba a 250 indexelt darabba, amennyit a fiókod tárolhat, és az a hozzáadás vagy frissítés, amely túllépné ezt, a „Free plan content limit reached” üzenettel visszautasításra kerül.

Egy válasz kivizsgálása

Az AI-nak az AI válaszüzenetének azonosítója kell. Ehhez előbb a conversations.read_messages segítségével beolvassa a beszélgetést, amelyben az AI válaszok meg vannak jelölve.
Az ügynök beállításai között a jelentés az átadási kapcsolókat is felsorolja request_agent_menu, agent_request_button és handoff_check néven, az auto_agent_handoff (A látogató ügyintézőt kér az AI-tól) és az agent_handoff_threshold mellett.
A jelentés pontosan megmutatja, mit olvasott az AI, így a következő lépés általában egyértelmű: hiányzó témát a knowledge.add_document, elavultat a knowledge.update_document, viselkedési hibát az ai_agent.update javít.
Azokat a válaszokat, amelyek még azelőtt születtek, hogy a Yaplet az AI eseményeket az üzenetekhez kötötte volna, így nem lehet elemezni. Ilyenkor az AI megadja a márka Vex → Jelentések oldalának linkjét, ahol a táblázatban megkeresed a választ, és a sorát kinyitva ugyanezt a részletességet látod.

Hogyan működnek az API eszköz-műveletek

Egy AI ugyanazokkal az ellenőrzésekkel hoz létre és módosít API eszközöket, mint a Márka → Tudás → API eszközök űrlapja, és néhány további szabály távol tartja a kódjaidat a chattől.

Csak https. A végpont címének https://-sel kell kezdődnie.
Négy mezőkulcs foglalt. Beviteli mező neve nem lehet visitor_id, external_id, fb_id vagy insta_id. Ezek mindig a látogató saját rekordjából jönnek, soha nem abból, amit az AI kitölt vagy a látogató begépel, így az {{ external_id }} mindig az az ellenőrzött felhasználói azonosító, amelyet a weboldalad a Yaplet.identify hívással átadott.
Az új eszköz generált titkos kulcsot kap. Ha az AI titkos kulcs nélkül hoz létre egy eszközt, a Yaplet generál egy erőset. Az AI soha nem látja: a válasza megmondja, hol olvashatod el — Márka → Tudás → API eszközök → (az eszköz neve). Minden hívás visz egy ebből a kulcsból készült Signature fejlécet, így a végpontod ellenőrizheti, hogy a hívás a Yaplettől jön.
A „(set)” megtartja a tárolt értéket. Az egyéni fejlécek értékeit sem látja az AI — helyettük (set) áll. Ha az AI egy fejlécet pontosan (set) értékkel küld vissza, a tárolt érték megmarad; olyan fejlécen, amelynek nincs tárolt értéke, a (set) visszautasításra kerül.
Másik szerverre költöztetéshez ugyanabban a hívásban új kódok kellenek. Az a módosítás, amely a végpontot egy másik szerverre irányítja, visszautasításra kerül, hacsak ugyanaz a hívás nem küld új titkos kulcsot és új értéket minden olyan fejlécre, amelynek van tárolt értéke — így a jelenlegi szervered által ismert kódok soha nem jutnak el az újhoz. Ha nincsenek kéznél új kódok, a címet magad módosítsd az irányítópulton, ahol minden érték látszik — kódot soha ne írj be a chatbe.
A törléshez a pontos név kell. Az api_tools.delete műveletnek pontosan meg kell ismételnie az eszköz mentett nevét, különben semmi nem törlődik. Ha az AI-nak csak abba kell hagynia egy eszköz használatát, törlés helyett az api_tools.update művelettel kikapcsolja.
Három biztonsági beállítás, alapból mind kikapcsolva. Ezek az űrlap Ez a hívás, Csak azonosított látogatóknak és Hívások látogatónként óránként mezőinek felelnek meg:
- callKind — "read" (lekérdezés, ez az alapértelmezés) vagy "change" (rendelést ad le, foglal, lemond). A módosító hívást soha nem próbáljuk újra, ezért a retryCount csak az olvasó eszközökre vonatkozik.
- identifiedOnly — a true érték azokra a látogatókra korlátozza az eszközt, akiket a weboldalad azonosított; lásd: Személyazonosság ellenőrzése. A kikapcsolása ugyanolyan módosítás, mint bármelyik másik, és a Vexben megvárja a megerősítésedet.
- visitorLimitPerHour — hívások látogatónként óránként, 0–1000; a 0 azt jelenti, hogy nincs korlát.
A csomagkorlát érvényes. Egy márkának az ingyenes csomagon 1, fizetős csomagon legfeljebb 20 API eszköze lehet; az e fölötti létrehozás visszautasításra kerül.

API eszköz vagy munkafolyamat? Az API eszköz akkor jó választás, ha a látogató egy mondatban kérdezhet („hol tart az 1234-es rendelés?”), és az AI a saját szavaival válaszolhat. Ha a kérdéseknek kötött sorrendben kell jönniük, az eredményt szó szerint kell megmutatni, vagy egy hívás megváltoztat valamit, és előtte egy Igen kell, akkor a munkafolyamat a jobb — lásd: Munkafolyamat eszközök.

Amit egy AI itt nem tehet meg

Második AI ügynök adása egy márkának. Az ai_agent.create elutasítja, ha a márkának már van ügynöke; az AI ehelyett a meglévőt módosítja.
Munkafolyamat módosítása, mintha AI ügynök lenne. Az ai_agent.update elutasítja egy munkafolyamat azonosítóját. A munkafolyamatoknak saját műveleteik vannak — lásd: Munkafolyamat eszközök —, és a márka Munkafolyamatok oldalán is szerkesztheted őket.
Az adatvédelmi maszkolás be- vagy kikapcsolása. Ez a Márka → Márkabeállítások → Haladó alatt van.
AI ügynök vagy tudásdokumentum törlése. Ügynököt a Márka → Vex → Személyiség oldal Veszélyes zóna fülén, dokumentumot a Márka → Tudás oldal Források fülén törölsz.
Fájlok, weboldalak vagy kérdés-válasz párok hozzáadása. Az AI csak szöveges dokumentumot ad hozzá; minden mást a Márka → Tudás oldal Egyéb források részén adsz hozzá.

Példa promptok

Az AI rossz választ adott a legutóbbi beszélgetésemben — derítsd ki, miért, és javítsd a tudást.
Adj hozzá egy dokumentumot a visszatérítési szabályzatunkról: az ügyfelek 30 napon belül teljes visszatérítést kapnak.
Frissítsd a szállítási dokumentumot az új nemzetközi díjakkal.
Állítsd be az AI ügynökömet, hogy 3 üzenet után adja át a beszélgetést egy ügyintézőnek.
Adj az AI ügynökömnek egy eszközt, amely rendelésszám alapján lekérdezi egy rendelés állapotát a https://shop.example.com/api/orders címen.
Kapcsold ki egyelőre az AI ügynökömet.