WordPress Abilities API: 47 Wholesale Actions For AI Agents

Wyobraź sobie agencję, która zarządza kilkunastoma sklepami WooCommerce dla odbiorców hurtowych. Jeden klient chce, aby jego asystent AI zatwierdzał wyceny. Inny chce cotygodniową listę najlepszych klientów hurtowych bez konieczności logowania się kogokolwiek. Przed wprowadzeniem WordPress Abilities API każde takie żądanie wymagało napisania i utrzymania niestandardowego punktu końcowego.

Funkcje to zmieniają. Wtyczki mogą teraz publikować nazwaną listę akcji, każda z własnymi danymi wejściowymi i sprawdzeniem uprawnień, a agenci AI mogą je znaleźć i uruchomić. Najtrudniejszą częścią dla dewelopera jest wiedza o tym, co udostępnia rzeczywisty pakiet wtyczek i jak nad tym zapanować.

Ten przewodnik omawia, co Wholesale Suite rejestruje jako funkcje, kto może uruchamiać każdą grupę, jak logowane są wywołania i jak wszystko wyłączyć. Opiera się na własnej dokumentacji i kodzie wtyczek.

Czym jest WordPress Abilities API

WordPress Abilities API (WordPress 6.9+) to centralny rejestr, w którym wtyczki deklarują nazwane akcje z określonymi danymi wejściowymi, wyjściowymi i sprawdzeniem uprawnień. Agenci AI i narzędzia automatyzacji mogą następnie odkrywać te akcje i uruchamiać je w spójny, przewidywalny sposób.

Zgodnie z dokumentacją WordPress Abilities API, każda funkcja ma kilka podstawowych części:

• Unikalna nazwa: Ma wzorzec namespace/nazwa-funkcji, a także czytelną etykietę i opis.
• Schematy wejścia i wyjścia: JSON Schema opisuje, czego oczekuje funkcja i co zwraca, dzięki czemu agent wie, jak ją wywołać.
• Kategoria: Powiązane funkcje są grupowane razem.
• Callback uprawnień: To opcjonalne sprawdzenie decyduje, czy bieżący użytkownik może uruchomić funkcję.
• Callback wykonania: To jest funkcja PHP, która wykonuje pracę.

Pomyśl o tym jak o karcie w restauracji. Kuchnia nadal gotuje jedzenie, ale klienci zamawiają z ustalonej listy dań z jasnymi opisami. API Funkcji daje każdemu pluginowi ten sam format menu, dzięki czemu każdy agent może je odczytać. Rejestracja jest omówiona w oficjalnej dokumentacji. Dla agencji, użytecznym pytaniem jest to, co produkcyjna paczka pluginów umieszcza w tym menu.

Jak funkcje docierają do agenta AI lub automatyzacji

Funkcje znajdują się wewnątrz WordPressa, więc asystent AI potrzebuje mostu, aby do nich dotrzeć. Tym mostem jest MCP (Model Context Protocol). Zgodnie z podręcznikiem adaptera MCP WordPress, adapter MCP tłumaczy funkcje WordPress na narzędzia MCP, dzięki czemu asystenci tacy jak Claude i ChatGPT mogą je odkrywać i wywoływać.

WooCommerce używa tej samej warstwy. Zgodnie z dokumentacją deweloperską WooCommerce MCP, WooCommerce rejestruje swoje własne funkcje produktów i zamówień w API Funkcji i adapterze MCP. Ta funkcja jest nadal w wersji deweloperskiej.

Sklep Wholesale Suite ma dwa sposoby dotarcia do agenta:

• StoreAgent: Zakładka AI / MCP w Wholesale Suite łączy StoreAgent dla Ciebie. Jej przełącznik Włącz dostęp do zapisu MCP kontroluje funkcje zapisu, ale tylko dla połączeń StoreAgent.
• Wtyczka adaptera MCP: Jeśli używasz adaptera, adapter decyduje, co asystent może zrobić. Przełącznik StoreAgent nie ma tam wpływu.

Tak czy inaczej, każde wywołanie jest uruchamiane jako uwierzytelniony użytkownik WordPress, więc agent nigdy nie otrzymuje większych uprawnień niż ma dane konto. Aby uzyskać szerszy obraz tego, gdzie to się mieści, zobacz nasz przewodnik po integracji systemu AI dla Wholesale Suite.

Jakie akcje Wholesale Suite udostępnia Wholesale Suite

Wholesale Suite rejestruje 47 funkcji w czterech wtyczkach. Z nich 17 to tylko do odczytu, a 30 dokonuje zmian. Potrzebujesz WordPress 6.9 lub nowszego, lub WooCommerce 10.9 lub nowszego, ponieważ jedno z nich zapewnia API Funkcji.

WooCommerce Wholesale Prices 2.3.0 to przełącznik, który to włącza. Dodaje obsługę API Funkcji i włącza funkcje dla każdej wtyczki Wholesale Suite. Cztery wtyczki rozpadają się w następujący sposób:

Wtyczka (minimalna wersja)	Funkcje	Przykłady tylko do odczytu	Przykłady zapisu	Kto może wykonywać zapisy
WooCommerce Wholesale Prices (2.3.0, darmowy)	3	Pobierz cenę hurtową, Lista klientów hurtowych	Ustaw cenę hurtową	Kierownik sklepu lub Administrator
WooCommerce Wholesale Prices Premium (2.1.3)	15	Lista ról hurtowych, Przegląd cen, Pobierz cenę efektywną	Ustaw regułę minimalnego zamówienia, Ustaw regułę rabatu ilościowego, Utwórz rolę hurtową	Tylko administrator (wszystkie 12 zapisów)
WooCommerce Wholesale Order Form (3.1.2)	8	Lista formularzy zamówień, Analiza formularzy zamówień	Duplikuj formularz zamówienia, Usuń formularz zamówienia	Kierownik sklepu lub Administrator
WooCommerce Wholesale Quotes (1.0.3)	21	Lista ofert, Statystyki ofert	Zatwierdź ofertę, Przekształć ofertę w zamówienie, Zbiorcza aktualizacja statusu oferty	Kierownik sklepu lub Administrator (ustawienia: tylko Administrator)
Suma	47	17 tylko do odczytu	30 wprowadzaj zmiany

Wholesale Lead Capture i Wholesale Payments jeszcze nie rejestrują żadnych uprawnień. Pełną listę uprawnień AI Wholesale Suite wraz z ich opisami i uprawnieniami znajdziesz w pełnej liście uprawnień AI Wholesale Suite.

WooCommerce Wholesale Prices (3)

Darmowy plugin obejmuje podstawy. Agent może uzyskać lub ustawić cenę hurtową dla produktu lub wariantu, a także listować klientów hurtowych z datą ich ostatniego zamówienia i całkowitą wydaną kwotą.

WooCommerce Wholesale Prices Premium (15)

Wersja Premium dodaje zasady cenowe. Trzy uprawnienia do odczytu obejmują listowanie ról, zliczanie zasad cenowych według poziomu i obliczanie efektywnej ceny, którą płaci klient. Jego 12 uprawnień do zapisu obejmuje rabaty globalne, kategorii i ilościowe, rabaty od łącznej kwoty koszyka, minimalne zamówienia, wysyłkę, płatności i mapowanie zwolnień z podatku, tworzenie ról, przypisywanie ról, widoczność produktów i ceny dla ról.

WooCommerce Wholesale Order Form (8)

Cztery uprawnienia do odczytu obejmują listowanie formularzy, wyświetlanie konfiguracji formularza, zwracanie połączonych analiz i podawanie krótkiego kodu do osadzenia. Pozostałe cztery tworzą, duplikują, aktualizują lub usuwają formularze zamówień.

WooCommerce Wholesale Quotes (21)

Oferty mają największy zestaw. Agenci mogą odczytywać oferty, wiadomości, historię, linki publiczne, statystyki, limity szybkości i ustawienia. Po prawej stronie mogą edytować pozycje, zatwierdzać, odrzucać, anulować, przekształcać oferty w zamówienia, zbiorczo aktualizować do 50 ofert, wysyłać wiadomości i usuwać oferty.

Model uprawnień

Każde wywołanie uprawnienia jest wykonywane jako użytkownik WordPress, który uwierzytelnił połączenie. Zatem konto, z którym się łączysz, decyduje o tym, co agent może zrobić.

Wholesale Suite dzieli dostęp na dwa poziomy:

• Kierownicy sklepów i Administratorzy: Obaj mogą korzystać z każdego uprawnienia do odczytu, darmowego uprawnienia Ustaw cenę hurtową, wszystkich uprawnień Formularza Zamówień i większości uprawnień Ofert.
• Tylko Administratorzy: 12 uprawnień do zapisu w wersji Premium i dwa uprawnienia do ustawień Ofert. Zmieniają zasady, ustawienia i role użytkowników w całym sklepie, więc połączenie Kierownika sklepu może odczytywać ceny Premium, ale nie może ich zmieniać.

Niektóre uprawnienia do odczytu działają również dla klientów. Klient hurtowy może odczytać cenę swojej roli. Każdy zalogowany klient może używać pięciu uprawnień do odczytu Ofert tylko dla swoich ofert: Listuj oferty, Pobierz ofertę, Listuj wiadomości oferty, Listuj historię oferty i Pobierz link publiczny do oferty.

Uprawnienia, które nadpisują lub usuwają dane, są oznaczone jako destrukcyjne. To informuje asystenta, aby zapytał przed ich uruchomieniem, ale asystent decyduje, jak zapyta. Uprawnienia do zapisu zmieniają dane na żywo, a niektóre, takie jak Usuń ofertę i Usuń formularz zamówienia, nie mogą zostać cofnięte.

Nasza rada dla stron klientów: łącz się jako rola o najmniejszych uprawnieniach, która może wykonać zadanie. Agent raportujący potrzebuje tylko roli Kierownika sklepu. Jeśli potrzebujesz przypomnienia, jak role się nakładają, przeczytaj jak działają role klientów WooCommerce dla sprzedaży hurtowej.

Dziennik audytu i przełączniki wyłączające

Wholesale Suite daje Ci dwa narzędzia zarządzania: dziennik każdego wywołania zdolności i przełączniki, które wyłączają zdolności. Oba są stworzone dla deweloperów zarządzających witrynami klientów.

Dziennik audytu zdolności

W WordPress 7.1 lub nowszym, Wholesale Suite rejestruje każde wywołanie zdolności. Znajdziesz wpisy w WooCommerce > Status > Logi, wybierając źródło wwp-abilities-audit. Daje Ci to zapis do sprawdzenia, gdy klient pyta, co zmienił agent. Pomyślne wywołania są zapisywane na poziomie Info, a nieudane na poziomie Error, więc jeśli Twoje ustawienia logów WooCommerce zachowują tylko ostrzeżenia i błędy, pomyślne wywołania się nie pojawią.

Aby zdolności działały, ale zatrzymać logowanie, ustaw stałą WWP_DISABLE_ABILITIES_AUDIT lub użyj filtra wwp_disable_abilities_audit.

Wyłączanie zdolności

Każda wtyczka ma swój własny przełącznik. Dodaj stałą do wp-config.php lub użyj pasującego filtra w kodzie. Potrzebujesz tylko jednego z tych dwóch.

// All Wholesale Suite plugins (set in wp-config.php)
define( 'WWP_DISABLE_ABILITIES', true );
// Premium abilities only
define( 'WWPP_DISABLE_ABILITIES', true );
// Order Form abilities only
define( 'WWOF_DISABLE_ABILITIES', true );
// Quotes abilities only
define( 'WWQ_DISABLE_ABILITIES', true );
// Filter version of the suite-wide switch
add_filter( 'wwp_disable_abilities', '__return_true' );

Przełącznik WooCommerce Wholesale Prices obejmuje cały pakiet. Wyłącza zdolności każdej wtyczki Wholesale Suite, nie tylko swojej własnej. Pozostałe trzy filtry działają na tej samej zasadzie: wwpp_disable_abilities, wwof_disable_abilities i wwq_disable_abilities.

Co zaobserwowaliśmy: szczegółem wartym uwagi jest przypisanie użytkownika do roli hurtowej. Zastępuje ona każdą rolę posiadaną przez użytkownika, w tym Menedżera Sklepu lub Edytora, chociaż nie dotknie Twojego ostatniego Administratora. Każda automatyzacja, która przenosi klientów między poziomami, powinna najpierw sprawdzić ich obecne role. Aktualizacja oferty działa tak samo z produktami, ponieważ wysłana lista zastępuje całą listę produktów.

Przypadki użycia automatyzacji dla agencji

Zdolności są najbardziej użyteczne, gdy mapujesz żądanie klienta do krótkiego łańcucha nazwanych akcji. Oto cztery scenariusze, które możesz zbudować:

• Cotygodniowy raport (tylko do odczytu): Wyobraź sobie klienta, który chce podsumowania w poniedziałek. Agent może uruchomić Listę klientów hurtowych, posortowaną według całkowitej kwoty wydatków, a następnie Pobierz statystyki ofert z ostatniego tygodnia. Nic się nie zmienia, więc wystarczy połączenie Menedżera Sklepu.
• Triage ofert: Agent listuje oferty według statusu, oznacza te, które wymagają interwencji człowieka, a następnie używa Masowej aktualizacji statusu oferty dla maksymalnie 50 jednocześnie. Zatwierdź i Odrzuć wysyłają klientowi zwykłe e-maile. Anuluj nie wysyła żadnych.
• Audyt cen przed uruchomieniem: Zanim zmiana ceny wejdzie w życie, uruchom Pobierz przegląd cen i Pobierz cenę efektywną dla kilku klientów testowych. Pamiętaj, że Pobierz cenę efektywną nie uwzględnia rabatów ilościowych w koszyku, rabatów od wartości koszyka i cen promocyjnych.
• Porządkowanie formularza zamówienia: Użyj Kopiuj formularz zamówienia, aby skopiować formularz jako szkic przed jego edycją, dzięki czemu aktywny formularz pozostanie nietknięty.

Nie każde zadanie wymaga agenta. W przypadku zmian poziomów opartych na regułach, takich jak przeniesienie klienta wyżej po osiągnięciu określonej kwoty, automatyzacja ról hurtowych jest wbudowana i w ogóle nie wymaga połączenia AI.

API Zdolności kontra API REST WooCommerce

Użyj interfejsu REST API do synchronizacji system-system, a zdolności, gdy agent lub narzędzie automatyzacji potrzebuje odkryć akcje z wbudowanymi kontrolami uprawnień.

Interfejs REST API Wholesale Suite REST API używa przestrzeni nazw wholesale/v1 i wwlc/v1. Oferuje punkty końcowe wsadowe, a także punkty końcowe rabatów Premium i analityki. To sprawia, że ​​dobrze nadaje się do synchronizacji ERP lub masowej aktualizacji katalogu, gdzie własny kod wie, który punkt końcowy wywołać.

Zdolności nadają się do innego zadania. Każda z nich opisuje siebie, sprawdza uprawnienia dzwoniącego i jest logowana w WordPress 7.1+. Agent może samodzielnie dowiedzieć się, co jest dostępne, bez pisania niestandardowego punktu końcowego dla każdego klienta.

Budowa agencji może wykorzystywać oba: REST do zaplanowanej synchronizacji, zdolności do żądań ad hoc za pośrednictwem asystenta.

Twórz sklepy hurtowe gotowe na agentów za pomocą WordPress Abilities API

WordPress Abilities API daje agencjom coś, czego wcześniej nie miały: udokumentowaną warstwę akcji sprawdzaną pod kątem uprawnień, którą udostępnia każdy sklep klienta. Zamiast utrzymywać jednorazowe punkty końcowe dla każdego klienta, otrzymujesz znaną listę akcji hurtowych, dziennik tego, co zostało wykonane, i przełącznik, aby to wszystko wyłączyć.

Twoje następne kroki:

• Dowiedz się, czym jest Abilities API, aby móc wyjaśnić to klientom.
• Wybierz swoje zdolności hurtowe według wtyczki.
• Połącz się z rolą o najmniejszych uprawnieniach, która obejmuje każde zadanie.
• Skonfiguruj dziennik audytu i wyłączniki przed przekazaniem witryny.
• Wybierz między zdolnościami a REST dla każdej integracji.

Gotowy do tworzenia sklepów hurtowych gotowych na agentów za pomocą WordPress Abilities API? Pakiet Wholesale Suite bundle zawiera wtyczki premium stojące za wszystkimi czterema zestawami zdolności i obejmuje nieograniczoną liczbę witryn, co jest idealne dla agencji prowadzących kilka sklepów klientów.

Często zadawane pytania dotyczące WordPress Abilities API