Skip to main content

Referans Kapasite yo

Kapasite yo se aksyon atomik Gratis AI Agent ka envoke sou enstalasyon WordPress ou a. Chak kapasite se yon klas PHP ki anrejistre epi ki ekspoze yon chema JSON — ajan an li chema sa a pandan ekzekisyon pou konprann ki paramèt ki obligatwa ak sa kapasite a retounen.

Paj sa a dokimante tout kapasite ki vini ak Gratis AI Agent v1.9.0.


Kalite Pòs Pèsonalize

Kapasite sa yo jere kalite pòs pèsonalize (CPTs) ki anrejistre atravè ajan an. Anrejistreman yo konsève nan tablo opsyon WordPress la pou yo kontinye egziste apre dezaktivasyon ak reyaktivasyon plugin lan.

register_post_type

Anrejistre yon nouvo kalite pòs pèsonalize.

Paramèt

ParameterTypeRequiredDescription
slugstringYesKle kalite pòs la (maksimòm 20 karaktè, pa gen majiskil, pa gen espas)
singular_labelstringYesNon sengilye moun ka li, pa egzanp Portfolio Item
plural_labelstringYesNon pliryèl moun ka li, pa egzanp Portfolio Items
publicbooleanNoSi kalite pòs la aksesib piblikman. Default true
supportsarrayNoFonksyonalite pou sipòte: title, editor, thumbnail, excerpt, comments, revisions, custom-fields. Default ["title","editor"]
has_archivebooleanNoSi yon paj achiv pou kalite pòs la aktive. Default false
menu_iconstringNoKlas Dashicons oswa URL pou ikòn meni admin nan. Default "dashicons-admin-post"
rewrite_slugstringNoURL slug pou kalite pòs la. Pa default li pran slug

Egzanp

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

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


list_post_types

Retounen tout kalite pòs pèsonalize ajan an anrejistre.

Paramèt — okenn

Retounen

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

delete_post_type

Dezanrejistre yon kalite pòs pèsonalize ajan an te anrejistre anvan. Pòs ki deja egziste nan kalite sa a rete nan baz done a men yo pa aksesib ankò atravè kalite pòs la.

Paramèt

ParameterTypeRequiredDescription
slugstringYesKle kalite pòs la pou retire

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


Taksonomi Pèsonalize

Kapasite sa yo jere taksonomi pèsonalize. Menm jan ak CPTs, anrejistreman taksonomi yo konsève.

register_taxonomy

Anrejistre yon nouvo taksonomi pèsonalize.

Paramèt

ParameterTypeRequiredDescription
slugstringYesKle taksonomi a (maksimòm 32 karaktè)
singular_labelstringYesNon sengilye moun ka li, pa egzanp Project Category
plural_labelstringYesNon pliryèl moun ka li, pa egzanp Project Categories
post_typesarrayYesSlug kalite pòs taksonomi sa a dwe atache ak yo
hierarchicalbooleanNotrue pou estil kategori, false pou estil tag. Default true
publicbooleanNoSi tèm yo aksesib piblikman. Default true
rewrite_slugstringNoURL slug pou taksonomi a. Pa default li pran slug

Egzanp

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

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


list_taxonomies

Retounen tout taksonomi pèsonalize ajan an anrejistre.

Paramèt — okenn

Retounen

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

delete_taxonomy

Dezanrejistre yon taksonomi pèsonalize ajan an te anrejistre anvan.

Paramèt

ParameterTypeRequiredDescription
slugstringYesKle taksonomi a pou retire

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


Sistèm Konsepsyon

Kapasite sistèm konsepsyon yo modifye prezantasyon vizyèl sit WordPress la — soti nan CSS pèsonalize rive nan modèl blòk ak logo sit la.

inject_custom_css

Ajoute CSS nan <head> sit la atravè wp_add_inline_style. CSS la estoke nan opsyon gratis_ai_agent_custom_css epi yo retire li pwòpman nan keu lè kapasite a reset.

Paramèt

ParameterTypeRequiredDescription
cssstringYesCSS valid pou enjekte
labelstringNoEtikèt moun ka li pou blòk CSS sa a, yo itilize nan jounal debogaj. Default "agent-injected"
replacebooleanNoSi true, ranplase tout CSS ki te deja enjekte. Default false (ajoute nan fen)

Egzanp

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

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


add_block_pattern

Anrejistre yon modèl blòk ki ka reyitilize nan bibliyotèk modèl WordPress la.

Paramèt

ParameterTypeRequiredDescription
slugstringYesIdantifyan modèl, pa egzanp gratis/hero-dark
titlestringYesNon modèl moun ka li ki parèt nan editè a
contentstringYesMakè blòk serialize (HTML) pou modèl la
categoriesarrayNoSlug kategori modèl, pa egzanp ["featured", "hero"]
descriptionstringNoDeskripsyon kout ki parèt nan selektè modèl la
keywordsarrayNoMo kle rechèch

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


list_block_patterns

Fè lis tout modèl blòk ajan an anrejistre.

Paramèt — okenn

Retounen

{
"patterns": [
{
"slug": "gratis/hero-dark",
"title": "Dark Hero",
"categories": ["hero"]
}
]
}

Mete logo sit WordPress la sou yon ID atachman yo bay oswa yon URL imaj aleka. Lè yo bay yon URL, yo telechaje imaj la epi yo enpòte li nan Bibliyotèk Medya a.

Paramèt

ParamètTipObligatwaDeskripsyon
attachment_idintegerNonID yon atachman Bibliyotèk Medya ki deja egziste
urlstringNonURL imaj aleka pou enpòte epi mete kòm logo a

Youn nan attachment_id oswa url dwe bay.

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


apply_theme_json_preset

Aplike yon preset koulè/tipografi ki gen non sou theme.json tèm aktif la (oswa global-styles). Preset yo se pake byen chwazi ekip Gratis AI Agent la kenbe.

Paramèt

ParamètTipObligatwaDeskripsyon
presetstringWiNon preset, pa egzanp minimal-dark, warm-editorial, corporate-blue
mergebooleanNonSi true, fizyone ak valè ki deja egziste olye pou ranplase yo. Defo false

Preset ki disponib

PresetDeskripsyon
minimal-darkFon prèske nwa, tèks blan, yon sèl koulè aksan
warm-editorialFon blan kase cho, tit serif, koulè aksan tè
corporate-bluePalèt ble maren ak blan ak tipografi pwofesyonèl
vibrant-startupGradyan klere, kwen awondi, tip sans-serif modèn
classic-blogGri net, wotè liy konfòtab, espasman layout tradisyonèl

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


Estil Global

Kapasite Estil Global yo li epi ekri valè theme.json atravè WordPress Global Styles API a, sa ki afekte tout blòk ak modèl sou tout sit la.

get_global_styles

Retounen konfigirasyon estil global aktyèl la.

Paramèt

ParamètTipObligatwaDeskripsyon
pathstringNonPwentè JSON pou yon valè espesifik, pa egzanp /color/palette oswa /typography/fontSizes. Retounen tout objè a si li omèt.

Retounen objè estil global konplè a oswa valè ki nan path.


set_global_styles

Mete ajou youn oswa plis valè nan konfigirasyon estil global la.

Paramèt

ParamètTipObligatwaDeskripsyon
pathstringWiPwentè JSON pou valè pou mete a, pa egzanp /color/palette
valueanyWiNouvo valè a

Egzanp — ajoute yon koulè nan palèt la

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

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


reset_global_styles

Reyinisyalize tout chanjman estil global ajan an te aplike yo, epi retabli defo tèm nan.

Paramèt — okenn

Retounen { "success": true }


Kapasite Meni Navigasyon yo kreye epi jere meni navigasyon WordPress ak atik yo.

create_menu

Kreye yon nouvo meni navigasyon WordPress.

Paramèt

ParamètTipObligatwaDeskripsyon
namestringWiNon meni, pa egzanp Primary Navigation
locationstringNonKote tèm nan pou asiyen meni sa a, pa egzanp primary

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


update_menu

Chanje non yon meni oswa reasiyen li nan yon kote tèm.

Paramèt

ParamètTipObligatwaDeskripsyon
menu_idintegerWiID meni pou mete ajou a
namestringNonNouvo non meni
locationstringNonKote tèm nan pou asiyen oswa reasiyen

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


add_menu_item

Ajoute yon atik nan yon meni navigasyon ki deja egziste.

Paramèt

ParamètTipObligatwaDeskripsyon
menu_idintegerWiID meni sib la
typestringWiTip atik: custom, post_type, oswa taxonomy
titlestringNonEtikèt pou atik meni an (obligatwa pou tip custom)
urlstringNonURL pou atik custom yo
object_idintegerNonID pòs oswa ID tèm pou atik post_type/taxonomy yo
parent_idintegerNonID atik meni pou mete atik sa a anba li
positionintegerNonPozisyon ki baze sou zewo nan meni an

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


remove_menu_item

Retire yon atik nan yon meni navigasyon.

Paramèt

ParamètTipObligatwaDeskripsyon
item_idintegerWiID atik meni pou retire

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


list_menus

Lis tout meni navigasyon WordPress, ansanm ak kote tèm yo asiyen yo.

Paramèt — okenn

Retounen

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

Jesyon Opsyon

Kapasite opsyon yo li epi ekri opsyon WordPress atravè get_option / update_option. Yon blocklist sekirite entegre anpeche modifikasyon aksidantèl paramèt kritik yo.

get_option

Li yon opsyon WordPress.

Paramèt

ParamètTipObligatwaDeskripsyon
option_namestringWiKle opsyon an, pa egzanp blogname

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

Retounen yon erè si option_name sou blocklist sekirite a.


set_option

Ekri yon opsyon WordPress.

Paramèt

ParamètTipObligatwaDeskripsyon
option_namestringWiKle opsyon an
valueanyWiNouvo valè a (serialize otomatikman pou array/objè)
autoloadstringNon"yes" oswa "no". Defo a konsève paramèt autoload ki deja egziste a

Retounen yon erè si option_name sou lis blòk sekirite a.

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


delete_option

Efase yon opsyon WordPress.

Paramèt

ParamètKaliteObligatwaDeskripsyon
option_namestringWiKle opsyon pou efase a

Retounen yon erè si option_name sou lis blòk sekirite a.

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


list_options

Lis opsyon WordPress ki matche ak yon modèl.

Paramèt

ParamètKaliteObligatwaDeskripsyon
patternstringNonModèl SQL LIKE pou filtre non opsyon yo, pa egzanp gratis_%. Retounen tout opsyon si li pa mete (itilize ak prekosyon sou gwo bazdone).
limitintegerNonKantite maksimòm rezilta. Defo 50, maksimòm 500

Retounen

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

Jesyon Kontni

Kapasite Jesyon Kontni yo kreye epi modifye pòs ak paj WordPress. Yo retounen ID pòs yo pou etap ki vin apre nan plan milti-kapasite yo ka refere ak kontni ki te kreye a.

create_post

Kreye yon nouvo pòs WordPress, paj, oswa antre kalite pòs pèsonalize.

Paramèt

ParamètKaliteObligatwaDeskripsyon
titlestringWiTit pòs
contentstringNonKò pòs la — aksepte tèks senp, HTML, oswa markup blòk ki serialised
statusstringNondraft, publish, pending, private. Defo draft
post_typestringNonSlug kalite pòs, pa egzanp post, page, oswa nenpòt CPT ki anrejistre. Defo post
excerptstringNonRezime kout ki parèt nan achiv ak rezilta rechèch
categoriesarrayNonArray non kategori oswa ID pou asiyen
tagsarrayNonArray non tag oswa ID pou asiyen
authorintegerNonID itilizatè WordPress pou mete kòm otè pòs la. Defo se itilizatè aktyèl la
datestringNonDat piblikasyon nan fòma ISO 8601, pa egzanp 2026-05-01T09:00:00
page_templatestringNonFichye modèl pou asiyen ak pòs oswa paj sa a, pa egzanp page-full-width.php. Sa gen sans sèlman lè post_type se page oswa yon CPT ki sipòte modèl paj.

Egzanp

{
"title": "Welcome to Our New Site",
"content": "<!-- wp:paragraph --><p>Hello world!</p><!-- /wp:paragraph -->",
"status": "publish",
"post_type": "page",
"page_template": "page-full-width.php"
}

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


update_post

Mete ajou yon pòs oswa paj WordPress ki deja egziste.

Paramèt

ParamètKaliteObligatwaDeskripsyon
post_idintegerWiID pòs pou mete ajou a
titlestringNonNouvo tit pòs
contentstringNonNouvo kò pòs
statusstringNonNouvo estati: draft, publish, pending, private
excerptstringNonNouvo ekstrè
categoriesarrayNonRanplase lis kategori konplè a ak array non oswa ID sa a
tagsarrayNonRanplase lis tag konplè a ak array non oswa ID sa a
page_templatestringNonNouvo fichye modèl pou asiyen ak pòs oswa paj sa a, pa egzanp page-full-width.php. Pase yon chèn vid pou retire asiyasyon modèl la epi retounen sou defo theme nan.

Egzanp — chanje modèl apre kreyasyon

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

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


batch_create_posts

Kreye plizyè pòs nan yon sèl apèl kapasite, sa ki diminye ale-vini pandan konstriksyon sit oswa enpòtasyon kontni an gwo. Pòs yo kreye youn apre lòt; si youn echwe, lòt yo kontinye epi echèk la rapòte nan array rezilta a.

Paramèt

ParamètKaliteObligatwaDeskripsyon
postsarrayWiArray objè pòs, chak aksepte menm paramèt ak create_post
stop_on_errorbooleanNonSi true, sispann tretman apre premye echèk la. Defo false

Egzanp

{
"posts": [
{
"title": "About Us",
"post_type": "page",
"status": "publish",
"page_template": "page-full-width.php"
},
{
"title": "Services",
"post_type": "page",
"status": "publish"
},
{
"title": "Contact",
"post_type": "page",
"status": "publish"
}
]
}

Retounen

{
"created": 3,
"failed": 0,
"results": [
{ "success": true, "post_id": 42, "title": "About Us" },
{ "success": true, "post_id": 43, "title": "Services" },
{ "success": true, "post_id": 44, "title": "Contact" }
]
}

set_featured_image

Asiyen yon imaj vedèt (miniati pòs) ak yon pòs oswa paj ki deja egziste. Aksepte yon ID atachman Media Library ki deja egziste oswa yon URL imaj aleka; lè yo bay yon URL, imaj la telechaje epi enpòte otomatikman.

Paramèt

ParamètKaliteObligatwaDeskripsyon
post_idintegerWiID pòs oswa paj pou mete ajou a
attachment_idintegerNonID yon atachman Media Library ki deja egziste
urlstringNonURL imaj aleka pou enpòte epi mete kòm imaj vedèt la
alt_textstringNonTèks alt pou aplike sou atachman an si li enpòte soti nan yon URL

Youn nan attachment_id oswa url dwe bay.

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


create_contact_form

Kreye yon fòm kontak lè l sèvi ak plugin fòm aktif la (Contact Form 7, WPForms, Fluent Forms, oswa Gravity Forms, selon sa ki enstale). Retounen yon shortcode ki ka entegre nan nenpòt pòs oswa paj.

Paramèt

ParamètTipObligatwaDeskripsyon
titlestringWiNon fòm ki parèt nan admin plugin fòm nan
fieldsarrayWiLis òdone chan fòm yo (gade objè Chan ki anba a)
recipientstringNonAdrès imèl pou resevwa soumisyon yo. Pa defo, se imèl admin WordPress la
subjectstringNonLiy sijè imèl la. Sipòte ranplasman [your-name] ak [your-subject] lè w ap itilize Contact Form 7
confirmation_messagestringNonMesaj ki parèt apre yon soumisyon reyisi. Pa defo: "Thank you for your message. We'll be in touch soon."

Objè chan

KleTipObligatwaDeskripsyon
namestringWiNon chan entèn / kle machin
labelstringWiEtikèt moun ka li ki parèt sou fòm nan
typestringWitext, email, tel, textarea, select, checkbox, radio, file, date
requiredbooleanNonSi chan an dwe ranpli anvan soumisyon. Pa defo false
optionsarrayNonOpsyon pou chan select, checkbox, ak radio
placeholderstringNonTèks placeholder pou antre tip tèks yo

Egzanp

{
"title": "Restaurant Booking Enquiry",
"fields": [
{ "name": "your-name", "label": "Name", "type": "text", "required": true },
{ "name": "your-email", "label": "Email", "type": "email", "required": true },
{ "name": "party-size", "label": "Party size", "type": "select", "options": ["1–2", "3–5", "6–10", "10+"] },
{ "name": "your-message", "label": "Special requests", "type": "textarea", "required": false }
],
"recipient": "[email protected]",
"subject": "New booking enquiry from [your-name]"
}

Retounen

{
"success": true,
"form_id": 3,
"shortcode": "[contact-form-7 id=\"3\" title=\"Restaurant Booking Enquiry\"]"
}

Revizyon Vizyèl

Kapasite Revizyon Vizyèl yo pèmèt agent lan pran ekran paj an dirèk epi analize yo, sa ki rann posib revizyon konsepsyon otonòm, konparezon anvan/apre, ak verifikasyon regresyon vizyèl san mande okenn ekstansyon navigatè.

capture_screenshot

Pran yon ekran yon paj WordPress nan yon URL yo bay avèk yon navigatè headless bò sèvè. Imaj la sove nan Media Library epi yo retounen yon URL CDN.

Paramèt

ParamètTipObligatwaDeskripsyon
urlstringWiURL konplè paj pou pran ekran an, pa egzanp https://example.com/about/
widthintegerNonLajè viewport an piksèl. Pa defo 1280
heightintegerNonWotè viewport an piksèl. Pa defo 800
full_pagebooleanNonPran tout paj ki ka defile a olye de sèlman viewport la. Pa defo false
delay_msintegerNonMilisgond pou tann apre paj la fin chaje anvan kaptire, itil pou kontni anime. Pa defo 500
labelstringNonEtikèt moun ka li ki estoke ak atachman an nan Media Library

Retounen

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

compare_screenshots

Pran de ekran epi retounen yon nòt diferans vizyèl ansanm ak yon imaj diferans ki mete aksan sou zòn ki chanje yo. Itil pou konfime yon chanjman konsepsyon bay rezilta yo te espere a oswa pou detekte regresyon ki pa t entansyonèl.

Paramèt

ParamètTipObligatwaDeskripsyon
before_urlstringWiURL paj pou kaptire kòm eta "anvan" an
after_urlstringWiURL paj pou kaptire kòm eta "apre" a. Li ka menm URL la si w ap konpare atravè tan
widthintegerNonLajè viewport pou toude kaptir yo. Pa defo 1280
thresholdfloatNonPapòt diferans piksèl (0.0–1.0). Piksèl ki nan tolerans sa a konsidere kòm pa chanje. Pa defo 0.1

Retounen

{
"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"
}

Yon diff_score ki se 0.0 vle di pa gen okenn chanjman vizib; 1.0 vle di chak piksèl chanje.


review_page_design

Pran yon ekran yon paj epi voye li bay modèl lang lan pou analiz vizyèl. Retounen yon evalyasyon estriktire ki kouvri aranjman, tipografi, itilizasyon koulè, ak enkyetid aksesibilite.

Paramèt

ParamètTipObligatwaDeskripsyon
urlstringWiURL konplè paj pou revize a
focusstringNonLis zòn revizyon separe ak vigil pou mete aksan sou yo: layout, typography, colour, accessibility, mobile. Pa defo: tout zòn
widthintegerNonLajè viewport. Pa defo 1280

Retounen

{
"success": true,
"screenshot_url": "https://example.com/wp-content/uploads/2026/04/review-about.png",
"assessment": {
"overall": "The page structure is clean and readable. Two accessibility issues detected.",
"layout": "Good visual hierarchy. Hero section is prominent.",
"typography": "Body text is 15px — consider increasing to 16px for readability.",
"colour": "Contrast ratio on the CTA button (#fff on #4a90e2) is 3.1:1 — below the WCAG AA threshold of 4.5:1.",
"accessibility": ["Low contrast on CTA button", "Missing alt text on hero image"],
"suggestions": ["Darken the CTA button to #1a5cb0 to pass WCAG AA", "Add descriptive alt text to the hero image"]
}
}

Kapasite ki ka Enstale

Rejis Kapasite ki ka Enstale a pèmèt ou elaji agent lan ak pake kapasite adisyonèl ki distribye kòm plugin WordPress. Chak pake anrejistre youn oswa plizyè kapasite lè l sèvi ak API kapasite estanda a.

list_available_abilities

Retounen katalòg pake kapasite ki disponib pou enstalasyon nan rejis la.

Paramèt

ParamètTipObligatwaDeskripsyon
categorystringNonFiltre pa kategori: ecommerce, seo, media, social, developer

Retounen

{
"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

Telechaje epi aktive yon pake kapasite depi rejis la.

Paramèt

ParamètTipObligatwaDeskripsyon
slugstringWiSlug plugin pake kapasite a

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


recommend_plugin

Fè rechèch nan rejis kapasite a pou jwenn pi bon plugin pou yon ka itilizasyon ki dekri epi, si ou vle, enstale li.

Paramèt

ParamètTipObligatwaDeskripsyon
descriptionstringWiDeskripsyon an lang natirèl sou fonksyonalite ou vle a
installbooleanNonSi true, enstale plugin yo rekòmande a touswit. Defo false

Egzanp

{
"description": "I need a contact form with file upload support and spam protection",
"install": false
}

Retounen

{
"recommendation": {
"slug": "contact-form-7",
"name": "Contact Form 7",
"reason": "Widely adopted, supports file uploads, and integrates with Akismet for spam filtering.",
"alternatives": ["wpforms-lite", "fluent-forms"]
}
}