WordPress Abilities API: 47 Wholesale Acties Voor AI Agents

Stel je een bureau voor dat een dozijn WooCommerce groothandelswinkels beheert. Eén klant wil dat hun AI-assistent offertes goedkeurt. Een andere wil een wekelijkse lijst van top groothandelsklanten zonder dat iemand inlogt. Vóór de WordPress Abilities API betekende elk verzoek het schrijven en onderhouden van een aangepaste endpoint.

Mogelijkheden veranderen dat. Plugins kunnen nu een benoemde lijst van acties publiceren, elk met zijn eigen invoer en toestemmingscontrole, en AI-agenten kunnen ze vinden en uitvoeren. Het moeilijke deel voor een ontwikkelaar is weten wat een echte plugin suite blootlegt en hoe je het onder controle houdt.

Deze handleiding behandelt wat Wholesale Suite registreert als mogelijkheden, wie elke groep kan uitvoeren, hoe aanroepen worden gelogd en hoe alles uit te schakelen. Het is gebaseerd op de eigen documentatie en code van de plugins.

Wat de WordPress Abilities API is

De WordPress Abilities API (WordPress 6.9+) is een centraal register waar plugins benoemde acties declareren met gedefinieerde invoer, uitvoer en toestemmingscontroles. AI-agenten en automatiseringshulpmiddelen kunnen die acties vervolgens ontdekken en ze op een consistente, voorspelbare manier uitvoeren.

Volgens de documentatie van de WordPress Abilities API heeft elke mogelijkheid een paar kerndelen:

• Een unieke naam: Het volgt een namespace/ability-name patroon, plus een leesbaar label en beschrijving.
• Input- en outputschema's: JSON Schema beschrijft wat de mogelijkheid verwacht en wat deze retourneert, zodat een agent weet hoe deze aan te roepen.
• Een categorie: Gerelateerde mogelijkheden worden gegroepeerd.
• Een permissiecallback: Deze optionele controle bepaalt of de huidige gebruiker de mogelijkheid mag uitvoeren.
• Een uitvoer-callback: Dit is de PHP-functie die het werk doet.

Zie het als een restaurantmenu. De keuken kookt nog steeds het eten, maar klanten bestellen uit een vaste lijst met gerechten met duidelijke beschrijvingen. De Abilities API geeft elke plugin hetzelfde menuformaat, zodat elke agent deze kan lezen. Registratie wordt behandeld in de officiële documentatie. Voor een bureau is de nuttige vraag wat een productieplugin suite op dat menu zet.

Hoe mogelijkheden een AI-agent of automatisering bereiken

Mogelijkheden bevinden zich binnen WordPress, dus een AI-assistent heeft een brug nodig om ze te bereiken. Die brug is MCP (Model Context Protocol). Volgens de WordPress MCP-adapterhandleiding vertaalt de MCP-adapter WordPress-mogelijkheden naar MCP-tools, zodat assistenten zoals Claude en ChatGPT ze kunnen ontdekken en aanroepen.

WooCommerce gebruikt dezelfde laag. Volgens de MCP-ontwikkelaarsdocumentatie van WooCommerce registreert WooCommerce zijn eigen product- en ordermogelijkheden op de Abilities API en MCP-adapter. Die functie is nog steeds een ontwikkelaarsvoorvertoning.

Een Wholesale Suite-winkel heeft twee routes naar een agent:

• StoreAgent: Het AI / MCP-tabblad in Wholesale Suite verbindt StoreAgent voor u. De schakelaar Enable MCP write access beheert schrijfmogelijkheden, maar alleen voor StoreAgent-verbindingen.
• Een MCP-adapterplugin: Als u in plaats daarvan een adapter gebruikt, bepaalt de adapter wat de assistent kan doen. De StoreAgent-schakelaar heeft daar geen effect.

Hoe dan ook, elke aanroep wordt uitgevoerd als de geauthenticeerde WordPress-gebruiker, dus de agent krijgt nooit meer toegang dan dat account heeft. Voor het grotere geheel van waar dit past, zie onze gids voor AI-systeemintegratie voor Wholesale Suite.

Welke Wholesale-acties Wholesale Suite blootlegt

Wholesale Suite registreert 47 mogelijkheden in vier plugins. Daarvan zijn er 17 alleen-lezen en 30 maken wijzigingen. U hebt WordPress 6.9 of nieuwer nodig, of WooCommerce 10.9 of nieuwer, omdat beide de Abilities API bieden.

WooCommerce Wholesale Prices 2.3.0 is de schakelaar die dit inschakelt. Het voegt ondersteuning voor de Abilities API toe en maakt mogelijkheden mogelijk voor elke Wholesale Suite-plugin. De vier plugins worden als volgt opgesplitst:

Plugin (minimumversie)	Mogelijkheden	Alleen-lezen voorbeelden	Schrijft voorbeelden	Wie mag de schrijfacties uitvoeren
WooCommerce Wholesale Prices (2.3.0, gratis)	3	Groothandelsprijs ophalen, Groothandelsklanten weergeven	Groothandelsprijs instellen	Shop Manager of Administrator
WooCommerce Wholesale Prices Premium (2.1.3)	15	Groothandelsrollen weergeven, Prijsoverzicht ophalen, Effectieve prijs ophalen	Minimale orderregel instellen, Kortingsregel voor hoeveelheid instellen, Groothandelsrol aanmaken	Alleen beheerder (alle 12 schrijfacties)
WooCommerce Wholesale Order Form (3.1.2)	8	Bestelformulierlijsten, Bestelformulieranalyses ophalen	Bestelformulier dupliceren, Bestelformulier verwijderen	Shop Manager of Administrator
WooCommerce Wholesale Quotes (1.0.3)	21	Offerteslijst, Offertestatistieken ophalen	Offerte goedkeuren, Offerte omzetten naar bestelling, Offertestatus in bulk bijwerken	Winkelmanager of Administrator (instellingen: alleen Administrator)
Totaal	47	17 alleen-lezen	30 wijzigingen aanbrengen

Wholesale Lead Capture en Wholesale Payments registreren nog geen functionaliteiten. Zie de volledige lijst met Wholesale Suite AI-functionaliteiten voor elke functionaliteit met zijn beschrijving en permissie.

WooCommerce Wholesale Prices (3)

De gratis plugin dekt de basis. Een agent kan een groothandelsprijs voor een product of variatie ophalen of instellen, en groothandelsklanten weergeven met hun laatste besteldatum en totale bestedingen.

WooCommerce Wholesale Prices Premium (15)

Premium voegt de prijsregels toe. Drie leesfunctionaliteiten tonen rollen, tellen prijsregels per niveau, en berekenen de effectieve prijs die een klant betaalt. De 12 schrijffunctionaliteiten omvatten globale kortingen, kortingen per categorie en per hoeveelheid, kortingen op het winkelwagen subtotaal, minimale bestellingen, verzending, betaling en belastingvrije mapping, rolcreatie, roltoewijzing, productzichtbaarheid en rollenprijzen.

WooCommerce Wholesale Order Form (8)

Vier leesfunctionaliteiten tonen formulieren, tonen de instellingen van een formulier, retourneren gecombineerde analyses en geven je de embed shortcode. De andere vier maken, dupliceren, updaten of verwijderen bestelformulieren.

WooCommerce Wholesale Quotes (21)

Offertes heeft de grootste set. Agenten kunnen offertes, berichten, geschiedenis, openbare links, statistieken, snelheidslimieten en instellingen lezen. Aan de rechterkant kunnen ze items bewerken, offertes goedkeuren, weigeren, annuleren, omzetten naar bestellingen, tot 50 offertes in bulk bijwerken, berichten verzenden en offertes verwijderen.

Het Permissiemodel

Elke functionaliteit-aanroep wordt uitgevoerd als de WordPress-gebruiker die de verbinding heeft geauthenticeerd. Het account waarmee je verbinding maakt, bepaalt dus wat de agent kan doen.

Wholesale Suite verdeelt toegang in twee niveaus:

• Winkelmanagers en Administrators: Beiden kunnen elke leesfunctionaliteit gebruiken, de gratis 'Groothandelsprijs instellen'-functionaliteit, alle Bestelformulier-functionaliteiten en de meeste Offerte-functionaliteiten.
• Alleen Administrators: De 12 Premium schrijffunctionaliteiten en de twee Offerte-instellingen-functionaliteiten. Ze wijzigen winkelbrede regels, instellingen en gebruikersrollen, dus een Winkelmanager-verbinding kan Premium-prijzen lezen, maar niet wijzigen.

Sommige leesfunctionaliteiten werken ook voor klanten. Een groothandelsklant kan de prijs van zijn eigen rol lezen. Elke ingelogde klant kan vijf Offerte-leesfunctionaliteiten gebruiken, alleen voor zijn eigen offertes: Offerteslijst, Offerte ophalen, Offerteberichtenlijst, Offertegeschiedenislijst en Offerte openbare link ophalen.

Functionaliteiten die gegevens overschrijven of verwijderen, worden gemarkeerd als destructief. Dat vertelt de assistent om te vragen voordat deze ze uitvoert, maar de assistent bepaalt hoe deze vraagt. Schrijffunctionaliteiten wijzigen live gegevens, en sommige, zoals 'Offerte verwijderen' en 'Bestelformulier verwijderen', kunnen niet ongedaan worden gemaakt.

Ons advies voor klantwebsites: maak verbinding als de rol met de minste privileges die de taak kan uitvoeren. Een rapportage-agent heeft alleen Winkelmanager nodig. Als je een opfrisser nodig hebt over hoe rollen op elkaar stapelen, lees dan hoe WooCommerce-klantrollen werken voor groothandel.

Audit Log En Kill Switches

Wholesale Suite biedt twee beheertools: een logboek van elke ability-aanroep en schakelaars om abilities uit te schakelen. Beide zijn gebouwd voor ontwikkelaars die klantwebsites beheren.

Het auditlogboek van abilities

Op WordPress 7.1 of nieuwer, logt Wholesale Suite elke ability-aanroep. Je vindt de vermeldingen onder WooCommerce > Status > Logs door de bron wwp-abilities-audit te kiezen. Dit geeft je een record om te controleren wanneer een klant vraagt wat een agent heeft gewijzigd. Succesvolle aanroepen worden op het Info-niveau geschreven en mislukte op het Error-niveau, dus als je WooCommerce-loginstellingen alleen waarschuwingen en fouten bewaren, worden succesvolle aanroepen niet weergegeven.

Om abilities te laten draaien maar de log uit te schakelen, stel de constante WWP_DISABLE_ABILITIES_AUDIT in of gebruik de filter wwp_disable_abilities_audit.

Abilities uitschakelen

Elke plugin heeft zijn eigen schakelaar. Voeg de constante toe aan wp-config.php, of gebruik de bijbehorende filter in code. Je hebt er maar één van de twee nodig.

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

De WooCommerce Wholesale Prices schakelaar is suite-breed. Het schakelt de abilities van elke Wholesale Suite plugin uit, niet alleen die van zichzelf. De andere drie filters volgen hetzelfde patroon: wwpp_disable_abilities, wwof_disable_abilities en wwq_disable_abilities.

Wat we hebben gezien: het detail dat de moeite waard is om rond te bouwen is 'Wijs gebruiker toe aan groothandelsrol'. Het vervangt elke rol die een gebruiker heeft, inclusief Shop Manager of Editor, hoewel het je laatste Administrator niet aanraakt. Elke automatisering die klanten tussen niveaus verplaatst, moet eerst hun huidige rollen controleren. 'Update offerte' werkt op dezelfde manier met items, aangezien de lijst die je stuurt de hele itemlijst vervangt.

Automatisering Gebruiksscenario's Voor Bureaus

Abilities zijn het meest nuttig wanneer je een klantverzoek koppelt aan een korte reeks benoemde acties. Hier zijn vier scenario's die je zou kunnen bouwen:

• Wekelijkse samenvatting (alleen-lezen): Stel je een klant voor die een maandagochtend samenvatting wil. Een agent kan 'Lijst groothandelsklanten' uitvoeren, gesorteerd op levenslange uitgaven, en vervolgens 'Offertestatistieken ophalen' voor de afgelopen week. Niets verandert, dus een Shop Manager-verbinding is voldoende.
• Offerte triage: Een agent lijst offertes op status, markeert degenen die een mens nodig hebben, en gebruikt vervolgens 'Bulk offerte status bijwerken' op maximaal 50 tegelijk. 'Goedkeuren' en 'Weigeren' sturen de gebruikelijke e-mails naar de klant. 'Annuleren' stuurt geen e-mails.
• Prijsaudit voor lancering: Voordat een prijsverandering live gaat, voer je 'Prijsoverzicht ophalen' en 'Effectieve prijs ophalen' uit voor een paar testklanten. Houd er rekening mee dat 'Effectieve prijs ophalen' kortingen op winkelwagenhoeveelheid, kortingen op winkelwagentotaal en geplande uitverkoopprijzen uitsluit.
• Onderhoud van bestelformulier: Gebruik 'Bestelformulier dupliceren' om een formulier als concept te kopiëren voordat je het bewerkt, zodat het live formulier onaangetast blijft.

Niet elke taak heeft een agent nodig. Voor op regels gebaseerde niveauwijzigingen, zoals het verhogen van een klant na het besteden van een bepaald bedrag, is automatisering van groothandelsrollen ingebouwd en heeft helemaal geen AI-verbinding nodig.

Abilities API versus de Wholesale Suite REST API

Gebruik de REST API voor systeem-naar-systeem synchronisatie, en gebruik abilities wanneer een agent of automatiseringshulpmiddel acties moet ontdekken met ingebouwde permissiecontroles.

De Wholesale Suite REST API gebruikt de wholesale/v1 en wwlc/v1 namespaces. Het biedt batch-endpoints, plus Premium korting en analytics endpoints. Dat maakt het een goede keuze voor een ERP-synchronisatie of een bulkcatalogusupdate, waarbij uw eigen code weet welk endpoint aangeroepen moet worden.

Abilities zijn geschikt voor een ander doel. Elk beschrijft zichzelf, controleert de permissies van de beller, en wordt gelogd op WordPress 7.1+. Een agent kan zelf uitzoeken wat er beschikbaar is, zonder dat u een aangepast endpoint voor elke klant hoeft te schrijven.

Een bureau-build kan beide gebruiken: REST voor de geplande synchronisatie, abilities voor ad hoc verzoeken via een assistent.

Bouw Agent-Klaar Groothandelswinkels Met De WordPress Abilities API

De WordPress Abilities API geeft bureaus iets wat ze nog niet eerder hadden: een gedocumenteerde, permissie-gecontroleerde actielaag die elke klantwinkel deelt. In plaats van eenmalige endpoints per klant te onderhouden, krijgt u een bekende lijst met groothandelsacties, een logboek van wat er is uitgevoerd, en een schakelaar om alles uit te schakelen.

Uw volgende stappen:

• Leer wat de Abilities API is zodat u het aan klanten kunt uitleggen.
• Kies uw groothandels abilities per plugin.
• Verbind met de rol met de minste privileges die elke taak dekt.
• Stel het audit logboek en de kill switches in voordat u een site overdraagt.
• Kies tussen abilities en REST voor elke integratie.

Klaar om agent-klare groothandelswinkels te bouwen met de WordPress Abilities API? De Wholesale Suite bundel bevat de premium plugins achter alle vier de ability sets en dekt onbeperkte sites, wat geschikt is voor bureaus die meerdere klantwinkels beheren.

Veelgestelde Vragen Over De WordPress Abilities API