WordPress Abilities API: 47 Wholesale-Aktionen für KI-Agenten

Stellen Sie sich eine Agentur vor, die ein Dutzend WooCommerce-Großhandelsgeschäfte betreut. Ein Kunde möchte, dass sein KI-Assistent Angebote genehmigt. Ein anderer möchte eine wöchentliche Liste der Top-Großhandelskunden, ohne dass sich jemand anmelden muss. Vor der WordPress Abilities API bedeutete jede Anfrage, einen benutzerdefinierten Endpunkt zu schreiben und zu warten.

Fähigkeiten ändern das. Plugins können jetzt eine benannte Liste von Aktionen veröffentlichen, jede mit ihren eigenen Eingaben und Berechtigungsprüfungen, und KI-Agenten können sie finden und ausführen. Der schwierige Teil für einen Entwickler ist zu wissen, was eine echte Plugin-Suite freigibt und wie man sie unter Kontrolle hält.

Diese Anleitung behandelt, was Wholesale Suite als Fähigkeiten registriert, wer jede Gruppe ausführen kann, wie Aufrufe protokolliert werden und wie alles deaktiviert wird. Sie basiert auf der Dokumentation und dem Code der Plugins selbst.

Was die WordPress Abilities API ist

Die WordPress Abilities API (WordPress 6.9+) ist ein zentrales Verzeichnis, in dem Plugins benannte Aktionen mit definierten Eingaben, Ausgaben und Berechtigungsprüfungen deklarieren. KI-Agenten und Automatisierungstools können diese Aktionen dann auf konsistente und vorhersehbare Weise entdecken und ausführen.

Gemäß der Dokumentation der WordPress Abilities API hat jede Fähigkeit einige Kernbestandteile:

• Ein eindeutiger Name: Er folgt dem Muster namespace/ability-name, plus einer lesbaren Bezeichnung und Beschreibung.
• Eingabe- und Ausgabeschemata: JSON Schema beschreibt, was die Fähigkeit erwartet und was sie zurückgibt, damit ein Agent weiß, wie er sie aufrufen kann.
• Eine Kategorie: Verwandte Fähigkeiten werden gruppiert.
• Eine Berechtigungs-Callback-Funktion: Diese optionale Prüfung entscheidet, ob der aktuelle Benutzer die Fähigkeit ausführen darf.
• Eine Ausführungs-Callback-Funktion: Dies ist die PHP-Funktion, die die Arbeit erledigt.

Stellen Sie es sich wie eine Restaurant-Speisekarte vor. Die Küche kocht immer noch das Essen, aber die Kunden bestellen aus einer festen Liste von Gerichten mit klaren Beschreibungen. Die Abilities API gibt jedem Plugin das gleiche Menüformat, sodass jeder Agent es lesen kann. Die Registrierung wird in der offiziellen Dokumentation behandelt. Für eine Agentur ist die nützliche Frage, was eine Produktions-Plugin-Suite auf dieser Speisekarte anbietet.

Wie Fähigkeiten einen KI-Agenten oder eine Automatisierung erreichen

Fähigkeiten leben in WordPress, daher benötigt ein KI-Assistent eine Brücke, um sie zu erreichen. Diese Brücke ist MCP (Model Context Protocol). Laut dem Handbuch für den WordPress MCP-Adapter übersetzt der MCP-Adapter WordPress-Fähigkeiten in MCP-Tools, sodass Assistenten wie Claude und ChatGPT sie entdecken und aufrufen können.

WooCommerce verwendet dieselbe Ebene. Gemäß der MCP-Entwicklerdokumentation von WooCommerce registriert WooCommerce seine eigenen Produkt- und Bestellfähigkeiten in der Abilities API und dem MCP-Adapter. Diese Funktion ist noch eine Entwicklervorschau.

Ein Wholesale Suite-Shop hat zwei Wege zu einem Agenten:

• StoreAgent: Der KI / MCP-Tab in Wholesale Suite verbindet StoreAgent für Sie. Sein Schalter für den Schreibzugriff auf MCP aktiviert Schreibfähigkeiten, aber nur für StoreAgent-Verbindungen.
• Ein MCP-Adapter-Plugin: Wenn Sie stattdessen einen Adapter verwenden, entscheidet der Adapter, was der Assistent tun kann. Der StoreAgent-Schalter hat dort keine Auswirkung.

In jedem Fall läuft jeder Aufruf als authentifizierter WordPress-Benutzer, sodass der Agent niemals mehr Zugriff erhält, als dieses Konto hat. Für das Gesamtbild, wo dies passt, siehe unseren Leitfaden zur KI-Systemintegration für Wholesale Suite.

Welche Wholesale-Aktionen Wholesale Suite bereitstellt

Wholesale Suite registriert 47 Fähigkeiten in vier Plugins. Davon sind 17 schreibgeschützt und 30 nehmen Änderungen vor. Sie benötigen WordPress 6.9 oder neuer oder WooCommerce 10.9 oder neuer, da eines von beiden die Abilities API bereitstellt.

WooCommerce Wholesale Prices 2.3.0 ist der Schalter, der dies aktiviert. Er fügt Unterstützung für die Abilities API hinzu und aktiviert Fähigkeiten für jedes Wholesale Suite-Plugin. Die vier Plugins gliedern sich wie folgt:

Plugin (Mindestversion)	Fähigkeiten	Schreibgeschützte Beispiele	Schreibbeispiele	Wer die Schreibvorgänge ausführen kann
WooCommerce Wholesale Prices (2.3.0, kostenlos)	3	Großhandelspreis abrufen, Großhandelskunden auflisten	Großhandelspreis festlegen	Shop-Manager oder Administrator
WooCommerce Wholesale Prices Premium (2.1.3)	15	Großhandelsrollen auflisten, Preisübersicht abrufen, Effektiven Preis abrufen	Mindestbestellregel festlegen, Mengenrabattregel festlegen, Großhandelsrolle erstellen	Nur Administrator (alle 12 Schreibvorgänge)
WooCommerce Wholesale Order Form (3.1.2)	8	Bestellformulare auflisten, Bestellformular-Analysen abrufen	Bestellformular duplizieren, Bestellformular löschen	Shop-Manager oder Administrator
WooCommerce Wholesale Quotes (1.0.3)	21	Angebote auflisten, Angebotsstatistiken abrufen	Angebot genehmigen, Angebot in Bestellung umwandeln, Angebotsstatus per Massenaktualisierung ändern	Shop-Manager oder Administrator (Einstellungen: Nur Administrator)
Gesamt	47	17 Lesezugriff	30 Änderungen vornehmen

Wholesale Lead Capture und Wholesale Payments registrieren noch keine Fähigkeiten. Eine vollständige Liste der Wholesale Suite KI-Fähigkeiten finden Sie unter alle Wholesale Suite KI-Fähigkeiten.

WooCommerce Wholesale Prices (3)

Das kostenlose Plugin deckt die Grundlagen ab. Ein Agent kann einen Großhandelspreis für ein Produkt oder eine Variante abrufen oder festlegen und Großhandelskunden mit ihrem letzten Bestelldatum und ihrem Gesamtumsatz auflisten.

WooCommerce Wholesale Prices Premium (15)

Premium fügt die Preisregeln hinzu. Drei Lesezugriffsfähigkeiten listen Rollen auf, zählen Preisregeln nach Stufe und ermitteln den effektiven Preis, den ein Kunde zahlt. Die 12 Schreibzugriffsfähigkeiten umfassen globale Rabatte, Rabatte für Kategorien und Mengen, Rabatte auf den Warenkorb-Gesamtwert, Mindestbestellmengen, Versand-, Zahlungs- und Steuerbefreiungszuordnungen, Rollenerstellung, Rollenzuweisung, Produktsichtbarkeit und Rollenpreise.

WooCommerce Wholesale Order Form (8)

Vier Lesezugriffsfähigkeiten listen Formulare auf, zeigen die Einrichtung eines Formulars an, geben kombinierte Analysen zurück und liefern den Einbettungs-Shortcode. Die anderen vier erstellen, duplizieren, aktualisieren oder löschen Bestellformulare.

WooCommerce Wholesale Quotes (21)

Angebote hat den größten Umfang. Agenten können Angebote, Nachrichten, Verlauf, öffentliche Links, Statistiken, Ratenbegrenzungen und Einstellungen lesen. Auf der rechten Seite können sie Artikel bearbeiten, Angebote genehmigen, ablehnen, stornieren, in Bestellungen umwandeln, bis zu 50 Angebote per Massenaktualisierung ändern, Nachrichten senden und Angebote löschen.

Das Berechtigungsmodell

Jeder Fähigkeitsaufruf wird als der WordPress-Benutzer ausgeführt, der die Verbindung authentifiziert hat. Das Konto, mit dem Sie sich verbinden, bestimmt also, was der Agent bearbeiten kann.

Wholesale Suite teilt den Zugriff in zwei Stufen auf:

• Shop-Manager und Administratoren: Beide können jede Lesezugriffsfähigkeit, die kostenlose Fähigkeit „Großhandelspreis festlegen“, alle Bestellformular-Fähigkeiten und die meisten Angebots-Fähigkeiten nutzen.
• Nur Administratoren: Die 12 Premium-Schreibzugriffsfähigkeiten und die beiden Angebots-Einstellungen-Fähigkeiten. Sie ändern geschäftsweite Regeln, Einstellungen und Benutzerrollen, sodass eine Shop-Manager-Verbindung Premium-Preise lesen, aber nicht ändern kann.

Einige Lesezugriffsfähigkeiten funktionieren auch für Kunden. Ein Großhandelskunde kann den Preis seiner eigenen Rolle lesen. Jeder angemeldete Kunde kann fünf Angebots-Lesezugriffsfähigkeiten nur für seine eigenen Angebote nutzen: Angebote auflisten, Angebot abrufen, Angebotsnachrichten auflisten, Angebotsverlauf auflisten und öffentlichen Angebotslink abrufen.

Fähigkeiten, die Daten überschreiben oder entfernen, sind als destruktiv gekennzeichnet. Das weist den Assistenten an, vorher zu fragen, bevor er sie ausführt, aber der Assistent entscheidet, wie er fragt. Schreibzugriffsfähigkeiten ändern Live-Daten, und einige, wie „Angebot löschen“ und „Bestellformular löschen“, können nicht rückgängig gemacht werden.

Unser Rat für Kunden-Websites: Verbinden Sie sich mit der Rolle mit den geringsten Berechtigungen, die die Aufgabe erfüllen kann. Ein Reporting-Agent benötigt nur den Shop-Manager. Wenn Sie eine Auffrischung benötigen, wie Rollen gestapelt werden, lesen Sie wie WooCommerce-Kundenrollen für den Großhandel funktionieren.

Audit-Protokoll und Kill-Schalter

Wholesale Suite bietet Ihnen zwei Steuerungswerkzeuge: ein Protokoll jeder Fähigkeitsaufrufung und Schalter, die Fähigkeiten deaktivieren. Beide sind für Entwickler konzipiert, die Kunden-Websites verwalten.

Das Fähigkeits-Audit-Protokoll

Ab WordPress 7.1 oder neuer protokolliert Wholesale Suite jede Fähigkeitsaufrufung. Sie finden die Einträge unter WooCommerce > Status > Protokolle, indem Sie die Quelle wwp-abilities-audit auswählen. Dies gibt Ihnen einen Datensatz zur Überprüfung, wenn ein Kunde fragt, was ein Agent geändert hat. Erfolgreiche Aufrufe werden auf Info-Ebene und fehlgeschlagene auf Fehlerebene geschrieben. Wenn Ihre WooCommerce-Protokolleinstellungen also nur Warnungen und Fehler speichern, werden erfolgreiche Aufrufe nicht angezeigt.

Um Fähigkeiten weiterhin auszuführen, aber das Protokoll zu stoppen, setzen Sie die Konstante WWP_DISABLE_ABILITIES_AUDIT oder verwenden Sie den Filter wwp_disable_abilities_audit.

Fähigkeiten deaktivieren

Jedes Plugin hat seinen eigenen Schalter. Fügen Sie die Konstante zu wp-config.php hinzu oder verwenden Sie den entsprechenden Filter im Code. Sie benötigen nur eine der beiden Optionen.

// 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' );

Der WooCommerce Wholesale Prices-Schalter ist für die gesamte Suite. Er deaktiviert die Fähigkeiten jedes Wholesale Suite-Plugins, nicht nur die eigenen. Die anderen drei Filter folgen demselben Muster: wwpp_disable_abilities, wwof_disable_abilities und wwq_disable_abilities.

Was wir gesehen haben: Das Detail, das den Aufbau wert ist, ist die Zuweisung einer Rolle für Großhandelskunden. Es ersetzt jede Rolle, die ein Benutzer innehat, einschließlich Shop-Manager oder Redakteur, berührt jedoch nicht Ihren letzten Administrator. Jede Automatisierung, die Kunden zwischen Stufen verschiebt, sollte zuerst ihre aktuellen Rollen überprüfen. Das Aktualisieren von Angeboten funktioniert genauso mit Artikeln, da die von Ihnen gesendete Liste die gesamte Artikelliste ersetzt.

Automatisierungsanwendungsfälle für Agenturen

Fähigkeiten sind am nützlichsten, wenn Sie eine Kundenanfrage einer kurzen Kette benannter Aktionen zuordnen. Hier sind vier Szenarien, die Sie erstellen könnten:

• Wöchentlicher Bericht (nur Lesezugriff): Stellen Sie sich einen Kunden vor, der eine Montagszusammenfassung wünscht. Ein Agent kann Großhandelskunden auflisten, sortiert nach lebenslangem Umsatz, und dann Angebotsstatistiken für die letzte Woche abrufen. Nichts wird geändert, daher reicht eine Shop-Manager-Verbindung aus.
• Angebots-Triage: Ein Agent listet Angebote nach Status auf, markiert diejenigen, die einen Menschen benötigen, und verwendet dann die Massenaktualisierung des Angebotsstatus für bis zu 50 gleichzeitig. Genehmigen und Ablehnen senden dem Kunden die üblichen E-Mails. Abbrechen sendet keine.
• Audit vor Preisänderungen: Bevor eine Preisänderung live geht, führen Sie die Übersicht der Preise abrufen und den effektiven Preis abrufen für einige Testkunden aus. Beachten Sie, dass der effektive Preis Rabatte für die Warenkorbmenge, Rabatte für den Warenkorb-Gesamtwert und geplante Verkaufspreise ausschließt.
• Bestellformular-Wartung: Verwenden Sie die Funktion Bestellformular duplizieren, um ein Formular als Entwurf zu kopieren, bevor Sie es bearbeiten, damit das Live-Formular unverändert bleibt.

Nicht jede Aufgabe erfordert einen Agenten. Für regelbasierte Stufenänderungen, wie z. B. das Hochstufen eines Kunden, nachdem er einen bestimmten Betrag ausgegeben hat, ist die Automatisierung der Großhandelsrolle integriert und benötigt überhaupt keine KI-Verbindung.

Fähigkeiten-API im Vergleich zur REST-API von Wholesale Suite

Verwenden Sie die REST-API für die System-zu-System-Synchronisierung und nutzen Sie Fähigkeiten, wenn ein Agent oder ein Automatisierungstool Aktionen mit integrierten Berechtigungsprüfungen erkennen muss.

Die REST-API der Wholesale Suite verwendet die Namespaces wholesale/v1 und wwlc/v1. Sie bietet Batch-Endpunkte sowie Premium-Rabatt- und Analyse-Endpunkte. Das macht sie zu einer guten Wahl für eine ERP-Synchronisierung oder eine Massenkatalogaktualisierung, bei der Ihr eigener Code weiß, welchen Endpunkt er aufrufen soll.

Fähigkeiten eignen sich für eine andere Aufgabe. Jede beschreibt sich selbst, prüft die Berechtigungen des Aufrufers und wird ab WordPress 7.1+ protokolliert. Ein Agent kann selbst herausfinden, was verfügbar ist, ohne dass Sie für jeden Kunden einen benutzerdefinierten Endpunkt schreiben müssen.

Ein Agentur-Build kann beides nutzen: REST für die geplante Synchronisierung, Fähigkeiten für Ad-hoc-Anfragen über einen Assistenten.

Erstellen Sie Agenten-bereite Großhandelsgeschäfte mit der WordPress Abilities API

Die WordPress Abilities API gibt Agenturen etwas, das sie noch nie zuvor hatten: eine dokumentierte, berechtigungsgeprüfte Aktionsebene, die jeder Kundenshop gemeinsam nutzt. Anstatt einmalige Endpunkte pro Kunde zu pflegen, erhalten Sie eine bekannte Liste von Großhandelsaktionen, ein Protokoll darüber, was ausgeführt wurde, und einen Schalter, um alles auszuschalten.

Ihre nächsten Schritte:

• Erfahren Sie, was die Abilities API ist, damit Sie sie Ihren Kunden erklären können.
• Wählen Sie Ihre Großhandelsfähigkeiten nach Plugin aus.
• Verbinden Sie sich mit der Rolle mit den geringsten Berechtigungen, die jede Aufgabe abdeckt.
• Richten Sie das Audit-Protokoll und die Not-Aus-Schalter ein, bevor Sie eine Website übergeben.
• Wählen Sie für jede Integration zwischen Fähigkeiten und REST.

Bereit, Agenten-bereite Großhandelsgeschäfte mit der WordPress Abilities API zu erstellen? Das Wholesale Suite Bundle enthält die Premium-Plugins hinter allen vier Fähigkeitssätzen und deckt unbegrenzte Websites ab, was für Agenturen, die mehrere Kundenshops betreiben, gut geeignet ist.

Häufig gestellte Fragen zur WordPress Abilities API