AI-ügynökök (Abilities API és MCP)

A Pixel Managert teljes egészében működtetheti egy AI-ügynök. Amit a Pixel Manager adminisztrációjában megtehetsz, azt egy ügynök, például a Claude, a Cursor vagy a VS Code Copilot is megteheti: pixeleket állíthat be, összekötheti a Google- és Meta-fiókjaidat, ellenőrizheti a beállítást, olvashatja a diagnosztikát és a naplókat, visszaállíthat mentéseket, és kezelheti a SweetCode Cloudot. A képességek az ingyenes és a Pro változatban is megvannak.

A Pixel Manager a műveleteit képességként (ability) regisztrálja a WordPress Abilities API-ban. A WordPress MCP Adapter bővítmény teszi elérhetővé az AI-kliensek számára. Az AI-kliens összekötéséhez az MCP Adapter és a kliens saját beállítását kell követned. Ez a fejezet azt írja le, mit tud az ügynök a Pixel Managerrel, ha már csatlakoztattad.

Hogyan működik?

• Az ügynöknek pontosan a te jogosultságaid vannak. Minden képesség ugyanazt a jogosultság-ellenőrzést használja, mint a Pixel Manager adminisztrációja: az ügynök WordPress-felhasználójának manage_woocommerce vagy manage_options jogosultság kell. A bolt kezelői mindent megtehetnek a Pixel Managerben, amit az adminisztrátorok, ügynökön át is.
• Ugyanaz az ellenőrzés, mint az adminisztrációban. Az azonosítókat és tokeneket ugyanazokkal a formai szabályokkal ellenőrzi, mint a beállítóképernyő. Érvénytelen értéket indoklással elutasít, és semmit nem ír el.
• Minden mentésről biztonsági mentés készül. Minden beállításváltozás automatikus mentést hoz létre, ugyanazokat, amelyeket a Support oldalon látsz. Ha megkéred az ügynököt, hogy vonja vissza a változást, a változás előtti mentést állítja vissza.
• A titkok titkok maradnak. API-tokent és kulcsot sosem ad vissza. Az ügynök csak azt látja, hogy egy titok be van-e állítva.
• A Pro beállításokhoz Pro licenc kell. Az összes beállítás szerepel a listában, de aktív Pro licenc nélkül a Pro beállítások nem írhatóként vannak megjelölve, és az írást elutasítja.
• A belépés a te kezedben marad. A Google- vagy Meta-fiók összekötéséhez neked kell belépned. Az ügynök megadja a hivatkozást, te belépsz a böngészőben, utána az ügynök folytatja.

Minden képesség neve pmw/ előtaggal kezdődik, és a pmw-tracking kategóriához tartozik.

Első lépések

Ha az AI-kliensed csatlakoztatva van, egyszerűen kérdezz köznyelven. Jó első kérdés: „Ellenőrizd a Pixel Manager beállításomat, és mondd meg, mi hiányzik.”

Az ügynök ilyenkor a pmw/get-setup-status képességet hívja, amely megmondja, mely pixelek aktívak, mely kötelező beállítások hiányoznak, mely haladó funkciók elérhetők, de még nincsenek bekapcsolva, és fontossági sorrendbe állított javaslatot ad a következő lépésre.

További példák, mit kérhetsz:

• „Állítsd be a Google Ads konverziókövetést. Használd a meglévő vásárlási konverziós műveletemet.”
• „Add hozzá a TikTok pixelazonosítómat (C1234567890), és kapcsold be az Advanced Matchinget.”
• „Mely beállításokat módosítottad az elmúlt órában? Vond vissza őket.”
• „Mutasd a követési pontosságot fizetési módonként az elmúlt 30 napra.”
• „A SweetCode Cloud hibás célpontokat mutat. Mi a gond?”
• „Olvasd el a Pixel Manager naplóit, és mondd meg, miért hibázik a Meta Conversions API.”
• „Milyen optimalizálási lehetőségeim vannak még?”
• „Készíts hibakeresési jelentést a SweetCode támogatásnak.”

Elérhető képességek

Beállítás és konfiguráció

Képesség	Mit csinál
pmw/get-setup-status	Beállítási ellenőrzőlista: aktív pixelek, hiányzó kötelező beállítások, elérhető haladó funkciók és ajánlott következő lépések. A vezetett beállítás legjobb kiindulópontja.
pmw/get-tracking-status	Mely pixelek aktívak, milyen kategóriába tartoznak (marketing, statisztika, optimalizálás), és böngészőben, szerveroldalon vagy mindkettőn követnek-e.
pmw/get-settings-schema	Az összes beállítás katalógusa: pontjelölésű útvonal, típus, alapérték, hol található az érték, kötelező-e, haladó-e, Pro-e, titok-e.
pmw/get-settings	Az összes beállítás jelenlegi értéke. A titkokat csak beállított vagy nem beállított állapotban mutatja.
pmw/update-settings	Egy vagy több beállítást módosít útvonal szerint, például {"google.ads.conversion_id": "123456789"}. Beállításonként jelzi, hogy frissült, változatlan, érvénytelen, ismeretlen vagy tiltott.
pmw/configure-pixel	Egy hívásban beállít egy pixelt, például a google_ads-t conversion_id és conversion_label értékkel, és visszaadja a pixel beállítási állapotát.
pmw/get-plugin-info	A bővítmény verziója, ingyenes vagy Pro, a terjesztési csatorna és a környezeti kompatibilitás.

Mentések, import és export

Képesség	Mit csinál
pmw/list-settings-backups	Az automatikus beállításmentések listája, a legújabbal kezdve.
pmw/get-settings-backup	Egy mentésben tárolt beállítások, visszaállítás előtti összehasonlításhoz.
pmw/export-settings	A teljes beállításfa, mint a Support oldal exportja. A titkokat eltávolítja.
pmw/restore-settings-backup	Visszaállít egy mentést, mint a Support oldal visszaállítás gombja.
pmw/import-settings	Az összes beállítást lecseréli egy általad megadott beállításfájlra.

Fiókkapcsolatok

A Google- és a Meta-kapcsolat a SweetCode kapcsolati szolgáltatást használja, ugyanúgy, mint az adminisztráció beállítási varázslói.

Képesség	Mit csinál
pmw/get-google-connection-status	Össze van-e kötve Google-fiók, és mely jogosultságok (GA4, Google Ads, Data Manager) vannak megadva.
pmw/start-google-connection	Visszaadja a Google-bejelentkezési hivatkozást, amelyet neked kell megnyitnod.
pmw/disconnect-google	Leválasztja a Google-fiókot. A böngészős követés tovább fut.
pmw/list-google-ads-accounts	A hozzáférhető Google Ads-fiókok listája.
pmw/list-google-ads-conversion-actions	Egy Google Ads-fiók konverziós műveletei.
pmw/connect-google-ads-conversion	Beállítja a Google Ads konverziókövetést meglévő vagy új konverziós művelettel, mint a Google Ads-varázsló utolsó lépése.
pmw/get-google-data-manager-permission	Meg van-e adva a Data Manager jogosultság a szerveroldali konverziófeltöltésekhez.
pmw/list-ga4-accounts	A Google Analytics-fiókok és GA4-tulajdonságok listája.
pmw/create-ga4-property	GA4-tulajdonságot hoz létre a bolt időzónájával és pénznemével.
pmw/list-ga4-streams	Egy GA4-tulajdonság webes adatfolyamai.
pmw/connect-ga4-stream	Beállítja a GA4-követést meglévő vagy új webes adatfolyammal.
pmw/get-meta-connection-status	Össze van-e kötve Meta üzleti fiók.
pmw/start-meta-connection	Visszaadja a Facebook Login for Business hivatkozást, amelyet neked kell megnyitnod.
pmw/disconnect-meta	Leválasztja a Meta üzleti fiókot. A pixelazonosító megmarad.
pmw/list-meta-pixels	Az összekötött üzleti fiók Meta-pixelei (adathalmazai).
pmw/connect-meta-pixel	Ellenőrzi a pixelt a Metánál, és elmenti, mint a Meta-varázsló utolsó lépése.

SweetCode Cloud

Képesség	Mit csinál
pmw/get-ssp-status	Kapcsolat állapota, proxy hosztneve, utolsó szinkron, csomag, használat, kvóta és hibás célpontok.
pmw/get-ssp-diagnostics	A SweetCode Cloud diagnosztikai jelentése a támogatásnak.
pmw/test-ssp-connection	Ellenőrzi, elérhető-e a proxy hosztneve a szerveredről.
pmw/connect-ssp	Összeköti a boltot a SweetCode Cloud portál szinkrontokenjével.
pmw/sync-ssp-config	Elküldi az aktuális követési konfigurációt a SweetCode Cloudnak.
pmw/set-ssp-enabled	Be- vagy kikapcsolja a SweetCode Clouddal való átirányítást, a kapcsolatot megtartva.
pmw/update-ssp-setting	Beállítja, mi történjen a szerveroldali eseményekkel, amíg a SweetCode Cloud nem érhető el.
pmw/disconnect-ssp	Leválasztja a boltot a SweetCode Cloudról.

Diagnosztika és naplók

Képesség	Mit csinál
pmw/get-debug-info	A teljes hibakeresési jelentés a Support oldalról.
pmw/get-gateway-accuracy	Napi követési pontosság fizetési módonként, a Diagnostics diagram adatai.
pmw/get-first-event-status	A bolt visszaigazolta-e, hogy a pixelek betöltődnek, és követték-e az első rendelést.
pmw/get-logs	A Pixel Manager naplófájljai, a legújabb bejegyzésekkel kezdve. A naplók csak akkor telnek, ha a naplózó be van kapcsolva.
pmw/get-google-data-manager-status	A Google Ads Data Manager konverziófeltöltés állapota és utolsó eredménye.
pmw/get-google-data-manager-diagnostics	A Data Manager azonosítóinak lefedettsége és a friss rendelések, a támogatásnak szánt jelentéssel.
pmw/test-google-data-manager-upload	A legutóbbi rendelést csak ellenőrző (validate-only) tesztfeltöltésként elküldi. Konverziót nem rögzít.
pmw/update-ga4-data-api-credentials	Eltárolja a Google-szolgáltatásfiók kulcsát a GA4 Data API-hoz.
pmw/get-order-attribution	Egy rendelés GA4-hozzárendelése (forrás, közeg, kampány).

Lehetőségek, értesítések és élettartam-érték

Képesség	Mit csinál
pmw/list-opportunities	A boltod lehetőségei, hatás szerint rendezve.
pmw/dismiss-opportunity	Elrejt egy lehetőségkártyát.
pmw/restore-opportunity	Újra megmutat egy elvetett lehetőségkártyát.
pmw/get-admin-notices	A bevezető ellenőrzőlista és más adminisztrációs értesítések állapota.
pmw/acknowledge-notice	Úgy válaszol egy adminisztrációs értesítésre, ahogy te tennéd az adminisztrációban.
pmw/get-ltv-recalculation-status	Fut-e élettartam-érték újraszámítás (Pro).
pmw/run-ltv-recalculation	Újraszámolja a vevő élettartam-értékét a teljes rendelési előzmény alapján (Pro).
pmw/stop-ltv-recalculation	Leállítja a futó élettartam-érték újraszámítást (Pro).

Minden képesség részletesen leírja a bemeneteit és kimeneteit, az ügynök ezeket maga olvassa. Nem kell ismerned a képességek neveit.

Megerősítést kérő műveletek

Egyes képességek a bővítmény beállításain kívül módosítanak valamit, vagy nem vonhatók vissza. Leírásuk arra utasítja az ügynököt, hogy előbb kérdezzen meg, és a legtöbb MCP-kliens minden hívás előtt jóváhagyást is kér. Ezek:

• Mentés visszaállítása vagy beállítások importálása, amely az összes beállítást lecseréli.
• A Google, a Meta vagy a SweetCode Cloud leválasztása. Az újracsatlakozáshoz újra be kell lépned, vagy újra meg kell adnod a szinkrontokent.
• GA4-tulajdonság, GA4-adatfolyam vagy Google Ads konverziós művelet létrehozása, amely a Google-fiókjaidat módosítja.
• Az élettartam-érték újraszámítása, amely nagy boltoknál egy időre terheli a szervert.

Csak olvasható mód

Ha azt szeretnéd, hogy az ügynökök olvashassanak és diagnosztizálhassanak, de ne módosíthassanak semmit, add hozzá ezt a szűrőt. Ilyenkor az író képességek egyáltalán nem regisztrálódnak.

add_filter( 'pmw_abilities_allow_write', '__return_false' );

Külső eszközök és receptek

A Pixel Manager képességei szabványos WordPress-képességek, ezért minden olyan MCP-kliens vagy szolgáltatás használhatja őket, amely támogatja az Abilities API-t. Egyes eszközök kész munkafolyamatokat építenek rájuk. A StoreAgent például recepteket kínál követési állapotellenőrzésre, fizetési mód szerinti konverziós hiányokra, vezetett pixelbeállításra és beállítás-visszaállításra. Ezeket más cégek készítik, a SweetCode nem tartja karban őket. A receptek egyszerű promptok, ezért bármely más MCP-kliensben is futtathatod őket.

A Pixel Manager képességeit támogatják. Az MCP-kapcsolattal vagy egy külső eszközzel kapcsolatos problémánál az eszköz szolgáltatójához fordulj.