Termék eszközök

Áttekintés

Az irányítópultod asszisztensén, a Vexen vagy egy csatlakoztatott AI alkalmazáson keresztül egy AI bekötheti a katalógusokat, ahonnan egy márka termékei érkeznek, naprakészen tarthatja őket, és megírhatja egy márka termékszabályait: az állításait (amit egy termékről el szabad mondani, hogy mit csinál) és az utasításait (amit az AI-nak követnie kell, valahányszor egy termékről beszél). 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 find_actions ezeket a műveleteket a chatbot területen mutatja, a Chatbot eszközök mellett.

Szükséges jogosultság:ContentSources — a jogosultsági listában Tartalomforrások néven jelenik meg, nem a Vex AI ügynök. A termékkatalógus közös tartalom: olvassa a weboldalad AI ügynöke, a hangügyintézők, a beérkezettekben megjelenő válaszjavaslatok és az AI közösségimédia-posztolás egyaránt. 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.

A márkakorlátozások érvényesek. Aki csak bizonyos márkákhoz fér hozzá, az csak azoknak a márkáknak a termékforrásait, állításait, utasításait és termékeit éri el — olvasásra és módosításra is — a Vexben, a böngészős bejelentkezéssel csatlakoztatott alkalmazásokban és azokon az API-kulcsokon keresztül is, amelyeknek ő kapcsolta be az AI hozzáférését. Egy másik márka elemeire az a válasz, hogy nem találhatók, vagy nem érhetők el.

Hogy mindez mit jelent a termékben, arról az irányítópulti dokumentáció szól: állítások és termékutasítások és termékforrások.

Műveletek

Művelet	Szint	Mit csinál
`product_rules.create`	Módosítás	Egy állítást vagy utasítást hoz létre egy márkához (`type`: `claim` vagy `instruction`, alapból utasítás): a kulcsait és a szövegét. Kikapcsolva (piszkozatként) indul, hacsak nem hagytad jóvá a pontos szöveget.
`product_rules.bulk_create`	Módosítás	Legfeljebb 200 állítást vagy utasítást hoz létre egyszerre, mindet vagy egyiket sem — például egy jóváhagyott állításlista betöltéséhez. Kikapcsolva jönnek létre, hacsak nem hagytad jóvá a szöveget.
`product_rules.update`	Módosítás	Módosítja egy állítás vagy utasítás kulcsait, szövegét, megjegyzését, hatókörét, típusát vagy állapotát. A `type` módosítása áthelyezi az Állítások és az Utasítások fül között; ha visszaállítod piszkozatra, kikapcsol, de nem törlődik.
`product_rules.approve`	Módosítás	Bekapcsolja a kikapcsolt (piszkozat) állításokat vagy utasításokat — a kiválasztottakat, vagy egy márka összes piszkozatát, akár csak egyetlen dokumentumimportból valókat.
`product_sources.create`	Módosítás	Beköt egy katalógust: a webshop saját JSON-ját (Termék API) vagy egy Google Shopping CSV feedet.
`product_sources.update`	Módosítás	Módosítja egy forrás nevét, címét, titkát, extra fejléceit, kulcsmezőit, ütemezését, vagy azt, mi történjen ismételt hibák után.
`product_sources.fetch_now`	Módosítás	Azonnal újra beolvassa egy forrás termékeit — egy forrást az `id`-val, egy márka összes forrását a `brandId`-val —, forrásonként legfeljebb ötpercenként egyszer. AI krediteket használ.
`product_rules.delete`	Törlés vagy küldés	Véglegesen töröl egy állítást vagy utasítást. Az AI-nak meg kell ismételnie a nevét — a szövege első 60 karakterét.
`product_sources.delete`	Törlés vagy küldés	Véglegesen töröl egy forrást az összes termékével együtt. Az AI-nak meg kell ismételnie a forrás nevét. Elutasítja, amíg beolvasás vagy küldés fut.

Hogyan működnek az állítások és az utasítások

Egy termékszabály kulcsok listájából (a szavak, amelyek közösek a termékben és a szabályban, jellemzően egy összetevő neve), a szövegből, amelyet az AI elolvas, és egy típusból áll:

claim (állítás) — amit egy termékről el szabad mondani, hogy mit csinál, mire jó vagy mire alkalmas, például egy jóváhagyott egészségre vonatkozó állítás a benne szereplő feltétellel együtt. Az állítás a látogató céljához tartozó termékeket is megtalálja.
instruction (utasítás, ez az alapértelmezés) — az AI mindig betartja, amikor azokról a termékekről beszél, amelyekre vonatkozik: mit mondjon és mit soha, figyelmeztetések, és olyan tények, mint a „glutént tartalmaz”.

Az új állítások és utasítások kikapcsolva (piszkozatként) jönnek létre, és ezek soha nem jutnak el az AI-hoz. Egy AI csak akkor kapcsol be egyet — aktívként létrehozva vagy jóváhagyva —, ha elolvastad és jóváhagytad a pontos szöveget. Egyébként kikapcsolva hagyja őket, hogy te hagyd jóvá.

Az illesztés pontos, soha nem közelítő. Egy szabály akkor vonatkozik egy termékre, ha közös kulcsuk van, kisbetűsítés, az ékezetek elhagyása és az írásjelek összevonása után összevetve. Ugyanannak a dolognak minden írásmódja egyetlen szabály kulcsai közé kerül; a szinonimákat és a fordításokat nem illesztjük helyetted.
A „brand” hatókör minden terméket elér — csak utasításoknál. A márkaszintű utasításnak nincs kulcsa, és a márka minden termékére vonatkozik, a kulcs nélküliekre is — egy általános figyelmeztetéshez vagy egy soha nem használható szóhoz. Az állítás mindig kulcsokon keresztül tartozik a termékekhez, ezért a márkaszintű állítást elutasítjuk.
A type váltotta a mode-ot és a kind-ot. A műveletek már nem fogadnak mode („always” / „when relevant”) és kind („describe” / „find”) bemenetet: minden bekapcsolt állítás és utasítás, amely egy termékre vonatkozik, a termékkel együtt megy, a type pedig megmondja, a kettő közül melyik.
Az állítások kapcsolják a márka állításmódját. Amíg egy márkának legalább egy bekapcsolt állítása van, állításmódban van: az AI-ja csak az állításokkal mondja el, mit csinálnak a termékek, és egy célra csak akkor ajánl terméket, ha egy állítás lefedi azt — lásd: Hogyan találja meg a Vex a választ. Az a hívás, amely bekapcsolná egy márka első állítását, vagy kikapcsolná, illetve törölné az utolsót, elutasításra kerül, és semmi nem változik; a válasz elmagyarázza, mit jelentene a váltás. Az AI-nak ekkor el kell mondania neked, meg kell kérdeznie, és csak az igened után küldheti el ugyanazt a hívást újra confirm_claims_mode: true értékkel. A Vexben egy ilyen hívás megerősítő kártyáján megjelenik egy Claims sor, amely megmondja, merre válthat.
Az állítás-ellenőrzés. Állításmódban minden keresésnél jelentés alapján keresünk a márka állításai között, és egy rövid AI-hívás — a jelentésellenőrzés — választja ki, melyik illik valóban a látogató kérdéséhez; a kiválasztott állítás behozza a termékeit a válaszba, a csak hasonlónak tűnő termékeket pedig kihagyja (a látogató által megnevezett termék megmarad). Bekapcsolt állítás nélküli márkáknál soha nem fut le.
Egy kulcsos szabály legalább egy kulcs nélkül nem élesíthető. Az ilyen szabályokat tartalmazó jóváhagyás hibára fut, és megnevezi őket; a márkaszintű szabályokra ez nem vonatkozik.
A tömeges létrehozás mindent vagy semmit. Ha egyetlen szabályt is elutasítunk, vagy a szervezet 20 000 szabályos korlátja túllépne, egyik sem jön létre.

Hogyan működnek a termékforrások

Két fajta. A Termék API forrás a webshop saját JSON-ja, amelyet egész napos ütemezéssel olvasunk be, és amelyet a webshop bármikor be is küldhet; csak ez a fajta hordozhat szabálykulcsokat, és a címének https-nek kell lennie. A CSV forrás egyszerű termékek Google Shopping feedje, kulcsok és szabályok nélkül. A fajta utólag nem módosítható.
A titkot egyszer mutatjuk meg. Egy API forrás létrehozása visszaadja a titkát, a küldési címet és azt, hogyan azonosítja magát a webshop — a szervezet API kulcsával a Y-API-Key fejlécben. A későbbi válaszok csak azt mondják meg, van-e titok; az irányítópult újra megmutatja. A teljes JSON alakot A Termék API írja le.
Az áthelyezett forrás új titkot kap. Ha egy API forrás címe másik hosztra kerül, vagy egy csak küldésre használt forrás először kap címet, és az AI nem küld új titkot, a forrás frissen generált titkot kap, a további fejlécei pedig törlődnek — így a webshopod által ismert titok soha nem követi a forrást valaki más szerverére. A válasz ezt jelzi; add meg a webshopodnak az új titkot a márka Termékek → Források oldaláról.
A kulcsmezők azonnal életbe lépnek. Ha módosítod, mely mezőkből lesznek a termékek kulcsai, a forrás minden termékének kulcsai újraszámolódnak, új beolvasás nélkül.
Az azonnali beolvasás a háttérben fut. Az ötperces várakozási időn belül az AI megtudja, hány perc van még hátra — ez válasz, nem hiba. Egyébként kap egy futásazonosítót, és a forrás újbóli beolvasásával ellenőrzi az eredményt. Ha egyetlen forrás helyett egy márkát kap, a márka minden forrását frissíti, forrásonként legfeljebb ötpercenként egyszer, és felsorolja a kihagyott forrásokat az okkal együtt: a termékei küldéssel érkeznek, ezért nincs cím, ahonnan olvasni lehetne; már fut egy beolvasás; vagy még hátra van néhány perc. Az a márka, amelynek nincs forrása, elutasításra kerül.
Ismételt hibák. Három egymást követő sikertelen frissítés után a forrás lekapcsol, és a tulajdonos e-mailt kap. A forrás hibakezelési beállítása dönti el, hogy a termékei láthatók maradnak-e („keep”, ez az alapértelmezés), vagy rejtve lesznek, amíg újra nem működik („hide”).

Termékek, források és szabályok olvasása

Három erőforrás érhető el az Adathozzáférési eszközökön keresztül, ugyanazzal a Tartalomforrások jogosultsággal:

Erőforrás	Mit tartalmaz
`product_sources`	A katalógusok, ahonnan a termékek érkeznek, az ütemezésükkel és a legutóbbi futásukkal.
`product_rules`	Az állítások és az utasítások, mindegyik a kulcsaival, a típusával (`claim` vagy `instruction`) és az állapotával.
`products`	Maga a katalógus: alaptermékek a változataikkal, plusz minden termék kulcsai és saját szabálymondatai.

Ha egy szabályt a get_record segítségével olvasol be, azt is megmondja, ma hány termékhez jut el; egy termék beolvasásakor pedig felsorolja az összes rá vonatkozó állítást és utasítást, a kikapcsoltakkal együtt, mindegyiket a type értékével. Ha csak az állításokat vagy csak az utasításokat akarod listázni, szűrd a product_rules erőforrást a ruleType szűrővel (claim vagy instruction) — ez váltotta a régi ruleMode szűrőt. A kettő együtt a leggyorsabb módja annak, hogy bekapcsolás előtt ellenőrizd az állításaidat.

Amit egy AI itt nem tehet meg

Több állítás vagy utasítás, illetve egy márka összes piszkozatának törlése egyszerre. Egy AI hívásonként egy, név szerint megnevezett állítást vagy utasítást töröl. Sokuk törléséhez jelöld ki őket a márka Termékek → Állítások vagy Termékek → Utasítások fülének táblázatában, és töröld őket együtt.
Egy forrás titkának újbóli megjelenítése a létrehozás után. Ezt a márka Termékek → Források oldala mutatja meg.
Az API kulcs létrehozása, amellyel a webshopod küld. Az API kulcsok minden kapcsolatban emberi feladatok: hozz létre egyet a Beállítások → API alatt.

Példa promptok

Hozz létre egy „Shop feed” nevű termék API forrást a márkámon, amely naponta beolvassa a https://shop.example.com/yaplet/products címet, és az Ingredients mezőből csinál kulcsokat.
Hozd létre ezeket a jóváhagyott állításokat kikapcsolva, anyagonként egy állítással, az anyag nevére és a gyakori szinonimáira kulcsolva.
Mutasd meg a márkám összes olyan termékét, amelynek nincs kulcsa, hogy lássam, melyikhez nem érhet el állítás vagy utasítás.
Ma hány termékhez jut el a C-vitamin állítás?
Olvasd be most a Shop feed forrásom termékeit.