Skip to main content

Referanse for evner

Evner er de atomiske handlingene som Gratis AI Agent kan påkalle i WordPress-installasjonen din. Hver evne er en registrert PHP-klasse som eksponerer et JSON-skjema — agenten leser dette skjemaet ved kjøring for å forstå hvilke parametere som kreves og hva evnen returnerer.

Denne siden dokumenterer alle evner som leveres med Gratis AI Agent v1.9.0.


Egendefinerte innleggstyper

Disse evnene administrerer egendefinerte innleggstyper (CPT-er) registrert gjennom agenten. Registreringer lagres i WordPress-alternativtabellen slik at de overlever deaktivering og reaktivering av pluginen.

register_post_type

Registrerer en ny egendefinert innleggstype.

Parametere

ParameterTypeRequiredDescription
slugstringYesNøkkelen for innleggstypen (maks 20 tegn, ingen store bokstaver, ingen mellomrom)
singular_labelstringYesLesbart entallsnavn, f.eks. Portfolio Item
plural_labelstringYesLesbart flertallsnavn, f.eks. Portfolio Items
publicbooleanNoOm innleggstypen er offentlig tilgjengelig. Standard true
supportsarrayNoFunksjoner som skal støttes: title, editor, thumbnail, excerpt, comments, revisions, custom-fields. Standard ["title","editor"]
has_archivebooleanNoOm en arkivside for innleggstypen er aktivert. Standard false
menu_iconstringNoDashicons-klasse eller URL for admin-menyikonet. Standard "dashicons-admin-post"
rewrite_slugstringNoURL-slug for innleggstypen. Bruker som standard slug

Eksempel

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

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


list_post_types

Returnerer alle egendefinerte innleggstyper registrert av agenten.

Parametere — ingen

Returnerer

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

delete_post_type

Avregistrerer en egendefinert innleggstype som tidligere er registrert av agenten. Eksisterende innlegg av den typen blir liggende i databasen, men er ikke lenger tilgjengelige via innleggstypen.

Parametere

ParameterTypeRequiredDescription
slugstringYesNøkkelen for innleggstypen som skal fjernes

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


Egendefinerte taksonomier

Disse evnene administrerer egendefinerte taksonomier. I likhet med CPT-er lagres taksonomiregistreringer.

register_taxonomy

Registrerer en ny egendefinert taksonomi.

Parametere

ParameterTypeRequiredDescription
slugstringYesTaksonominøkkelen (maks 32 tegn)
singular_labelstringYesLesbart entallsnavn, f.eks. Project Category
plural_labelstringYesLesbart flertallsnavn, f.eks. Project Categories
post_typesarrayYesSlugs for innleggstyper denne taksonomien skal knyttes til
hierarchicalbooleanNotrue for kategoristil, false for taggstil. Standard true
publicbooleanNoOm termer er offentlig tilgjengelige. Standard true
rewrite_slugstringNoURL-slug for taksonomien. Bruker som standard slug

Eksempel

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

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


list_taxonomies

Returnerer alle egendefinerte taksonomier registrert av agenten.

Parametere — ingen

Returnerer

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

delete_taxonomy

Avregistrerer en egendefinert taksonomi som tidligere er registrert av agenten.

Parametere

ParameterTypeRequiredDescription
slugstringYesTaksonominøkkelen som skal fjernes

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


Designsystem

Designsystem-evner endrer den visuelle presentasjonen av WordPress-nettstedet — fra egendefinert CSS til blokkmønstre og nettstedets logo.

inject_custom_css

Legger til CSS i nettstedets <head> via wp_add_inline_style. CSS lagres i alternativet gratis_ai_agent_custom_css og fjernes fra køen på en ryddig måte når evnen tilbakestilles.

Parametere

ParameterTypeRequiredDescription
cssstringYesGyldig CSS som skal injiseres
labelstringNoLesbar etikett for denne CSS-blokken, brukt i feilsøkingslogger. Standard "agent-injected"
replacebooleanNoHvis true, erstatter all tidligere injisert CSS. Standard false (legger til)

Eksempel

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

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


add_block_pattern

Registrerer et gjenbrukbart blokkmønster i WordPress-mønsterbiblioteket.

Parametere

ParameterTypeRequiredDescription
slugstringYesMønsteridentifikator, f.eks. gratis/hero-dark
titlestringYesLesbart mønsternavn vist i redigeringsprogrammet
contentstringYesSerialisert blokkmarkering (HTML) for mønsteret
categoriesarrayNoSlugs for mønsterkategorier, f.eks. ["featured", "hero"]
descriptionstringNoKort beskrivelse vist i mønstervelgeren
keywordsarrayNoSøkenøkkelord

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


list_block_patterns

Lister alle blokkmønstre registrert av agenten.

Parametere — ingen

Returnerer

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

Setter WordPress nettstedlogo til en gitt vedleggs-ID eller en ekstern bilde-URL. Når en URL oppgis, lastes bildet ned og importeres til mediebiblioteket.

Parametere

ParameterTypeRequiredDescription
attachment_idintegerNoID for et eksisterende vedlegg i mediebiblioteket
urlstringNoEkstern bilde-URL som skal importeres og settes som logo

Én av attachment_id eller url må oppgis.

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


apply_theme_json_preset

Bruker en navngitt farge-/typografiforhåndsinnstilling på det aktive temaets theme.json (eller global-styles). Forhåndsinnstillinger er kuraterte pakker vedlikeholdt av Gratis AI Agent-teamet.

Parametere

ParameterTypeRequiredDescription
presetstringYesNavn på forhåndsinnstilling, f.eks. minimal-dark, warm-editorial, corporate-blue
mergebooleanNoHvis true, slå sammen med eksisterende verdier i stedet for å erstatte. Standard false

Tilgjengelige forhåndsinnstillinger

PresetDescription
minimal-darkNesten svart bakgrunn, hvit tekst, én enkelt aksentfarge
warm-editorialVarm offwhite bakgrunn, seriffoverskrifter, jordnære aksentfarger
corporate-blueMarineblå og hvit palett med profesjonell typografi
vibrant-startupLyse gradienter, avrundede hjørner, moderne sans-serif-skrift
classic-blogNøytrale gråtoner, behagelig linjehøyde, tradisjonell layoutavstand

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


Globale stiler

Global Styles-funksjoner leser og skriver theme.json-verdier gjennom WordPress Global Styles API, og påvirker alle blokker og maler på hele nettstedet.

get_global_styles

Returnerer den gjeldende konfigurasjonen for globale stiler.

Parametere

ParameterTypeRequiredDescription
pathstringNoJSON-peker til en bestemt verdi, f.eks. /color/palette eller /typography/fontSizes. Returnerer hele objektet hvis utelatt.

Returnerer hele objektet for globale stiler eller verdien ved path.


set_global_styles

Oppdaterer én eller flere verdier i konfigurasjonen for globale stiler.

Parametere

ParameterTypeRequiredDescription
pathstringYesJSON-peker til verdien som skal settes, f.eks. /color/palette
valueanyYesDen nye verdien

Eksempel — legg til en farge i paletten

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

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


reset_global_styles

Tilbakestiller alle agentanvendte endringer i globale stiler og gjenoppretter temaets standardverdier.

Parametere — ingen

Returnerer { "success": true }


Navigasjonsmeny-funksjoner oppretter og administrerer WordPress navigasjonsmenyer og elementene deres.

create_menu

Oppretter en ny WordPress navigasjonsmeny.

Parametere

ParameterTypeRequiredDescription
namestringYesMenynavn, f.eks. Primary Navigation
locationstringNoTemaplassering som denne menyen skal tilordnes til, f.eks. primary

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


update_menu

Endrer navn på en meny eller tilordner den på nytt til en temaplassering.

Parametere

ParameterTypeRequiredDescription
menu_idintegerYesID for menyen som skal oppdateres
namestringNoNytt menynavn
locationstringNoTemaplassering som skal tilordnes eller tilordnes på nytt

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


add_menu_item

Legger til et element i en eksisterende navigasjonsmeny.

Parametere

ParameterTypeRequiredDescription
menu_idintegerYesID for målmenyen
typestringYesElementtype: custom, post_type eller taxonomy
titlestringNoEtikett for menyelementet (påkrevd for typen custom)
urlstringNoURL for custom-elementer
object_idintegerNoInnleggs-ID eller term-ID for post_type-/taxonomy-elementer
parent_idintegerNoMenyelement-ID som dette elementet skal nestes under
positionintegerNoNullbasert posisjon i menyen

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


remove_menu_item

Fjerner et element fra en navigasjonsmeny.

Parametere

ParameterTypeRequiredDescription
item_idintegerYesMenyelement-ID som skal fjernes

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


list_menus

Lister opp alle WordPress navigasjonsmenyer, inkludert deres tilordnede temaplasseringer.

Parametere — ingen

Returnerer

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

Alternativadministrasjon

Alternativ-funksjoner leser og skriver WordPress alternativer via get_option / update_option. En innebygd sikkerhetssperreliste forhindrer utilsiktet endring av kritiske innstillinger.

get_option

Leser et WordPress alternativ.

Parametere

ParameterTypeRequiredDescription
option_namestringYesAlternativnøkkelen, f.eks. blogname

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

Returnerer en feil hvis option_name er på sikkerhetssperrelisten.


set_option

Skriver et WordPress alternativ.

Parametere

ParameterTypeRequiredDescription
option_namestringYesAlternativnøkkelen
valueanyYesDen nye verdien (serialiseres automatisk for matriser/objekter)
autoloadstringNo"yes" eller "no". Standard bevarer den eksisterende autoload-innstillingen

Returnerer en feil hvis option_name er på sikkerhetsblokkeringslisten.

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


delete_option

Sletter et WordPress-valg.

Parametere

ParameterTypePåkrevdBeskrivelse
option_namestringJaValgnøkkelen som skal slettes

Returnerer en feil hvis option_name er på sikkerhetsblokkeringslisten.

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


list_options

Lister WordPress-valg som samsvarer med et mønster.

Parametere

ParameterTypePåkrevdBeskrivelse
patternstringNeiSQL LIKE-mønster for å filtrere valgnavn, f.eks. gratis_%. Returnerer alle valg hvis utelatt (bruk med forsiktighet på store databaser).
limitintegerNeiMaksimalt antall resultater. Standard 50, maks 500

Returnerer

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

Innholdsadministrasjon

Innholdsadministrasjonsfunksjoner oppretter og redigerer WordPress-innlegg og -sider. Innleggs-ID-er returneres slik at påfølgende steg i planer med flere funksjoner kan referere til det opprettede innholdet.

create_post

Oppretter et nytt WordPress-innlegg, en side eller en oppføring for egendefinert innleggstype.

Parametere

ParameterTypePåkrevdBeskrivelse
titlestringJaInnleggstittel
contentstringNeiInnleggsinnhold — godtar ren tekst, HTML eller serialisert blokkmarkering
statusstringNeidraft, publish, pending, private. Standard draft
post_typestringNeiSlug for innleggstype, f.eks. post, page eller en registrert CPT. Standard post
excerptstringNeiKort sammendrag som vises i arkiver og søkeresultater
categoriesarrayNeiMatrise med kategorinavn eller ID-er som skal tilordnes
tagsarrayNeiMatrise med taggnavn eller ID-er som skal tilordnes
authorintegerNeiWordPress-bruker-ID som skal settes som innleggets forfatter. Standard er gjeldende bruker
datestringNeiPubliseringsdato i ISO 8601-format, f.eks. 2026-05-01T09:00:00
page_templatestringNeiMalfil som skal tilordnes dette innlegget eller denne siden, f.eks. page-full-width.php. Bare relevant når post_type er page eller en CPT som støtter sidemaler.

Eksempel

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

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


update_post

Oppdaterer et eksisterende WordPress-innlegg eller en side.

Parametere

ParameterTypePåkrevdBeskrivelse
post_idintegerJaID-en til innlegget som skal oppdateres
titlestringNeiNy innleggstittel
contentstringNeiNytt innleggsinnhold
statusstringNeiNy status: draft, publish, pending, private
excerptstringNeiNytt utdrag
categoriesarrayNeiErstatt hele kategorilisten med denne matrisen med navn eller ID-er
tagsarrayNeiErstatt hele tagglisten med denne matrisen med navn eller ID-er
page_templatestringNeiNy malfil som skal tilordnes dette innlegget eller denne siden, f.eks. page-full-width.php. Send en tom streng for å fjerne maltilordningen og gå tilbake til theme-standard.

Eksempel — endre mal etter opprettelse

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

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


batch_create_posts

Oppretter flere innlegg i ett enkelt funksjonskall, noe som reduserer rundreiser under bygging av nettsteder eller import av innhold i bulk. Innlegg opprettes i rekkefølge; hvis ett mislykkes, fortsetter de andre, og feilen rapporteres i resultatmatrisen.

Parametere

ParameterTypePåkrevdBeskrivelse
postsarrayJaMatrise med innleggsobjekter, der hvert godtar de samme parameterne som create_post
stop_on_errorbooleanNeiHvis true, stopp behandlingen etter den første feilen. Standard false

Eksempel

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

Returnerer

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

Tilordner et fremhevet bilde (innleggsminiatyrbilde) til et eksisterende innlegg eller en side. Godtar en eksisterende vedleggs-ID fra mediebiblioteket eller en ekstern bilde-URL; når en URL oppgis, lastes bildet ned og importeres automatisk.

Parametere

ParameterTypePåkrevdBeskrivelse
post_idintegerJaID-en til innlegget eller siden som skal oppdateres
attachment_idintegerNeiID-en til et eksisterende vedlegg i mediebiblioteket
urlstringNeiEkstern bilde-URL som skal importeres og settes som det fremhevede bildet
alt_textstringNeiAlt-tekst som skal brukes på vedlegget hvis det importeres fra en URL

Én av attachment_id eller url må oppgis.

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


create_contact_form

Oppretter et kontaktskjema ved hjelp av den aktive skjemapluginen (Contact Form 7, WPForms, Fluent Forms eller Gravity Forms, avhengig av hva som er installert). Returnerer en shortcode som kan bygges inn i ethvert innlegg eller på enhver side.

Parametere

ParameterTypeRequiredDescription
titlestringYesSkjemanavn som vises i skjema-plugin-admin
fieldsarrayYesOrdnet liste over skjemafelt (se feltobjekt nedenfor)
recipientstringNoE-postadresse som skal motta innsendinger. Standard er WordPress-adminens e-postadresse
subjectstringNoEmnelinje for e-post. Støtter plassholderne [your-name] og [your-subject] ved bruk av Contact Form 7
confirmation_messagestringNoMelding som vises etter en vellykket innsending. Standard: "Thank you for your message. We'll be in touch soon."

Feltobjekt

KeyTypeRequiredDescription
namestringYesInternt feltnavn / maskinnøkkel
labelstringYesMenneskelig lesbar etikett som vises på skjemaet
typestringYestext, email, tel, textarea, select, checkbox, radio, file, date
requiredbooleanNoOm feltet må fylles ut før innsending. Standard false
optionsarrayNoAlternativer for feltene select, checkbox og radio
placeholderstringNoPlassholdertekst for inndata av teksttype

Eksempel

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

Returnerer

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

Visuell gjennomgang

Visuell gjennomgang-funksjoner lar agenten ta skjermbilder av live-sider og analysere dem, noe som muliggjør autonom designgjennomgang, før/etter-sammenligninger og visuelle regresjonskontroller uten å kreve noen nettleserutvidelse.

capture_screenshot

Tar et skjermbilde av en WordPress-side på en angitt URL ved hjelp av en serverbasert headless-nettleser. Bildet lagres i mediebiblioteket, og en CDN-URL returneres.

Parametere

ParameterTypeRequiredDescription
urlstringYesFull URL til siden det skal tas skjermbilde av, f.eks. https://example.com/about/
widthintegerNoViewport-bredde i piksler. Standard 1280
heightintegerNoViewport-høyde i piksler. Standard 800
full_pagebooleanNoTa bilde av hele den rullbare siden i stedet for bare viewporten. Standard false
delay_msintegerNoMillisekunder å vente etter sideinnlasting før bildet tas, nyttig for animert innhold. Standard 500
labelstringNoMenneskelig lesbar etikett lagret med vedlegget i mediebiblioteket

Returnerer

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

compare_screenshots

Tar to skjermbilder og returnerer en visuell diff-score pluss et diff-bilde som fremhever endrede områder. Nyttig for å bekrefte at en designendring ga det forventede resultatet, eller for å oppdage utilsiktede regresjoner.

Parametere

ParameterTypeRequiredDescription
before_urlstringYesURL til siden som skal tas opp som "før"-tilstanden
after_urlstringYesURL til siden som skal tas opp som "etter"-tilstanden. Kan være samme URL hvis det sammenlignes over tid
widthintegerNoViewport-bredde for begge opptak. Standard 1280
thresholdfloatNoTerskel for pikselforskjell (0.0–1.0). Piksler innenfor denne toleransen anses som uendret. Standard 0.1

Returnerer

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

En diff_score0.0 betyr ingen synlig endring; 1.0 betyr at hver piksel er endret.


review_page_design

Tar et skjermbilde av en side og sender det til språkmodellen for visuell analyse. Returnerer en strukturert vurdering som dekker layout, typografi, fargebruk og tilgjengelighetshensyn.

Parametere

ParameterTypeRequiredDescription
urlstringYesFull URL til siden som skal gjennomgås
focusstringNoKommaseparert liste over gjennomgangsområder som skal vektlegges: layout, typography, colour, accessibility, mobile. Standard: alle områder
widthintegerNoViewport-bredde. Standard 1280

Returnerer

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

Installerbare funksjoner

Registeret for installerbare funksjoner lar deg utvide agenten med flere funksjonspakker distribuert som WordPress-plugins. Hver pakke registrerer én eller flere funksjoner ved hjelp av standard funksjons-API.

list_available_abilities

Returnerer katalogen over funksjonspakker som er tilgjengelige for installasjon fra registeret.

Parametere

ParameterTypeRequiredDescription
categorystringNeiFiltrer etter kategori: ecommerce, seo, media, social, developer

Returnerer

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

Laster ned og aktiverer en ability-pakke fra registeret.

Parametere

ParameterTypeRequiredDescription
slugstringJaAbility-pakke plugin-slug

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


recommend_plugin

Spør ability-registeret for å finne den beste pluginen for et beskrevet bruksområde og installerer den eventuelt.

Parametere

ParameterTypeRequiredDescription
descriptionstringJaNaturlig språk-beskrivelse av ønsket funksjonalitet
installbooleanNeiHvis true, installerer den anbefalte pluginen umiddelbart. Standard false

Eksempel

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

Returnerer

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