Skip to main content

Vermogensreferens

Vermogens is die atome aksies wat Gratis AI Agent op jou WordPress-installasie kan oproep. Elke vermoë is 'n geregistreerde PHP-klas wat 'n JSON skema blootstel — die agent lees hierdie skema tydens die uitvoering om te verstaan watter parameters nodig is en wat die vermoë teruggee.

Hierdie bladsy dokumenteer alle vermogens wat saam met Gratis AI Agent v1.9.0 verskaf word.


Spesiale Posttipes (Custom Post Types)

Hierdie vermogens bestuur spesiale posttipes (CPTs) wat deur die agent geregistreer is. Registrasies word aan die WordPress opsie-tafel behou sodat hulle oor plugin-deaktivering en heraktivering bly.

register_post_type

Registreer 'n nuwe spesiale posttipe.

Parameters

ParameterTipeVereisBeskrywing
slugstringJaDie posttipe sleutel (maks. 20 karakters, geen hoofletters nie, geen spasies nie)
singular_labelstringJaMensleerbare enkelnaam, bv. Portfolio Item
plural_labelstringJaMensleerbare meervoudnaam, bv. Portfolio Items
publicbooleanNeeOf die posttipe publiek toeganklik is. Standaard true
supportsarrayNeeFunksies wat ondersteun word: title, editor, thumbnail, excerpt, comments, revisions, custom-fields. Standaard ["title","editor"]
has_archivebooleanNeeOf 'n posttipe arkiefbladsy ingesluit is. Standaard false
menu_iconstringNeeDashicons klas of URL vir die admin-menu-ikoon. Standaard "dashicons-admin-post"
rewrite_slugstringNeeDie URL-sleutel vir die posttipe. Standaard slug

Voorbeeld

{
"slug": "portfolio",
"singular_label": "Portfolio Item",
"plural_label": "Portfolio Items",
"public": true,
"supports": ["title", "editor", "thumbnail"],
"has_archive": true,
"menu_icon": "dashicons-portfolio"
}

Teruggee { "success": true, "slug": "portfolio" }


list_post_types

Gee alle spesiale posttipes terug wat deur die agent geregistreer is.

Parameters — geen

Teruggee

{
"post_types": [
{
"slug": "portfolio",
"singular_label": "Portfolio Item",
"plural_label": "Portfolio Items",
"public": true
}
]
}

delete_post_type

Onregistreer 'n spesiale posttipe wat voorheen deur die agent geregistreer is. Beste posts van daardie tipe bly in die database, maar is nie meer via die posttipe toeganklik nie.

Parameters

ParameterTipeVereisBeskrywing
slugstringJaDie posttipe sleutel om te verwyder

Teruggee { "success": true, "slug": "portfolio" }


Spesiale Taksonemies (Custom Taxonomies)

Hierdie vermogens bestuur spesiale taksonemies. Soos CPT's word taksonemiese registrasies behou.

register_taxonomy

Registreer 'n nuwe spesiale taksonomie.

Parameters

ParameterTipeVereisBeskrywing
slugstringJaDie taksonomiese sleutel (maks. 32 karakters)
singular_labelstringJaMensleerbare enkelnaam, bv. Project Category
plural_labelstringJaMensleerbare meervoudnaam, bv. Project Categories
post_typesarrayJaPosttipe-sleutels waaraan hierdie taksonomie gekoppel moet word
hierarchicalbooleanNeetrue vir kategorie-styl, false vir tag-styl. Standaard true
publicbooleanNeeOf terme publiek toeganklik is. Standaard true
rewrite_slugstringNeeDie URL-sleutel vir die taksonomie. Standaard slug

Voorbeeld

{
"slug": "project-category",
"singular_label": "Project Category",
"plural_label": "Project Categories",
"post_types": ["portfolio"],
"hierarchical": true
}

Teruggee { "success": true, "slug": "project-category" }


list_taxonomies

Gee alle spesiale taksonemies terug wat deur die agent geregistreer is.

Parameters — geen

Teruggee

{
"taxonomies": [
{
"slug": "project-category",
"singular_label": "Project Category",
"post_types": ["portfolio"],
"hierarchical": true
}
]
}

delete_taxonomy

Onregistreer 'n spesiale taksonomie wat voorheen deur die agent geregistreer is.

Parameters

ParameterTipeVereisBeskrywing
slugstringJaDie taksonomiese sleutel om te verwyder

Teruggee { "success": true, "slug": "project-category" }


Ontwerpstelsel (Design System)

Ontwerpstelsel vermogens wys die visuele vertoning van die WordPress-werf — van spesifieke CSS tot blokpatrone en die webwerf se logo.

inject_custom_css

Voeg CSS aan die <head> van die werf by via wp_add_inline_style. CSS word in die opsie gratis_ai_agent_custom_css gestoor en skoon verwyder wanneer die vermoë hergeset word.

Parameters

ParameterTipeVereisBeskrywing
cssstringJaGeldige CSS om in te voeg
labelstringNeeMensleerbare etikette vir hierdie CSS-blok, gebruik in debug-logs. Standaard "agent-injected"
replacebooleanNeeIndien true, vervang dit alle voorheen ingevoegde CSS. Standaard false (voeg by)

Voorbeeld

{
"css": ":root { --primary: #1a1a2e; --accent: #e94560; } body { font-family: 'Inter', sans-serif; }",
"label": "brand-colours",
"replace": false
}

Teruggee { "success": true, "bytes": 96 }


add_block_pattern

Registreer 'n herbruikbare blokpatroon in die WordPress pattern biblioteki.

Parameters

ParameterTipeVereisBeskrywing
slugstringJaPatroon-identifikator, bv. gratis/hero-dark
titlestringJaMensleerbare patroonnaam wat in die editor getoon word
contentstringJaGeserialiseerde blok-merker (HTML) vir die patroon
categoriesarrayNeePatroon kategorie-sleutels, bv. ["featured", "hero"]
descriptionstringNeeKort beskrywing wat in die patroonkiegetoon word
keywordsarrayNeeSoekwoorde

Teruggee { "success": true, "slug": "gratis/hero-dark" }


list_block_patterns

Gee alle blokpatrone terug wat deur die agent geregistreer is.

Parameters — geen

Stel die WordPress-situslogo na 'n gegee attachment ID of 'n verre remote beeld URL. Wanneer 'n URL verskaf word, word die beeld gedownload en ingevoeg in die Media Library.

Parameters

ParameterTipeVereisBeskrywing
attachment_idintegerNieID van 'n bestaande Media Library attachment
urlstringNieRemote beeld URL om te importeer en as logo te stel

Een van attachment_id of url moet verskaf word.

Teruggegee { "success": true, "attachment_id": 42 }


apply_theme_json_preset

Pas 'n genaamde kleur-/tipografie-preset toe op die aktiewe tema se theme.json (of global-styles). Presets is gekurateerde pakkies wat deur die Gratis AI Agent span gehandhaaf word.

Parameters

ParameterTipeVereisBeskrywing
presetstringJaPreset naam, bv. minimal-dark, warm-editorial, corporate-blue
mergebooleanNieAs true, voeg dit saam met bestaande waardes by eerder as om te vervang. Standaard false

Beschikbare presets

PresetBeskrywing
minimal-darkNa-swart agtergrond, wit teks, enkele aksentkleur
warm-editorialWarm off-wit agtergrond, serif koppe, aardse aksentkleure
corporate-blueNavy en wit palet met professionele tipografie
vibrant-startupHelder gradiënte, afgeronde hoeke, moderne sans-serif tipe
classic-blogNeutrale grys, gemaklike lynhoogte, tradisionele lay-out spasie

Teruggegee { "success": true, "preset": "minimal-dark" }


Globale Stye

Globale Stye-vermoëns lees en skryf theme.json waardes deur die WordPress Global Styles API, wat alle blokke en temate se sitewys beïnvloed.

get_global_styles

Gee die huidige globale stye-konfigurasie terug.

Parameters

ParameterTipeVereisBeskrywing
pathstringNieJSON-pointer na 'n spesifieke waarde, bv. /color/palette of /typography/fontSizes. Gee die hele objek terug as dit oorgelatem word.

Teruggegee die volledige globale stye-objek of die waarde by path.


set_global_styles

Maak een of meer waardes in die globale stye-konfigurasie op hoogte.

Parameters

ParameterTipeVereisBeskrywing
pathstringJaJSON-pointer na die waarde wat gestel moet word, bv. /color/palette
valueanyJaDie nuwe waarde

Voorbeeld — voeg 'n kleur by die palet

{
"path": "/color/palette",
"value": [
{ "slug": "primary", "color": "#1a1a2e", "name": "Primary" },
{ "slug": "accent", "color": "#e94560", "name": "Accent" }
]
}

Teruggegee { "success": true, "path": "/color/palette" }


reset_global_styles

Herstel alle agent-toepaslike globale styeverandertjies en herstel die tema-standaarde.

Parameters — geen

Teruggegee { "success": true }


Navigasie Menu-vermoëns skep en bestuur WordPress nav-menue en hul items.

create_menu

Skep 'n nuwe WordPress navigasie menu.

Parameters

ParameterTipeVereisBeskrywing
namestringJaMenu naam, bv. Primary Navigation
locationstringNieTema-lokasie waarvoor jy hierdie menu toewys, bv. primary

Teruggegee { "success": true, "menu_id": 7 }


update_menu

Verander die naam van 'n menu of herwis dit na 'n tema-lokasie.

Parameters

ParameterTipeVereisBeskrywing
menu_idintegerJaID van die menu wat gewys moet word
namestringNieNuwe menu naam
locationstringNieTema-lokasie om aan te wys of te herwis

Teruggegee { "success": true, "menu_id": 7 }


add_menu_item

Voeg 'n item by 'n bestaande navigasie menu.

Parameters

ParameterTipeVereisBeskrywing
menu_idintegerJaID van die doel-menu
typestringJaItem tipe: custom, post_type, of taxonomy
titlestringNieEtiket vir die menu-item (vereis vir custom tipe)
urlstringNieURL vir custom items
object_idintegerNiePost ID of term ID vir post_type/taxonomy items
parent_idintegerNieMenu-item ID om hierdie item onder te nestel
positionintegerNieZero-gebaseerde posisie in die menu

Teruggegee { "success": true, "item_id": 12 }


remove_menu_item

Verwyder 'n item uit 'n navigasie menu.

Parameters

ParameterTipeVereisBeskrywing
item_idintegerJaMenu-item ID om te verwyder

Teruggegee { "success": true, "item_id": 12 }


list_menus

List al die WordPress navigasie menus, insluitend hul toegewys tema-lokasies.

Parameters — geen

Teruggegee

{
"menus": [
{
"menu_id": 7,
"name": "Primary Navigation",
"location": "primary",
"item_count": 5
}
]
}

Opsies Bestuur

Opsies-vermoëns lees en skryf WordPress opsies via get_option / update_option. 'n Ingeboude veiligheidsbloklys voorkom aksidentele wysiging van kritieke instellings.

get_option

Lees 'n WordPress opsie.

Parameters

ParameterTipeVereisBeskrywing
option_namestringJaDie opsie-sleutel, bv. blogname

Teruggegee { "option_name": "blogname", "value": "My Site" }

Gee 'n fout terug as option_name op die veiligheidsbloklys is.


set_option

Skryf 'n WordPress opsie.

Parameters

ParameterTipeVereisBeskrywing
option_namestringJaDie opsie-sleutel
valueanyJaDie nuwe waarde (word outomaties vir arrays/objekte geserialiseer)
autoloadstringNie"yes" of "no". Standaard behou die bestaande autoload-instellings

Geeft 'n fout terug as option_name op die veiligheidsbloklys staan.

Teruggee { "success": true, "option_name": "blogname" }


delete_option

Verwyder 'n WordPress-opsie.

Parameters

ParameterTipeVereisBeskrywing
option_namestringJaDie opsie-sleutel om te verwyder

Geeft 'n fout terug as option_name op die veiligheidsbloklys staan.

Teruggee { "success": true, "option_name": "my_custom_option" }


list_options

List WordPress-opsies wat ooreenstem met 'n patroon.

Parameters

ParameterTipeVereisBeskrywing
patternstringNeeSQL LIKE-patroon om opsie-name te filter, bv. gratis_%. Gee alle opsies terug as dit oorgelatem (gebruik met versigt op groot databasetjies).
limitintegerNeeMaksimum aantal resultate. Standaard 50, maks 500

Teruggee

{
"options": [
{ "option_name": "gratis_ai_agent_version", "autoload": "yes" }
],
"total": 1
}

Inhoudbestuur (Content Management)

Inhoudbestuur-vermoëns skep en wys WordPress-posts en -bladsy's. Post-ID's word teruggegee sodat die volgende stappe in meervormige vermoënsplanne verwys na die geskep inhoud kan doen.

create_post

Skep 'n nuwe WordPress-post, bladsy of aangepaste post-tipe invoer.

Parameters

ParameterTipeVereisBeskrywing
titlestringJaTitel van die post
contentstringNeePost-liggaam — aanvaar eenvoudige teks, HTML of geserialiseerde blok-merker
statusstringNeedraft, publish, pending, private. Standaard draft
post_typestringNeePost-tipe slug, bv. post, page, of enige geregistreerde CPT. Standaard post
excerptstringNeeKort opsomming wat in arkiewe en soektogwelde getoon word
categoriesarrayNeeArray van kategorie-name of -ID's om te koppel
tagsarrayNeeArray van tag-name of -ID's om te koppel
authorintegerNeeWordPress gebruiker-ID wat as die post-auteur gestel word. Standaard die huidige gebruiker
datestringNeePublikasiedatum in ISO 8601 formaat, bv. 2026-05-01T09:00:00
page_templatestringNeeTemplate- lêer wat aan hierdie post of bladsy toegewys word, bv. page-full-width.php. Alleen betekenisvol wanneer post_type page is of 'n CPT wat bladsy-templete ondersteun.

Voorbeeld

{
"title": "Welkom op ons nuwe webwerf",
"content": "<!-- wp:paragraph --><p>Hallo wêreld!</p><!-- /wp:paragraph -->",
"status": "publish",
"post_type": "page",
"page_template": "page-full-width.php"
}

Teruggee { "success": true, "post_id": 42, "permalink": "https://example.com/welcome/" }


update_post

Vervang 'n bestaande WordPress-post of bladsy.

Parameters

ParameterTipeVereisBeskrywing
post_idintegerJaID van die post wat opgedateer moet word
titlestringNeeNuwe post-titel
contentstringNeeNuwe post-liggaam
statusstringNeeNuwe status: draft, publish, pending, private
excerptstringNeeNuwe opsomming
categoriesarrayNeeVervang die volledige kategorie-lys met hierdie array van name of -ID's
tagsarrayNeeVervang die volledige tag-lys met hierdie array van name of -ID's
page_templatestringNeeNuwe template- lêer wat aan hierdie post of bladsy toegewys word, bv. page-full-width.php. Stuur 'n leë string om die template-toewysing te verwyder en terug te gaan na die tema-standaard.

Voorbeeld — verander template ná skep

{
"post_id": 42,
"page_template": "page-full-width.php"
}

Teruggee { "success": true, "post_id": 42 }


batch_create_posts

Skep verskeie posts in 'n enkele vermoënsaanroep, wat rond-trips tydens webwerfbou of grootskaalse inhoud-import verlaag. Posts word in volgorde geskep; as een misluk, gaan die ander voort en die mislukking word in die resultaat-array gerapporteer.

Parameters

ParameterTipeVereisBeskrywing
postsarrayJaArray van post-objekte, elk aanvaar dieselfde parameters as create_post
stop_on_errorbooleanNeeAs true, stop die verwerking na die eerste mislukking. Standaard false

Voorbeeld

{
"posts": [
{
"title": "Oor ons",
"post_type": "page",
"status": "publish",
"page_template": "page-full-width.php"
},
{
"title": "Dienste",
"post_type": "page",
"status": "publish"
},
{
"title": "Kontak",
"post_type": "page",
"status": "publish"
}
]
}

Teruggee

{
"created": 3,
"failed": 0,
"results": [
{ "success": true, "post_id": 42, "title": "Oor ons" },
{ "success": true, "post_id": 43, "title": "Dienste" },
{ "success": true, "post_id": 44, "title": "Kontak" }
]
}

Koppel 'n hoofbeeld (post-thumbnail) aan 'n bestaande post of bladsy. Aanvaar 'n bestaande Media Library-aanheft-ID of 'n verre beeld-URL; wanneer 'n URL verskaf word, word die beeld outomaties gedownload en ingevoer.

Parameters

ParameterTipeVereisBeskrywing
post_idintegerJaID van die post of bladsy wat opgedateer moet word
attachment_idintegerNeeID van 'n bestaande Media Library-aanheft
urlstringNeeVerre beeld-URL om te importeer en as hoofbeeld te stel
alt_textstringNeeAlt-teks wat aan die aanheft toegepas word indien dit uit 'n URL geïmporteer is

Een van attachment_id of url moet verskaf word.

Teruggee { "success": true, "post_id": 42, "attachment_id": 17 }


create_contact_form

Skep 'n kontak-vorm met die aktiewe vorm-plugin (Contact Form 7, WPForms, Fluent Forms of Gravity Forms, afhangende van watter een geïnstalleer is). Gee 'n kortkode terug wat in enige post of bladsy ingebed kan word.

Parameters

Visuele Oorsiening

Visuele Oorsieningsvermoë laat die agent skermopnames van lewende bladsye maak en dit analiseer, wat selfstandige ontwerp-oorwegings, voor/na vergelykings en visuele regressiekontrole moontlikmaak sonder dat jy enige blaaier-uitbreiding nodig het.

capture_screenshot

Maak 'n skermopname van 'n WordPress-bladsy op 'n spesifieke URL met behulp van 'n server-side headless browser. Die beeld word in die Media Library gestoor en 'n CDN-URL word teruggegee.

Parameters

ParameterTipeVereisBeskrywing
urlstringJaVolledige URL van die bladsy om op te neem, bv. https://example.com/about/
widthintegerNeeWeerboordbreedte in piksels. Standaard 1280
heightintegerNeeWeerboordhoogte in piksels. Standaard 800
full_pagebooleanNeeNeem die volledige scrollbare bladsy in plaas net die weerboord. Standaard false
delay_msintegerNeeMillisekonde om te wag na bladsy-laai voordat jy opneem, nuttig vir animasie-inhoud. Standaard 500
labelstringNeeMensleesbare label wat met die aanhang in die Media Library gestoor word

Teruggegee

{
"success": true,
"attachment_id": 88,
"url": "https://example.com/wp-content/uploads/2026/04/screenshot-about.png",
"width": 1280,
"height": 800
}

compare_screenshots

Neem twee skermopnames en gee 'n visuele verskilpunt (diff score) terug asook 'n verskilbeeld wat die veranderde areas beklemtoon. Nuttig om te bevestig dat 'n ontwerpverandering die verwagte resultaat veroorsaak het of om onbedoelde regressies te ontdek.

Parameters

ParameterTipeVereisBeskrywing
before_urlstringJaURL van die bladsy wat as die "voor"-toestand opgeneem word
after_urlstringJaURL van die bladsy wat as die "na"-toestand opgeneem word. Dit kan dieselfde URL wees as wanneer jy oor tyd vergelyk
widthintegerNeeWeerboordbreedte vir beide opnames. Standaard 1280
thresholdfloatNeePiksels-verskil drempel (0.0–1.0). Piksels binne hierdie toelating word as onveranderd beskou. Standaard 0.1

Teruggegee

{
"success": true,
"diff_score": 0.04,
"changed_pixels": 2340,
"total_pixels": 1024000,
"diff_attachment_id": 91,
"diff_url": "https://example.com/wp-content/uploads/2026/04/diff-about.png"
}

'n diff_score van 0.0 beteken geen sigbare verandering nie; 1.0 beteken elke piksel het verander.


review_page_design

Maak 'n skermopname van 'n bladsy en stuur dit na die taalmodel vir visuele analise. Gee 'n gestruktureerde beoordeling terug wat dekking, tipografie, kleurgebruik en toeganklikheidsbesoeke omskryf.

Parameters

ParameterTipeVereisBeskrywing
urlstringJaVolledige URL van die bladsy om te beoordeel
focusstringNeeKomma-geskei lys van beoordelingsareas om te beklemtoon: layout, typography, colour, accessibility, mobile. Standaard: alle areas
widthintegerNeeWeerboordbreedte. Standaard 1280

Teruggegee

{
"success": true,
"screenshot_url": "https://example.com/wp-content/uploads/2026/04/review-about.png",
"assessment": {
"overall": "Die bladsystruktuur is skoon en leesbaar. Twee toeganklikheidsbesoeke gedetekte.",
"layout": "Goedge ontwerp hiërargie. Hero-afsnit is prominente.",
"typography": "Lichaamteks is 15px — oorweeg om dit na 16px te verhoog vir leesbaarheid.",
"colour": "Kontrasverhouding op die CTA-knoppie (#fff op #4a90e2) is 3.1:1 — onder die WCAG AA-vereiste van 4.5:1.",
"accessibility": ["Lae kontras op CTA-knoppie", "Ontbrekende alt-teks op hero-beeld"],
"suggestions": ["Verduidelik die CTA-knoppie na #1a5cb0 om WCAG AA te voldoen", "Voeg beskrywende alt-teks by die hero-beeld"]
}
}

Installeerbare Vermoëns

Die Installeerbare Vermoëns Register laat jou toe om die agent met bykomende vermoënpakke uit te brei wat as WordPress plugins versprei word. Elke pakket registreer een of meer vermoëns deur die standaard ability API.

list_available_abilities

Gee die katalogus van vermoënpakke wat beskikbaar is vir installasie vanaf die register terug.

Parameters

ParameterTypeRequiredBeskrywing
categorystringNeeFilter volgens kategorie: ecommerce, seo, media, social, developer

Teruggegee

{
"packs": [
{
"slug": "gratis-ai-agent-woocommerce",
"name": "WooCommerce Abilities",
"category": "ecommerce",
"version": "1.0.0",
"abilities": ["create_product", "update_pricing", "manage_inventory"],
"installed": false
}
]
}

install_ability

Laai en aktiveer 'n ability pack van die registry af.

Parameters

ParameterTypeRequiredBeskrywing
slugstringJaAbility pack plugin slug

Teruggegee { "success": true, "slug": "gratis-ai-agent-woocommerce", "abilities_added": 3 }


recommend_plugin

Vra die ability registry na om die beste plugin vir 'n beskryfde gebruikssgeval te vind en, opsioneel, dit te installeer.

Parameters

ParameterTypeRequiredBeskrywing
descriptionstringJaNatuurlike taalbeskrywing van die gewenste funksionaliteit
installbooleanNeeAs dit true is, installeer die aanbeveel plugin onmiddellik. Standaard false

Voorbeeld

{
"description": "Ek het 'n kontakvorm nodig met lêeroplaai ondersteuning en spamproteksie",
"install": false
}

Teruggegee

{
"recommendation": {
"slug": "contact-form-7",
"name": "Contact Form 7",
"reason": "Wysbred gebruik, ondersteun lêeroplaai en integreer met Akismet vir spamfilter.",
"alternatives": ["wpforms-lite", "fluent-forms"]
}
}