Skip to main content

Referenca sposobnosti

Sposobnosti su atomske radnje koje Gratis AI Agent može pozvati na vašoj WordPress instalaciji. Svaka sposobnost je registrirana PHP klasa koja izlaže JSON shemu — agent čita tu shemu tijekom izvođenja kako bi razumio koji su parametri potrebni i što sposobnost vraća.

Ova stranica dokumentira sve sposobnosti koje dolaze s Gratis AI Agent v1.9.0.


Prilagođene vrste objava

Ove sposobnosti upravljaju prilagođenim vrstama objava (CPT-ovima) registriranima putem agenta. Registracije se spremaju u WordPress tablicu opcija kako bi preživjele deaktivaciju i ponovnu aktivaciju dodatka.

register_post_type

Registrira novu prilagođenu vrstu objave.

Parametri

ParametarVrstaObaveznoOpis
slugstringDaKljuč vrste objave (maks. 20 znakova, bez velikih slova, bez razmaka)
singular_labelstringDaČitljiv naziv u jednini, npr. Portfolio Item
plural_labelstringDaČitljiv naziv u množini, npr. Portfolio Items
publicbooleanNeJe li vrsta objave javno dostupna. Zadano true
supportsarrayNeZnačajke koje treba podržati: title, editor, thumbnail, excerpt, comments, revisions, custom-fields. Zadano ["title","editor"]
has_archivebooleanNeJe li omogućena arhivska stranica vrste objave. Zadano false
menu_iconstringNeDashicons klasa ili URL za ikonu administratorskog izbornika. Zadano "dashicons-admin-post"
rewrite_slugstringNeURL slug za vrstu objave. Zadano je slug

Primjer

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

Vraća { "success": true, "slug": "portfolio" }


list_post_types

Vraća sve prilagođene vrste objava koje je registrirao agent.

Parametri — nema

Vraća

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

delete_post_type

Odregistrira prilagođenu vrstu objave koju je agent prethodno registrirao. Postojeće objave te vrste ostaju u bazi podataka, ali više nisu dostupne putem te vrste objave.

Parametri

ParametarVrstaObaveznoOpis
slugstringDaKljuč vrste objave koji treba ukloniti

Vraća { "success": true, "slug": "portfolio" }


Prilagođene taksonomije

Ove sposobnosti upravljaju prilagođenim taksonomijama. Kao i CPT-ovi, registracije taksonomija se spremaju.

register_taxonomy

Registrira novu prilagođenu taksonomiju.

Parametri

ParametarVrstaObaveznoOpis
slugstringDaKljuč taksonomije (maks. 32 znaka)
singular_labelstringDaČitljiv naziv u jednini, npr. Project Category
plural_labelstringDaČitljiv naziv u množini, npr. Project Categories
post_typesarrayDaSlugovi vrsta objava kojima ova taksonomija treba biti pridružena
hierarchicalbooleanNetrue za stil kategorija, false za stil oznaka. Zadano true
publicbooleanNeJesu li pojmovi javno dostupni. Zadano true
rewrite_slugstringNeURL slug za taksonomiju. Zadano je slug

Primjer

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

Vraća { "success": true, "slug": "project-category" }


list_taxonomies

Vraća sve prilagođene taksonomije koje je registrirao agent.

Parametri — nema

Vraća

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

delete_taxonomy

Odregistrira prilagođenu taksonomiju koju je agent prethodno registrirao.

Parametri

ParametarVrstaObaveznoOpis
slugstringDaKljuč taksonomije koji treba ukloniti

Vraća { "success": true, "slug": "project-category" }


Sustav dizajna

Sposobnosti sustava dizajna mijenjaju vizualni prikaz WordPress web-mjesta — od prilagođenog CSS-a do obrazaca blokova i logotipa web-mjesta.

inject_custom_css

Dodaje CSS u <head> web-mjesta putem wp_add_inline_style. CSS se pohranjuje u opciji gratis_ai_agent_custom_css i čisto se uklanja iz reda učitavanja kada se sposobnost resetira.

Parametri

ParametarVrstaObaveznoOpis
cssstringDaValjani CSS za umetanje
labelstringNeČitljiva oznaka za ovaj CSS blok, koristi se u zapisnicima za otklanjanje pogrešaka. Zadano "agent-injected"
replacebooleanNeAko je true, zamjenjuje sav prethodno umetnuti CSS. Zadano false (dodaje se na kraj)

Primjer

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

Vraća { "success": true, "bytes": 96 }


add_block_pattern

Registrira višekratno upotrebljiv obrazac bloka u WordPress biblioteci obrazaca.

Parametri

ParametarVrstaObaveznoOpis
slugstringDaIdentifikator obrasca, npr. gratis/hero-dark
titlestringDaČitljiv naziv obrasca prikazan u uređivaču
contentstringDaSerijalizirane oznake bloka (HTML) za obrazac
categoriesarrayNeSlugovi kategorija obrazaca, npr. ["featured", "hero"]
descriptionstringNeKratak opis prikazan u biraču obrazaca
keywordsarrayNeKljučne riječi za pretraživanje

Vraća { "success": true, "slug": "gratis/hero-dark" }


list_block_patterns

Navodi sve obrasce blokova koje je registrirao agent.

Parametri — nema

Vraća

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

Postavlja logo WordPress web-stranice na zadani ID privitka ili udaljeni URL slike. Kada se navede URL, slika se preuzima i uvozi u Biblioteku medija.

Parametri

ParametarVrstaObaveznoOpis
attachment_idintegerNeID postojećeg privitka u Biblioteci medija
urlstringNeURL udaljene slike za uvoz i postavljanje kao logo

Mora se navesti jedno od attachment_id ili url.

Vraća { "success": true, "attachment_id": 42 }


apply_theme_json_preset

Primjenjuje imenovanu unaprijed postavljenu kombinaciju boja/tipografije na theme.json aktivne teme (ili global-styles). Unaprijed postavljene kombinacije kurirani su paketi koje održava tim Gratis AI Agent.

Parametri

ParametarVrstaObaveznoOpis
presetstringDaNaziv unaprijed postavljene kombinacije, npr. minimal-dark, warm-editorial, corporate-blue
mergebooleanNeAko je true, spoji s postojećim vrijednostima umjesto zamjene. Zadano je false

Dostupne unaprijed postavljene kombinacije

Unaprijed postavljena kombinacijaOpis
minimal-darkGotovo crna pozadina, bijeli tekst, jedna naglašena boja
warm-editorialTopla prljavobijela pozadina, serifni naslovi, zemljane naglašene boje
corporate-blueTamnoplava i bijela paleta s profesionalnom tipografijom
vibrant-startupSvijetli gradijenti, zaobljeni kutovi, moderan sans-serif tip
classic-blogNeutralne sive nijanse, ugodna visina retka, tradicionalni razmak rasporeda

Vraća { "success": true, "preset": "minimal-dark" }


Globalni stilovi

Mogućnosti globalnih stilova čitaju i zapisuju vrijednosti theme.json putem WordPress Global Styles API-ja, utječući na sve blokove i predloške na cijeloj web-stranici.

get_global_styles

Vraća trenutačnu konfiguraciju globalnih stilova.

Parametri

ParametarVrstaObaveznoOpis
pathstringNeJSON pokazivač na određenu vrijednost, npr. /color/palette ili /typography/fontSizes. Vraća cijeli objekt ako je izostavljeno.

Vraća puni objekt globalnih stilova ili vrijednost na path.


set_global_styles

Ažurira jednu ili više vrijednosti u konfiguraciji globalnih stilova.

Parametri

ParametarVrstaObaveznoOpis
pathstringDaJSON pokazivač na vrijednost za postavljanje, npr. /color/palette
valueanyDaNova vrijednost

Primjer — dodaj boju u paletu

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

Vraća { "success": true, "path": "/color/palette" }


reset_global_styles

Resetira sve promjene globalnih stilova koje je primijenio agent, vraćajući zadane vrijednosti teme.

Parametri — nema

Vraća { "success": true }


Mogućnosti navigacijskog izbornika stvaraju i upravljaju WordPress navigacijskim izbornicima i njihovim stavkama.

create_menu

Stvara novi WordPress navigacijski izbornik.

Parametri

ParametarVrstaObaveznoOpis
namestringDaNaziv izbornika, npr. Primary Navigation
locationstringNeLokacija teme kojoj se ovaj izbornik dodjeljuje, npr. primary

Vraća { "success": true, "menu_id": 7 }


update_menu

Preimenuje izbornik ili ga ponovno dodjeljuje lokaciji teme.

Parametri

ParametarVrstaObaveznoOpis
menu_idintegerDaID izbornika za ažuriranje
namestringNeNovi naziv izbornika
locationstringNeLokacija teme za dodjelu ili ponovnu dodjelu

Vraća { "success": true, "menu_id": 7 }


add_menu_item

Dodaje stavku u postojeći navigacijski izbornik.

Parametri

ParametarVrstaObaveznoOpis
menu_idintegerDaID ciljnog izbornika
typestringDaVrsta stavke: custom, post_type ili taxonomy
titlestringNeOznaka za stavku izbornika (obavezno za vrstu custom)
urlstringNeURL za custom stavke
object_idintegerNeID objave ili ID pojma za post_type/taxonomy stavke
parent_idintegerNeID stavke izbornika ispod koje se ova stavka ugnježđuje
positionintegerNePoložaj u izborniku s početkom od nule

Vraća { "success": true, "item_id": 12 }


remove_menu_item

Uklanja stavku iz navigacijskog izbornika.

Parametri

ParametarVrstaObaveznoOpis
item_idintegerDaID stavke izbornika za uklanjanje

Vraća { "success": true, "item_id": 12 }


list_menus

Navodi sve WordPress navigacijske izbornike, uključujući njihove dodijeljene lokacije tema.

Parametri — nema

Vraća

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

Upravljanje opcijama

Mogućnosti opcija čitaju i zapisuju WordPress opcije putem get_option / update_option. Ugrađeni sigurnosni popis blokiranja sprječava slučajnu izmjenu kritičnih postavki.

get_option

Čita WordPress opciju.

Parametri

ParametarVrstaObaveznoOpis
option_namestringDaKljuč opcije, npr. blogname

Vraća { "option_name": "blogname", "value": "My Site" }

Vraća pogrešku ako je option_name na sigurnosnom popisu blokiranja.


set_option

Zapisuje WordPress opciju.

Parametri

ParametarVrstaObaveznoOpis
option_namestringDaKljuč opcije
valueanyDaNova vrijednost (automatski serijalizirana za nizove/objekte)
autoloadstringNe"yes" ili "no". Zadano čuva postojeću postavku autoload

Vraća pogrešku ako je option_name na sigurnosnom popisu blokiranih.

Vraća { "success": true, "option_name": "blogname" }


delete_option

Briše WordPress opciju.

Parametri

ParametarTipObaveznoOpis
option_namestringDaKljuč opcije za brisanje

Vraća pogrešku ako je option_name na sigurnosnom popisu blokiranih.

Vraća { "success": true, "option_name": "my_custom_option" }


list_options

Ispisuje WordPress opcije koje odgovaraju uzorku.

Parametri

ParametarTipObaveznoOpis
patternstringNeSQL LIKE uzorak za filtriranje naziva opcija, npr. gratis_%. Vraća sve opcije ako je izostavljeno (koristite oprezno na velikim bazama podataka).
limitintegerNeMaksimalan broj rezultata. Zadano 50, najviše 500

Vraća

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

Upravljanje sadržajem

Mogućnosti upravljanja sadržajem stvaraju i uređuju WordPress objave i stranice. ID-jevi objava se vraćaju kako bi se sljedeći koraci u planovima s više mogućnosti mogli referencirati na stvoreni sadržaj.

create_post

Stvara novu WordPress objavu, stranicu ili unos prilagođene vrste objave.

Parametri

ParametarTipObaveznoOpis
titlestringDaNaslov objave
contentstringNeTijelo objave — prihvaća običan tekst, HTML ili serijaliziranu oznaku blokova
statusstringNedraft, publish, pending, private. Zadano draft
post_typestringNeSlug vrste objave, npr. post, page ili bilo koji registrirani CPT. Zadano post
excerptstringNeKratki sažetak prikazan u arhivama i rezultatima pretraživanja
categoriesarrayNeNiz naziva ili ID-jeva kategorija za dodjelu
tagsarrayNeNiz naziva ili ID-jeva oznaka za dodjelu
authorintegerNeWordPress ID korisnika koji će se postaviti kao autor objave. Zadano je trenutačni korisnik
datestringNeDatum objave u ISO 8601 formatu, npr. 2026-05-01T09:00:00
page_templatestringNeDatoteka predloška za dodjelu ovoj objavi ili stranici, npr. page-full-width.php. Ima značenje samo kada je post_type page ili CPT koji podržava predloške stranica.

Primjer

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

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


update_post

Ažurira postojeću WordPress objavu ili stranicu.

Parametri

ParametarTipObaveznoOpis
post_idintegerDaID objave za ažuriranje
titlestringNeNovi naslov objave
contentstringNeNovo tijelo objave
statusstringNeNovi status: draft, publish, pending, private
excerptstringNeNovi izvadak
categoriesarrayNeZamijenite puni popis kategorija ovim nizom naziva ili ID-jeva
tagsarrayNeZamijenite puni popis oznaka ovim nizom naziva ili ID-jeva
page_templatestringNeNova datoteka predloška za dodjelu ovoj objavi ili stranici, npr. page-full-width.php. Proslijedite prazan string za uklanjanje dodjele predloška i povratak na zadani predložak teme.

Primjer — promjena predloška nakon stvaranja

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

Vraća { "success": true, "post_id": 42 }


batch_create_posts

Stvara više objava u jednom pozivu mogućnosti, smanjujući broj kružnih putovanja tijekom izrade web-mjesta ili masovnog uvoza sadržaja. Objave se stvaraju redom; ako jedna ne uspije, ostale se nastavljaju, a neuspjeh se prijavljuje u nizu rezultata.

Parametri

ParametarTipObaveznoOpis
postsarrayDaNiz objekata objava, pri čemu svaki prihvaća iste parametre kao create_post
stop_on_errorbooleanNeAko je true, zaustavite obradu nakon prvog neuspjeha. Zadano false

Primjer

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

Vraća

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

Dodjeljuje istaknutu sliku (sličicu objave) postojećoj objavi ili stranici. Prihvaća ID postojećeg privitka iz Media Library ili URL udaljene slike; kada se navede URL, slika se automatski preuzima i uvozi.

Parametri

ParametarTipObaveznoOpis
post_idintegerDaID objave ili stranice za ažuriranje
attachment_idintegerNeID postojećeg privitka iz Media Library
urlstringNeURL udaljene slike za uvoz i postavljanje kao istaknute slike
alt_textstringNeAlternativni tekst za primjenu na privitak ako je uvezen s URL-a

Mora se navesti jedno od attachment_id ili url.

Vraća { "success": true, "post_id": 42, "attachment_id": 17 }


create_contact_form

Stvara kontaktni obrazac pomoću aktivnog plugina za obrasce (Contact Form 7, WPForms, Fluent Forms ili Gravity Forms, ovisno o tome koji je instaliran). Vraća shortcode koji se može ugraditi u bilo koju objavu ili stranicu.

Parametri

ParametarTipObaveznoOpis
titlestringDaNaziv obrasca prikazan u administratorskom sučelju plugina za obrasce
fieldsarrayDaUređeni popis polja obrasca (pogledajte objekt polja u nastavku)
recipientstringNeAdresa e-pošte za primanje podnesaka. Zadano je WordPress administratorska adresa e-pošte
subjectstringNeRedak predmeta e-pošte. Podržava [your-name] i [your-subject] rezervirana mjesta pri upotrebi Contact Form 7
confirmation_messagestringNePoruka prikazana nakon uspješnog slanja. Zadano: "Thank you for your message. We'll be in touch soon."

Objekt polja

KljučTipObaveznoOpis
namestringDaInterni naziv polja / strojni ključ
labelstringDaČitljiva oznaka prikazana na obrascu
typestringDatext, email, tel, textarea, select, checkbox, radio, file, date
requiredbooleanNeMora li se polje ispuniti prije slanja. Zadano false
optionsarrayNeOpcije za polja select, checkbox i radio
placeholderstringNeTekst rezerviranog mjesta za unose tekstualnog tipa

Primjer

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

Vraća

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

Vizualni pregled

Mogućnosti vizualnog pregleda omogućuju agentu snimanje snimki zaslona stranica uživo i njihovu analizu, omogućujući autonomni pregled dizajna, usporedbe prije/poslije i provjere vizualne regresije bez potrebe za ikakvim proširenjem preglednika.

capture_screenshot

Snima snimku zaslona WordPress stranice na zadanom URL-u pomoću poslužiteljskog preglednika bez grafičkog sučelja. Slika se sprema u medijsku biblioteku i vraća se CDN URL.

Parametri

ParametarTipObaveznoOpis
urlstringDaPuni URL stranice za snimku zaslona, npr. https://example.com/about/
widthintegerNeŠirina viewporta u pikselima. Zadano 1280
heightintegerNeVisina viewporta u pikselima. Zadano 800
full_pagebooleanNeSnimi cijelu stranicu koja se može pomicati umjesto samo viewporta. Zadano false
delay_msintegerNeMilisekunde čekanja nakon učitavanja stranice prije snimanja, korisno za animirani sadržaj. Zadano 500
labelstringNeČitljiva oznaka pohranjena s privitkom u medijskoj biblioteci

Vraća

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

compare_screenshots

Uzima dvije snimke zaslona i vraća rezultat vizualne razlike te sliku razlike koja ističe promijenjena područja. Korisno za potvrdu da je promjena dizajna proizvela očekivani rezultat ili za otkrivanje neželjenih regresija.

Parametri

ParametarTipObaveznoOpis
before_urlstringDaURL stranice za snimanje kao stanje "prije"
after_urlstringDaURL stranice za snimanje kao stanje "poslije". Može biti isti URL ako se uspoređuje kroz vrijeme
widthintegerNeŠirina viewporta za obje snimke. Zadano 1280
thresholdfloatNePrag razlike piksela (0.0–1.0). Pikseli unutar ove tolerancije smatraju se nepromijenjenima. Zadano 0.1

Vraća

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

diff_score od 0.0 znači da nema vidljive promjene; 1.0 znači da se svaki piksel promijenio.


review_page_design

Snima snimku zaslona stranice i šalje je jezičnom modelu na vizualnu analizu. Vraća strukturiranu procjenu koja obuhvaća raspored, tipografiju, upotrebu boja i pitanja pristupačnosti.

Parametri

ParametarTipObaveznoOpis
urlstringDaPuni URL stranice za pregled
focusstringNePopis područja pregleda odvojenih zarezima koja treba naglasiti: layout, typography, colour, accessibility, mobile. Zadano: sva područja
widthintegerNeŠirina viewporta. Zadano 1280

Vraća

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

Instalabilne mogućnosti

Registar instalabilnih mogućnosti omogućuje proširenje agenta dodatnim paketima mogućnosti distribuiranima kao WordPress plugini. Svaki paket registrira jednu ili više mogućnosti pomoću standardnog API-ja za mogućnosti.

list_available_abilities

Vraća katalog paketa mogućnosti dostupnih za instalaciju iz registra.

Parametri

ParametarTipObaveznoOpis
categorystringNeFiltriraj po kategoriji: ecommerce, seo, media, social, developer

Vraća

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

Preuzima i aktivira paket sposobnosti iz registra.

Parametri

ParametarTipObaveznoOpis
slugstringDaSlug plugina paketa sposobnosti

Vraća { "success": true, "slug": "gratis-ai-agent-woocommerce", "abilities_added": 3 }


recommend_plugin

Šalje upit registru sposobnosti kako bi pronašao najbolji plugin za opisani slučaj upotrebe i, po želji, instalira ga.

Parametri

ParametarTipObaveznoOpis
descriptionstringDaOpis željene funkcionalnosti prirodnim jezikom
installbooleanNeAko je true, odmah instalira preporučeni plugin. Zadano false

Primjer

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

Vraća

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