Jak agenci AI czytają i działają na danych Twojej WooCommerce Wishlist

Wielu właścicieli sklepów WooCommerce słyszało o „AI” jako widżecie czatu w rogu strony produktu. Więc kiedy klient pyta, co AI może zrobić z danymi sklepu, uczciwa odpowiedź brzmiała zazwyczaj „niewiele”.

To się zmienia. WordPress 6.9 dodał do rdzenia Abilities API. Jest to standard, który pozwala wtyczce publikować nazwane akcje, które inne oprogramowanie może odkryć i wywołać. SaveTo Wishlist Pro rejestruje 15 z nich, zaczynając od wydania, które wprowadziło obsługę Abilities API.

Ten przewodnik omawia dostęp do danych z list życzeń agenta WooCommerce AI po stronie właściciela sklepu, a nie dewelopera. Zobaczysz, czym jest zdolność, jakie dane z list życzeń agent może odczytać i co może zmienić. Omówię również model uprawnień, jak połączyć klienta i gdzie to wszystko się kończy.

Przejdź do:

---

Czym właściwie jest WordPress Abilities API

WordPress Abilities API to standardowy sposób publikowania przez wtyczkę nazwanych rzeczy, które potrafi zrobić. Oprogramowanie spoza WordPressa może następnie znaleźć te akcje i uruchomić je bez niestandardowej integracji.

Pomyśl o tym jak o karcie w restauracji. Bez niej każdy gość musiałby wejść do kuchni i wyjaśnić, czego chce. Karta wymienia dania i co do nich dołączono, a kuchnia decyduje, kto zostanie obsłużony. Zdolności wykonują tę pracę dla Twojej witryny.

Gdzie w tym wszystkim jest MCP

Każda zdolność ma nazwę, zdefiniowane wejście, zdefiniowane wyjście i sprawdzenie uprawnień. Ta struktura ma znaczenie z powodu drugiego standardu, Model Context Protocol, zwykle skracanego do MCP. MCP to wspólny format, którego klienci AI używają do znajdowania dostępnych narzędzi i ich wywoływania.

Jednak WordPress sam z siebie nie mówi w MCP. Wtyczka mostu, taka jak oficjalny MCP Adapter, zamienia zdolności w narzędzia, które klient MCP może listować. Nasza siostrzana wtyczka StoreAgent również uruchamia serwer MCP, z ustawieniami do przeglądania zdolności, które rejestrują Twoje wtyczki.

Sekwencja wygląda następująco:

1. Wtyczka rejestruje swoje zdolności. Odbywa się to w Twojej witrynie, w kodzie, podczas ładowania wtyczki.
2. Klient łączy się przez most i pyta, co jest dostępne. Otrzymuje uporządkowaną listę nazwanych akcji, a nie ścianę dokumentacji.
3. Zadajesz pytanie w zwykłym języku. Coś w stylu „które produkty ludzie najczęściej zapisują w tym miesiącu?”
4. Klient wybiera pasującą zdolność i ją wywołuje. Odpowiedź wraca z Twoich danych sklepowych na żywo.

Nie ma eksportu, arkusza kalkulacyjnego ani niestandardowego łącznika dla każdego narzędzia AI. Twój sklep publikuje menu raz, a każdy klient mówiący w MCP może je zamówić, gdy połączysz go.

---

Jak umiejętność wygląda w praktyce

Zdolność to jedna nazwana akcja z ustalonym wejściem, ustalonym wyjściem i sprawdzeniem uprawnień, które uruchamia się najpierw. Jest celowo mała, więc jedna zdolność wykonuje jedno zadanie w ten sam sposób za każdym razem.

SaveTo Wishlist Pro rejestruje swoje zdolności pod prefiksem saveto-wishlist/, w jednej kategorii zdolności o nazwie saveto-wishlist. W rezultacie każda nazwa zdolności informuje Cię, z której wtyczki pochodzi.

Inne wtyczki Rymera używają tego samego API. Advanced Coupons, na przykład, pozwala zarządzać kuponami WooCommerce za pomocą AI.

Weź get-product-insights. Jest tylko do odczytu, więc jego wywołanie niczego nie zmienia. Na przykład, zapytaj asystenta, które produkty klienci najczęściej zapisują, a zwróci on Twoje najpopularniejsze, najmodniejsze i ostatnio dodane produkty. Dalsze zapytanie dotyczące kategorii kieruje do get-category-insights, które grupuje aktywność na listach życzeń według kategorii i marki.

Teraz weź share-wishlist-by-link. Zapisuje dane, więc jest oznaczony jako destrukcyjny. Jest również oznaczony jako idempotentny, więc można go bezpiecznie ponawiać. Innymi słowy, dwukrotne wywołanie go z tym samym wejściem kończy się w tym samym stanie.

Jeśli sam piszesz kod dla sklepu, interfejs API REST jest nadal właściwym narzędziem. Przewodnik dla programistów interfejsu API REST do list życzeń obejmuje te punkty końcowe. Niemniej jednak te dwa elementy łatwo się zacierają. Punkty końcowe REST nadają się do oprogramowania, które budujesz i kontrolujesz, podczas gdy zdolności nadają się do oprogramowania, którego nie zbudowałeś, jak klient AI.

---

Model uprawnień i co agent może zrobić

Każda zdolność przed wykonaniem czegokolwiek uruchamia funkcję zwrotną uprawnień, a to sprawdzenie jest rdzeniem bezpieczeństwa. Krótko mówiąc, klient AI proszący grzecznie nie poszerza tego, co użytkownik może zrobić.

SaveTo Wishlist Pro używa dwóch funkcji zwrotnych, ale ustalają one ten sam poziom:

• Zdolności destrukcyjne: wszystko, co zapisuje lub zmienia dane, działa za pośrednictwem funkcji zwrotnej can_manage_woocommerce. To terytorium menedżera sklepu, a nie zwykłego gościa.
• Zdolności tylko do odczytu: używają one oddzielnej funkcji zwrotnej can_view_data, ale sprawdza ona tę samą zdolność manage_woocommerce. Odczyt wymaga tego samego konta co zapis.

Każda zdolność niesie również adnotacje MCP zbudowane na podstawie jej flag destrukcyjności i idempotentności. Te adnotacje informują klienta, zanim ten wywoła cokolwiek, czy narzędzie zmienia dane i czy ponowienie jest bezpieczne.

Jeszcze jedna decyzja projektowa ma większe znaczenie niż wszystko powyższe. Każda destrukcyjna zdolność przekazuje dane do tej samej warstwy usług, której używają ekrany administracyjne, bez oddzielnej ścieżki kodu tylko dla AI. Więc kiedy agent wysyła listę życzeń e-mailem, uruchamiane są te same akcje WordPress i WooCommerce, co gdy robisz to Ty. Te same e-maile są wysyłane i uruchamiane są te same haki.

To może brzmieć jak sucha notatka architektoniczna. W praktyce oznacza to, że agent nie ma drogi na skróty omijającej Twoje logowanie, Twoje integracje ani powiadomienia dla klientów. To sprawia, że funkcja jest czymś, co możesz audytować.

❗️🔍️ Co sprawdzić: niektóre narzędzia dodają oddzielną ścieżkę kodu dla zautomatyzowanego dostępu. Zdarzenia, które uruchamiają się po kliknięciu przez człowieka, mogą wtedy nigdy nie uruchomić się po kliknięciu zautomatyzowanym. Kiedy tak się dzieje, system CRM może przestać odbierać rekordy, a nikt tego nie zauważy. Cokolwiek podłączysz, zapytaj, czy jego zautomatyzowana ścieżka uruchamia ten sam kod, co jego ekrany administracyjne.

---

Co SaveTo Wishlist Pro udostępnia agentom AI

SaveTo Wishlist Pro rejestruje jedną kategorię zdolności i 15 zdolności pod prefiksem saveto-wishlist/. Pojawiły się one w wersji Pro 1.0.2, wydanej 30 czerwca 2026.

Te zdolności raportują o danych, które Twoi klienci tworzą każdego dnia. Na przykład, klient klika przycisk listy życzeń, a to kliknięcie staje się zapisem, który zdolność analityczna może później zliczyć. W darmowym pluginie SaveTo Wishlist Lite przycisk jest widoczny na stronach sklepu od razu po instalacji. Po zapisaniu produktu, jego etykieta zmienia się na „Usuń z listy życzeń”.

Cztery zdolności na początek

Oto cztery, z których prawdopodobnie skorzystasz najpierw:

Grupa zdolności	Przykładowa zdolność	Zmienia dane?
Udostępnianie	Udostępnij listę życzeń przez link	Tak, można bezpiecznie ponowić próbę
Wgląd w produkt	Pobierz statystyki produktów	Nie
Wgląd w kategorię	Pobierz statystyki kategorii	Nie
Trendy	Pobierz trendy czasowe	Nie

Pełna lista 15 zdolności znajduje się po tej sekcji. Każda z tych czterech odpowiada na inne pytanie:

• Udostępnianie: share-wishlist-by-link tworzy lub odświeża link do udostępnienia listy życzeń. Ponieważ jest to funkcja idempotentna, agent może bezpiecznie ponowić próbę po utracie połączenia.
• Wgląd w produkt: get-product-insights odpowiada na pytanie merchandisingowe. Które produkty są zapisywane, a które zyskują na popularności?
• Wgląd w kategorię: get-category-insights grupuje aktywność na listach życzeń według kategorii i marki, dzięki czemu widzisz popyt w całym zakresie, a nie tylko dla jednego SKU.
• Trendy: get-time-based-trends obejmuje dodawanie produktów w czasie i wzorce dnia tygodnia. To jest różnica między wiedzą, że produkt jest popularny, a wiedzą, kiedy ludzie decydują, że go chcą.

Dodatkowo, Pro wyświetla te raporty w swoich ekranach analityki list życzeń. Zdolności są dodatkową drogą do tych samych danych, nie jedyną.

Który plan potrzebujesz

Oto, który produkt co robi. SaveTo Wishlist Lite to darmowy plugin i pozostaje darmowy. SaveTo Wishlist Pro to płatny plugin, który rejestruje zdolności i jest zawarty we wszystkich trzech planach cenowych.

Growth kosztuje 49,50 USD za pierwszy rok i odnawia się za 99 USD. Plus kosztuje 99,50 USD za pierwszy rok i odnawia się za 199 USD. Business kosztuje 199,50 USD za pierwszy rok i odnawia się za 399 USD. Dodatek Rejestr Prezentów jest dostępny tylko z planami Plus i Business, nie z Growth.

---

Wszystkie 15 umiejętności i co każda z nich może zmienić

Dziewięć z 15 zdolności tylko odczytuje dane. Pozostałe sześć coś zmienia, a dwie z nich mogą wysyłać e-maile. Oto pełny zestaw:

Funkcja	Co robi	Zmienia dane?
Udostępnij listę życzeń przez link	Tworzy lub odświeża link do udostępnienia dla jednej listy życzeń. Nie są wysyłane żadne e-maile.	Tak, można bezpiecznie ponowić próbę
Udostępnij listę życzeń przez e-mail	Wysyła listę życzeń na podany adres e-mail, z opcjonalną wiadomością.	Tak
Wyświetl udostępnione listy życzeń	Wyświetla udostępnione listy życzeń i ich odbiorców.	Nie
Wyświetl automatyzacje	Wyświetla Twoje automatyzacje, filtrowane według statusu, wyzwalacza lub akcji, jeśli zapytasz.	Nie
Pobierz automatyzację	Zwraca pełną konfigurację jednej automatyzacji.	Nie
Utwórz automatyzację	Tworzy nową automatyzację z wyzwalacza i akcji.	Tak
Zaktualizuj automatyzację	Edytuje istniejącą automatyzację.	Tak, można bezpiecznie ponowić próbę
Przełącz automatyzację	Włącza lub wyłącza automatyzację. Bez podanego statusu odwraca bieżący.	Tak, można bezpiecznie ponowić próbę
Wyświetl klientów z listami życzeń	Wyświetla listę klientów z aktywnymi listami życzeń, od najbardziej aktywnych.	Nie
Pobierz podsumowanie listy życzeń klienta	Podsumowuje listy życzeń jednego klienta, jego przedmioty, wartość i ostatnią aktywność.	Nie
Wyślij powiadomienie ręczne	Uruchamia akcję automatyzacji dla jednego klienta, natychmiast.	Tak
Pobierz ogólne statystyki	Kluczowe wskaźniki, w tym współczynnik konwersji i trend w porównaniu do poprzedniego okresu.	Nie
Pobierz statystyki produktów	Najpopularniejsze, najczęściej wyszukiwane i ostatnio dodane produkty.	Nie
Pobierz statystyki kategorii	Aktywność na listach życzeń pogrupowana według kategorii i marki.	Nie
Pobierz trendy czasowe	Dodatki w czasie i wzorce dnia tygodnia.	Nie

Szczegóły, które zmieniają to, o co powinieneś pytać

Kilka szczegółów w tej tabeli kształtuje to, o co powinieneś pytać agenta:

• Odczyty nadal mogą zwracać dane osobowe. list-wishlist-customers i get-customer-wishlist-summary zwracają imiona, adresy e-mail i całkowitą kwotę wydaną przez klienta. Konfiguracje automatyzacji mogą zawierać nagłówki uwierzytelniające webhook. Traktuj połączone konto jak każde logowanie pracownika.
• Trendy produktowe analizują ostatnie 7 dni, chyba że poprosisz o 30. get-product-insights akceptuje tylko te dwa okresy. get-time-based-trends domyślnie analizuje 30 dni i akceptuje również 7, 90 lub 365. Poproś o coś innego, a cicho użyje domyślnego.
• Niektóre odpowiedzi są ograniczone. Wnioski dotyczące produktów zwracają 10 najpopularniejszych i 10 najczęściej wyszukiwanych produktów, plus 8 ostatnio dodanych. Listy klientów domyślnie zawierają 15 pozycji, a listy udostępnione do 100. Żadna nie przekracza 200.
• trigger-manual-notification wysyła faktycznie. Uruchamia akcję istniejącej automatyzacji dla jednego klienta: e-mail, wywołanie webhooka lub aktualizację metadanych użytkownika. Automatyzacje oparte na produktach odmawiają uruchomienia bez identyfikatora produktu, więc nie wysłane zastępcze symbole zastępcze nigdy nie zostaną wysłane.

---

Jak podłączyć klienta AI do Twojego sklepu

Rejestrowanie możliwości samo w sobie niczego nie łączy. Połączenie odbywa się za pośrednictwem wtyczki MCP Adapter, z jednym dodatkowym krokiem, który łatwo przeoczyć.

Domyślny serwer adaptera listuje tylko możliwości oznaczone jako publiczne, a SaveTo Wishlist Pro nie oznacza swoich możliwości w ten sposób. W rezultacie klient skierowany do domyślnego serwera ich nie znajdzie. Zamiast tego rejestrujesz własny mały serwer, który pozwala również wybrać, jakie możliwości oferuje.

Skonfiguruj to krok po kroku

Oto konfiguracja, od początku do końca:

1. Zainstaluj MCP Adapter. Jest to oficjalna, darmowa wtyczka WordPress dla MCP, zainstalowana ze strony wydań GitHub. Wymaga WordPressa w wersji 6.9 lub nowszej.
2. Wybierz konto, którego będzie używał agent. Każda możliwość sprawdza uprawnienie manage_woocommerce, które WooCommerce przyznaje Administratorom i Kierownikom Sklepu. Dedykowany użytkownik Kierownika Sklepu oddziela aktywność agenta od Twojego własnego logowania.
3. Utwórz hasło aplikacji dla tego użytkownika. Przejdź do sekcji Użytkownicy, edytuj użytkownika i przewiń do sekcji Hasła aplikacji. Wpisz etykietę w polu Nazwa nowego hasła aplikacji, a następnie kliknij Dodaj hasło aplikacji. Skopiuj je od razu, ponieważ WordPress nie pokaże go ponownie.
4. Zarejestruj serwer wymieniający pożądane możliwości. Dodaj poniższy fragment do wtyczki specyficznej dla witryny lub wtyczki fragmentów kodu.
5. Skieruj swojego klienta na serwer. Większość klientów stacjonarnych łączy się za pośrednictwem proxy @automattic/mcp-wordpress-remote, które pobiera adres URL serwera, nazwę użytkownika i hasło aplikacji.

add_action( 'mcp_adapter_init', function ( $adapter ) {
    $adapter->create_server(
        'stw-agent',                  // Server ID
        'stw-agent',                  // REST namespace
        'mcp',                        // REST route
        'SaveTo Wishlist Agent',
        'Read-only SaveTo Wishlist abilities',
        '1.0.0',
        array( \WP\MCP\Transport\HttpTransport::class ),
        \WP\MCP\Infrastructure\ErrorHandling\ErrorLogMcpErrorHandler::class,
        null,
        array(
            'saveto-wishlist/get-overview-insights',
            'saveto-wishlist/get-product-insights',
            'saveto-wishlist/get-category-insights',
            'saveto-wishlist/get-time-based-trends',
            'saveto-wishlist/list-wishlist-customers',
            'saveto-wishlist/get-customer-wishlist-summary',
            'saveto-wishlist/list-shared-wishlists',
            'saveto-wishlist/list-automations',
            'saveto-wishlist/get-automation',
        )
    );
} );

Ten fragment udostępnia tylko dziewięć możliwości tylko do odczytu. Aby umożliwić agentowi działanie, dodawaj możliwości zapisu z powyższej tabeli pojedynczo. Przy użytych tutaj identyfikatorach punkt końcowy to https://yourstore.com/wp-json/stw-agent/mcp.

Jak odciąć dostęp

Pamiętaj, że hasło aplikacji niesie ze sobą pełne uprawnienia użytkownika w całym interfejsie REST API, a nie tylko te możliwości. Kliknięcie Cofnij obok niego na tym samym ekranie natychmiast odcina agenta.

Jeśli uruchamiasz StoreAgent, ma on własny przewodnik po połączeniu Claude i ChatGPT z Twoim sklepem.

Jak sprawdzić, czy zadziałało

Poproś klienta o listę jego narzędzi. Każda możliwość pojawia się z ukośnikiem zamienionym na łącznik, na przykład saveto-wishlist-get-overview-insights. Następnie spróbuj zadać pytanie tylko do odczytu, na przykład o trend wskaźnika konwersji Twojej listy życzeń.

Dwa wyniki wskazują na konkretne poprawki:

• Brak narzędzi SaveTo Wishlist na liście. Klient jest prawdopodobnie nadal skierowany na domyślny serwer, więc sprawdź, czy jego adres URL kończy się na /stw-agent/mcp. Upewnij się również, że nikt nie wyłączył rejestracji.
• Błąd uprawnień przy każdym wywołaniu. Połączony użytkownik nie ma uprawnień manage_woocommerce. Przełącz klienta na konto Menedżera sklepu lub Administratora.

---

Jak włączyć lub wyłączyć dostęp agenta

Rejestracja możliwości jest domyślnie włączona i posiada trzy wyłączniki. Dwa z nich są do Twojej dyspozycji.

1. Brak funkcji. Jeśli funkcja wp_register_ability() nie jest dostępna w witrynie, SaveTo Wishlist Pro całkowicie pomija rejestrację. Nic nie generuje błędów, nic nie rejestruje się częściowo, a wtyczka kontynuuje swoją normalną pracę.

2. Stała. Ustawienie STWPRO_DISABLE_ABILITIES na wartość logiczną prawdziwą również pomija rejestrację. Zdefiniuj ją w miejscu, które ładuje się przed wtyczkami, co w praktyce oznacza wp-config.php lub wtyczkę must-use:

define( 'STWPRO_DISABLE_ABILITIES', true );

3. Filtr. Zwrócenie wartości true z filtra stwpro_disable_abilities ma taki sam efekt. Nadaje się do witryn, które przechowują tego rodzaju decyzje w wtyczce specyficznej dla witryny:

add_filter( 'stwpro_disable_abilities', '__return_true' );

Każda z tych trzech opcji oznacza, że żadna możliwość nie jest zarejestrowana, więc żaden klient nie może jej odkryć ani wywołać. Nie ma stanu częściowego, który można by analizować, co jest przydatne w przypadku przełącznika, który może być potrzebny do szybkiego działania.

---

Czego to jeszcze nie robi

Pokrycie AI często pomija limity, więc oto rzeczywiste limity.

• Brak autonomicznego zakupu. Żadna z 15 funkcji nie pozwala agentowi na złożenie zamówienia, wydanie pieniędzy ani dokonanie zakupu w imieniu klienta.
• Brak obchodzenia modelu uprawnień. Konto, które nie może zarządzać WooCommerce, nie może wywoływać tych funkcji, prosząc asystenta o zrobienie tego zamiast.
• Stałe menu, nie otwarty dostęp. Z SaveTo Wishlist, 15 nazwanych funkcji to cała lista. Agent nie może wymyślić szesnastej, zapytać dowolnych tabel ani uzyskać dostępu do funkcji, których nikt nie zarejestrował.
• Klient nadal musi się połączyć. Rejestracja funkcji nie publikuje niczego w otwartym Internecie. Klient musi połączyć się przez serwer MCP, z poświadczeniami, które przejdą weryfikację uprawnień.
• Tylko odczytuje to, co przechowuje sklep. Zapisy gościa pozostają w jego przeglądarce, dopóki się nie zaloguje lub nie zarejestruje. W tym momencie elementy przenoszą się na jego konto i stają się danymi, które funkcja może raportować.

Ogólnie rzecz biorąc, większość z nich jest celowa, a nie przeoczenia czekające na poprawkę. To model uprawnień wykonuje swoją pracę, co jest lepsze niż funkcja, która potajemnie przyznaje więcej, niż oczekiwano.

---

Często zadawane pytania

---

Przygotuj dane swojej listy życzeń WooCommerce na działanie agentów

Ciekawa jest nie tylko możliwość, że asystent odpowie na pytanie dotyczące Twojego sklepu. Chodzi o to, że nikt nie musiał najpierw tworzyć łącznika dla tego konkretnego asystenta. Zamiast tego, wspólny standard dokonał wprowadzenia, a Twoje dane z listy życzeń były gotowe, ponieważ były już ustrukturyzowane, autoryzowane i nazwane.

Oto, co z tym zrobić:

• Zapoznaj się z interfejsem WordPress Abilities API, zanim podłączysz cokolwiek do swojego sklepu.
• Sprawdź model uprawnień w każdym podłączonym wtyczce, zwłaszcza czy zautomatyzowane wywołania uruchamiają ten sam kod co ekrany administratora.
• Zdecyduj, na jakie spostrzeżenia chcesz, aby agent odpowiadał, a następnie dopasuj je do możliwości, które je zwracają.
• Połącz klienta za pośrednictwem własnego serwera, zaczynając od dziewięciu możliwości tylko do odczytu.
• Zanotuj wyłączniki teraz, aby decyzja była już podjęta, jeśli kiedykolwiek będziesz jej potrzebować.
• Ustal oczekiwania ze swoim zespołem dotyczące tego, czego agent tutaj nie może zrobić.

Zapisy na listę życzeń są jednym z najwcześniejszych sygnałów intencji, jakie otrzymuje Twój sklep. Dlatego warto je wykorzystać do odzyskiwania porzuconych przeglądów i warto je udostępniać grupie. Uczynienie tych danych czytelnymi dla agentów AI jest praktycznym pierwszym krokiem w kierunku handlu agentowego.