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

> A Pixel Manager műveleteinek elérése AI-ügynökkel a WordPress Abilities API-n és az MCP Adapteren át: képességek, jogosultságok, megerősítést kérő műveletek.

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](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/funkciok-lehetosegek/), 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.

```php
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.