Skip to main content

Built-in Agents

Gratis AI Agent v1.9.0 ships five built-in agents, each pre-configured with a focused set of tools, a tailored system prompt, and starter suggestions matched to common tasks in that area. Switching between agents changes what the assistant can do and how it responds — without any configuration on your part.

What Is an Agent?​

Each agent is a named configuration profile that combines:

  • Tools — the abilities the agent is allowed to invoke (e.g. a Content Writer has access to post-creation abilities; a Design Studio has access to CSS and theme.json abilities)
  • System prompt — instructions that set the agent's tone, priorities, and constraints
  • Suggestions — pre-written prompts shown in the chat interface to help you get started quickly

Accessing the Agent Picker​

  1. Open the Gratis AI Agent panel in the WordPress admin sidebar.
  2. Click the agent icon in the top-left of the chat header (the icon changes to reflect the active agent).
  3. The Agent Picker opens as a form-table overlay. Each agent is listed with its icon, name, and a one-line description.
  4. Click an agent row to activate it. The chat header updates immediately.

You can also switch agents mid-conversation — the new agent's system prompt takes effect from the next message.

The Five Built-in Agents​

Content Writer​

Focus: Creating and editing posts, pages, and contact forms.

Available tools: create_post, update_post, batch_create_posts, set_featured_image, create_contact_form, get_option, list_post_types

What it does well:

  • Drafting and publishing blog posts from a brief or outline
  • Creating batches of landing pages for a new site
  • Building contact and enquiry forms
  • Setting featured images on posts from a URL or search

Starter suggestions:

  • Write a 500-word blog post about the benefits of WordPress multisite.
  • Create an About, Services, and Contact page and publish them.
  • Add a booking enquiry form to the Contact page.

Site Builder​

Focus: End-to-end website creation from a single prompt.

Available tools: create_site_plan, execute_site_plan, get_plan_progress, handle_plan_error, create_post, batch_create_posts, register_post_type, create_menu, add_menu_item, inject_custom_css, apply_theme_json_preset, install_ability, recommend_plugin, create_contact_form

What it does well:

  • Generating a multi-phase site build plan for a described business type
  • Executing each phase autonomously — structure, content, navigation, design
  • Recovering from errors mid-plan without requiring manual intervention
  • Installing recommended plugins as part of the build
  • Creating contact forms directly from the chat interface (Superdav AI Agent v1.10.0+)

Starter suggestions:

  • Build a photography portfolio site with a gallery post type, a booking page, and a contact form.
  • Create a restaurant website with an online menu, opening hours, and a table-booking enquiry form.
  • Set up a freelance consulting site with service pages, a portfolio section, and a blog.
  • Add a contact form to the Contact page using the site builder.

Design Studio​

Focus: Visual customisation — colours, typography, CSS, and block patterns.

Available tools: inject_custom_css, apply_theme_json_preset, get_global_styles, set_global_styles, reset_global_styles, add_block_pattern, list_block_patterns, set_site_logo, capture_screenshot, review_page_design

What it does well:

  • Applying named theme presets (minimal-dark, warm-editorial, corporate-blue, vibrant-startup, classic-blog)
  • Fine-tuning global typography and colour palettes via theme.json
  • Injecting custom CSS for brand-specific overrides
  • Taking a screenshot of a page and reviewing it for design issues

Starter suggestions:

  • Apply the warm-editorial preset and then set the primary colour to #2d6a4f.
  • Take a screenshot of the homepage and tell me what you'd improve.
  • Create a reusable hero block pattern with a full-width background image and centred heading.

Plugin Manager​

Focus: Discovering, installing, and managing WordPress plugins.

Available tools: list_available_abilities, install_ability, recommend_plugin, get_option, set_option

What it does well:

  • Recommending the best plugin for a described use case
  • Installing ability packs from the registry
  • Browsing the available ability catalogue by category

Starter suggestions:

  • What's the best plugin for a membership directory?
  • Install the WooCommerce abilities pack.
  • Show me all available ecommerce ability packs.

Support Assistant​

Focus: Answering questions about site content, settings, and WordPress configuration.

Available tools: get_option, list_options, list_post_types, list_taxonomies, list_menus, list_available_abilities

What it does well:

  • Looking up current site settings and options
  • Explaining what post types, taxonomies, and menus are configured on the site
  • Answering "what does this setting do?" questions by reading live values
  • Serving as a read-only diagnostic layer before making changes

Starter suggestions:

  • What plugins and settings are currently active on this site?
  • List all the custom post types registered on this site.
  • What navigation menus exist and where are they assigned?

Customising Agents​

Each built-in agent can be extended or replaced through the gratis_ai_agent_agents filter.

Adding a custom system prompt to an existing agent​

add_filter( 'gratis_ai_agent_agents', function ( array $agents ): array {
    if ( isset( $agents['content-writer'] ) ) {
        $agents['content-writer']['system_prompt'] .= "\n\nAlways write in British English and use the Oxford comma.";
    }
    return $agents;
} );

Registering a new agent​

add_filter( 'gratis_ai_agent_agents', function ( array $agents ): array {
    $agents['seo-specialist'] = [
        'name'          => 'SEO Specialist',
        'description'   => 'Optimises posts and pages for search engines.',
        'icon'          => 'dashicons-search',
        'tools'         => [ 'get_option', 'set_option', 'create_post', 'update_post', 'list_post_types' ],
        'system_prompt' => 'You are an SEO specialist. Focus on keyword optimisation, meta descriptions, and structured data.',
        'suggestions'   => [
            'Review the homepage title and meta description.',
            'Suggest title tag improvements for the five most recent posts.',
        ],
    ];
    return $agents;
} );

The new agent appears in the Agent Picker immediately after the filter runs.

Removing a built-in agent​

add_filter( 'gratis_ai_agent_agents', function ( array $agents ): array {
    unset( $agents['plugin-manager'] );
    return $agents;
} );