Klikanie w ekranach administratora Product Feed Pro działa dobrze w przypadku jednorazowych zmian. Nie skaluje się, gdy potrzebujesz asystenta AI, wewnętrznej automatyzacji lub agenta połączonego z MCP do tworzenia kanałów, poprawiania mapowania, tłumaczenia kanału na inny język lub samodzielnego sprawdzania stanu kanału. Właśnie tym zajmują się funkcje AI: ustrukturyzowanym sposobem sprawdzania uprawnień, aby asystent AI mógł wywoływać te same akcje, które udostępnia interfejs administratora, za pośrednictwem WordPress Abilities API.
Każda funkcja to cienka warstwa otaczająca istniejącą warstwę usług wtyczki, te same pomocniki, z których korzysta interfejs administratora i WP-CLI, więc wywołanie funkcji uruchamia te same haki WordPress i WooCommerce, co odpowiadająca jej akcja administratora. Nie ma oddzielnej ścieżki kodu „przez AI”, której można by ufać. Ta referencja obejmuje każdą funkcję zarejestrowaną w całej rodzinie wtyczek AdTribes, kto może ją wywołać i jak połączyć asystenta z Twoim sklepem.
Czego będziesz potrzebować
| Wymaganie | Szczegóły |
|---|---|
| WordPress 6.9 lub nowszy | Abilities API (wp_register_ability()) jest dostępne w rdzeniu WordPress od wersji 6.9. W starszych wersjach WordPress rejestracja jest całkowicie pomijana i żadne funkcje nie są wyświetlane. |
| Product Feed Pro 13.5.7 lub nowszy | Posiada i rejestruje 25 funkcji w poniższej tabeli referencyjnej. WooCommerce musi być również aktywny, ponieważ Product Feed Pro uruchamia się tylko wtedy, gdy jest aktywny. |
| Sposób połączenia asystenta AI | Wtyczki AdTribes nie mają własnej karty ustawień AI ani MCP. Połącz Claude, ChatGPT lub innego asystenta ze swoimi funkcjami za pośrednictwem StoreAgent. Ten przewodnik obejmuje instalację StoreAgent, połączenie asystenta i zatwierdzenie, jaki dostęp otrzymuje połączenie. |
| Product Feed Elite (opcjonalnie) | Nie jest wymagane dla żadnej z poniższych funkcji. Zobacz „Rola Product Feed Elite” dalej. |
| Product Feed Translation Addon 1.0.1 lub nowszy (opcjonalnie) | Dodaje 4 kolejne funkcje do tworzenia i sprawdzania kanałów dla poszczególnych języków. |
Czym są funkcje AI
Funkcja to jedna konkretna akcja, którą Twój asystent AI może wykonać w Twoim sklepie, na przykład „wyświetl moje kanały” lub „ustaw harmonogram kanału”. Niektóre funkcje tylko odczytują dane. Inne wprowadzają zmiany, a te, które to robią, są oznaczone jako destrukcyjne, aby klient MCP wiedział, aby potwierdzić z Tobą przed ich uruchomieniem.
Połącz asystenta
Aby uzyskać pełny przepływ połączenia, w tym instalację StoreAgent i zatwierdzenie tego, co połączenie może odczytać lub zmienić, zobacz Jak połączyć ChatGPT lub Claude z Twoim sklepem za pomocą MCP. Gdy Twój asystent zostanie połączony przez punkt końcowy MCP StoreAgent, możliwości odczytu AdTribes są dostępne od razu. Możliwości zapisu pozostają wyłączone, dopóki ich nie włączysz w StoreAgent > Ustawienia > MCP > Możliwości, w sekcji źródła AdTribes.
Możliwości Product Feed Pro
Product Feed Pro rejestruje 25 możliwości w ramach wspólnej kategorii adtribes. Rejestracja wykorzystuje hook wp_abilities_api_init z priorytetem 20, warunkowana przez function_exists( 'wp_register_ability' ), dzięki czemu jest to łagodne no-op w WordPressie starszym niż 6.9. Możesz również całkowicie wyłączyć rejestrację za pomocą stałej PFP_DISABLE_ABILITIES lub filtra adt_pfp_enable_abilities, oba domyślnie włączają możliwości.
| Możliwość | Nazwa | Typ | Kto może jej używać |
|---|---|---|---|
| Listuj feedy | adtribes/list-feeds | Odczyt | Kierownik sklepu + Administrator |
| Pobierz feed | adtribes/get-feed | Odczyt | Kierownik sklepu + Administrator |
| Utwórz feed | adtribes/create-feed | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Zaktualizuj feed | adtribes/update-feed | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Usuń feed | adtribes/delete-feed | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Wygeneruj ponownie feed | adtribes/regenerate-feed | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Sklonuj feed | adtribes/clone-feed | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Pobierz walidację feedu | adtribes/get-feed-validation | Odczyt | Kierownik sklepu + Administrator |
| Wyświetl atrybuty feedu | adtribes/list-feed-attributes | Odczyt | Kierownik sklepu + Administrator |
| Wyświetl taksonomię Google | adtribes/list-google-taxonomy | Odczyt | Kierownik sklepu + Administrator |
| Ustaw mapowanie pól | adtribes/set-field-mapping | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Ustaw mapowanie kategorii | adtribes/set-category-mapping | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Dodaj regułę filtrowania | adtribes/add-filter-rule | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Wyświetl kanały | adtribes/list-channels | Odczyt | Kierownik sklepu + Administrator |
| Utwórz niestandardowy kanał | adtribes/create-custom-feed | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Masowa aktualizacja kanałów | adtribes/bulk-update-feeds | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Uzyskaj status śledzenia | adtribes/get-tracking-status | Odczyt | Kierownik sklepu + Administrator |
| Ustaw Piksel Facebooka | adtribes/set-facebook-pixel | Zapis (destrukcyjny) | Tylko administrator |
| Ustaw śledzenie Google | adtribes/set-google-tracking | Zapis (destrukcyjny) | Tylko administrator |
| Ustaw tagowanie UTM | adtribes/set-utm-tagging | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Ustaw harmonogram kanału | adtribes/set-feed-schedule | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Wstrzymaj harmonogram kanału | adtribes/pause-feed-schedule | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Uzyskaj statystyki kanału | adtribes/get-feed-stats | Odczyt | Kierownik sklepu + Administrator |
| Uzyskaj podsumowanie kanału | adtribes/get-channel-summary | Odczyt | Kierownik sklepu + Administrator |
| Pokaż wykluczone produkty | adtribes/get-excluded-products | Odczyt | Kierownik sklepu + Administrator |
Szczegółowe instrukcje dotyczące filtrów i reguł znajdziesz w sekcjach Jak tworzyć filtry dla swojego kanału produktów? i Jak tworzyć reguły kanału produktów.
Możliwości dodatku Product Feed Translation Addon
Gdy aktywny jest dodatek Product Feed Translation Addon, w tej samej kategorii adtribes rejestrują się 4 dodatkowe możliwości, podpięte pod wp_abilities_api_init z priorytetem 40, aby Product Feed Pro najpierw zarejestrował własne możliwości. Możesz je wyłączyć za pomocą stałej PFTA_DISABLE_ABILITIES lub filtru adt_pfta_enable_abilities.
| Możliwość | Nazwa | Typ | Kto może jej używać |
|---|---|---|---|
| Wyświetl przetłumaczone kanały | adtribes/list-translated-feeds | Odczyt | Kierownik sklepu + Administrator |
| Utwórz kanał językowy | adtribes/create-language-feed | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
| Uzyskaj zasięg tłumaczenia | adtribes/get-translation-coverage | Odczyt | Kierownik sklepu + Administrator |
| Ustaw atrybut języka | adtribes/set-language-attribute | Zapis (destrukcyjny) | Kierownik sklepu + Administrator |
Utwórz kanał językowy duplikuje istniejący kanał dla określonego języka, stosując ten sam przepływ duplikowania, a następnie przełączania języka, który wykonuje administrator na ekranie Zarządzaj kanałami. Uzyskaj zasięg tłumaczenia raportuje, dla każdego języka, ile opublikowanych produktów istnieje w tym języku w porównaniu do języka domyślnego, dzięki czemu możesz zobaczyć, jak kompletny będzie kanał językowy przed jego wygenerowaniem.
Rola Product Feed Elite
Product Feed Elite nie posiada obecnie żadnych ekskluzywnych możliwości. Przed wersją Product Feed Pro 13.5.7, 12 z powyższych możliwości (wszystko pod niestandardowymi kanałami, marketingiem i śledzeniem oraz harmonogramowaniem i statystykami, plus clone-feed i bulk-update-feeds) było dostępne w Elite 5.0.9. Od wersji Pro 13.5.7, Pro posiada i rejestruje je wszystkie samodzielnie, ponieważ funkcje, które obejmują, znajdują się w Pro.
Przy aktywnych obu wtyczkach i Product Feed Pro w wersji 13.5.7 lub nowszej, Elite 5.1.0 nie rejestruje już żadnych własnych możliwości: Pro rejestruje się jako pierwsze (priorytet 20), a kopie Elite (priorytet 30) sprawdzają, czy nazwa jest już zajęta i pomijają siebie, gdy tak jest, więc nigdy się nie uruchamiają. To, co Elite nadal robi, to:
- Wzbogacanie
adtribes/get-tracking-status: Elite dodaje rzeczywisty status Facebook Conversion API do odpowiedzi tej możliwości za pomocą filtraadt_pfp_ability_tracking_status, ponieważ Pro nie posiada integracji z Conversion API. - Zapewnienie mechanizmu zgodności: Na stronie nadal używającej Product Feed Pro w wersji starszej niż 13.5.7, kopie Elite rejestrują się zamiast tego, więc te nazwy możliwości pozostają aktywne podczas okresu aktualizacji.
Jedna możliwość nie została przeniesiona: adtribes/get-pixel-event-log, która była dostępna w Elite 5.0.9, została wycofana zamiast przyjęta. Mogła ona jedynie raportować „nieobsługiwane”, więc nie jest częścią powyższej tabeli referencyjnej.
Elite ma również własne przełączniki: stała PFE_DISABLE_ABILITIES lub filtr adt_pfe_enable_abilities wyłącza wszystko, co Elite dodaje do możliwości: jego kopie zapasowe i szczegóły Facebook Conversion API w adtribes/get-tracking-status.
Kto może używać każdej możliwości
Możliwości używają tego samego modelu uprawnień, co ekrany administracyjne wtyczki i punkty końcowe REST, a nie podstawowej możliwości WordPress read, którą ma każdy zalogowany użytkownik.
| Sprawdzenie uprawnień | Dotyczy | Wymagana uprawnienie |
|---|---|---|
| Odczyt możliwości | Każdy wiersz „Odczyt” powyżej | manage_woocommerce |
| Możliwości zarządzania kanałami i tłumaczeniami | Każdy wiersz „Zapis” z wyjątkiem poniższych ustawień marketingowych | manage_woocommerce |
| Możliwości ustawień marketingowych | set-facebook-pixel, set-google-tracking | Filtrowane przez adt_pfp_admin_capability, domyślnie manage_options |
WooCommerce domyślnie przyznaje Administratorom i Kierownikom Sklepu uprawnienie manage_woocommerce. Kierownik Sklepu może więc korzystać z każdej funkcji z wyjątkiem set-facebook-pixel i set-google-tracking, które wymagają manage_options, chyba że zmienisz adt_pfp_admin_capability.
Ekran administracyjny kanału wykorzystuje oddzielne uprawnienie. Aby Kierownicy Sklepu również mogli korzystać z tych ekranów, zobacz Jak pozwolić Kierownikowi Sklepu zarządzać kanałami?
Dostęp do zapisu
Każda funkcja zapisu raportuje flagę destructive i idempotent w metadanych swojej rejestracji, widoczną dla każdego klienta API Abilities. Klient MCP, taki jak StoreAgent, może użyć tych flag, aby zdecydować, czy zapytać Cię przed wykonaniem wywołania, ale to, czy Twój asystent może w ogóle zapisywać dane w Twoim sklepie, jest kontrolowane przez trzy rzeczy:
- Uprawnienia Twojego konta użytkownika, z powyższej tabeli.
- Dostęp, który zatwierdziłeś podczas łączenia asystenta. Połączenie zatwierdzone jako tylko do odczytu w StoreAgent nie może wykonać funkcji zapisu, niezależnie od uprawnień Twojego konta. Zobacz Jak połączyć ChatGPT lub Claude z Twoim sklepem za pomocą MCP, aby dowiedzieć się, jak przejrzeć lub zmienić dostęp połączenia.
- Lista dozwolonych funkcji StoreAgent. Funkcje zapisu AdTribes są wyłączone w StoreAgent, dopóki nie włączysz każdej z nich w sekcji StoreAgent > Ustawienia > MCP > Funkcje, w źródle AdTribes. Funkcje odczytu są domyślnie włączone.
Limity odczytu
Funkcje odczytu zwracające listy są ograniczone, aby pojedyncze wywołanie nie mogło pobrać nieograniczonej ilości danych:
| Możliwość | Limit |
|---|---|
adtribes/list-feeds | per_page maksymalnie 500, domyślnie 100 |
adtribes/list-google-taxonomy | limit maksymalnie 5000, domyślnie 200 |
adtribes/get-excluded-products | limit maksymalnie 500, domyślnie 100 |
adtribes/get-channel-summary | Agreguje do 500 kanałów na kanał; powyżej tej liczby zwraca truncated: true |
adtribes/bulk-update-feeds | feed_ids akceptuje do 500 na wywołanie |
Rozwiązywanie problemów
PFP_DISABLE_ABILITIES (lub PFTA_DISABLE_ABILITIES dla dodatku tłumaczeniowego) ani nie zwróciło false z filtra adt_pfp_enable_abilities, ponieważ każde z nich całkowicie wyłącza rejestrację.manage_woocommerce; dwie funkcje ustawień marketingowych wymagają tego, co zwraca adt_pfp_admin_capability (domyślnie manage_options). Potwierdź, że Twoje konto użytkownika lub hasło aplikacji wykonujące wywołanie faktycznie posiada te uprawnienia.FAQ
adtribes/get-tracking-status.adtribes/... pozostały takie same, więc istniejące wywołania nadal działają.adtribes/bulk-update-feeds akceptuje do 500 identyfikatorów kanałów informacyjnych na wywołanie. Aby uzyskać więcej, podziel żądanie na partie.Potrzebujesz więcej pomocy?
Jeśli posiadasz Product Feed Elite, możesz otworzyć zgłoszenie do pomocy technicznej, aby uzyskać priorytetową pomoc w integracji zdolności AI.
Jeśli korzystasz z darmowej wtyczki Product Feed Pro, możesz zadać pytanie na forum pomocy technicznej WordPress.org.
