How to instruct the WCB AI assistant with valid prompts

This guide explains how to use the WCB prompts AI assistant to produce valid responses for the WCB configuration builder plugin.

It includes:

• How to speak to the assistant
• How to request configurations, steps, tabs, groups, fields, options, and conditions
• Many example prompts you can copy/paste

How the AI assistant works

You must name a configuration if you want a full configuration output or want to update one.

If you do not ask for a configuration, the assistant returns only fields.

When to use “configuration names”

Include configuration names ONLY when:

• You create a new configuration
• You update an existing configuration
• You explicitly mention the configuration name

Otherwise, JSON should contain only fields, only steps, or whatever you requested.

Field types you can request

When to use options

Only for:

• select
• list
• cards
• swatches
• button-group
• label

Never include options for: text, textarea, email, number, boolean, date, phone, range, file, color_picker.

Update types (for modifying an existing configuration)

You can instruct the assistant to:

• add_step
• add_tab
• add_group
• add_field
• add_condition
• move_group
• remove_field
• edit_field

Updates require a configuration name.

Requesting structures

You can request:

• Complete configuration
• Individual fields
• Groups
• Tabs
• Steps (pro)
• Conditional logic (pro)
• Updates to an existing configuration

Practical example prompts

Below is a large set of copy-friendly example prompts organized by topic.

1. Create fields only

Example prompts:

• Create fields for a contact form: name (text), email (email required), message (textarea min 20)
• Give me a radio field labeled ‘Delivery Method’ with options Standard, Express +10, and Overnight +20
• I need a range slider labeled ‘Brightness’ from 0 to 100 default 50

2. Choice fields

Example prompts:

• Create a dropdown field labeled ‘Shipping Method’. Include three options: Standard, Express +10, Overnight +25
• Create a field labeled ‘Payment Method’ with template ‘list’. Include options Credit Card, PayPal +5, Bank Transfer
• Create a field labeled ‘Meal Add-ons’ with template ‘cards’. Include options: Extra Sauce +1, Dessert +3, Side Salad +2
• Create a field labeled ‘T-Shirt Size’ with template ‘button-group’. Include options XS, S, M, L, XL.
• Create a field labeled ‘Frame Color’ with template ‘swatches’ and type ‘color’. Include options Red, Blue, Green, Yellow
• I need a color swatch field with options (Red), (Green, 10), (Gold, 30, GLD)

3. Input fields

Single line text

• Create a text field labeled ‘Full Name’. Make it required with a minimum of 2 characters and a maximum of 50

Multi line text (textarea)

• Create a textarea field labeled ‘Additional Notes’. Make it optional and set the maximum length to 500 characters

Email address

• Create a standalone email field labeled ‘Contact Email’. Make it required

Phone

• Create a phone field labeled ‘Phone Number’. Make it optional

True/false

• Create a boolean field labeled ‘Subscribe to Newsletter’. Set the default value to true

Number input

• Create a number field labeled ‘Quantity’. Set minimum 1, maximum 100, and default 1

Range slider

• Create a range slider field labeled ‘Volume Level’. Set the minimum to 0, maximum to 100, and default value to 50

Color picker

• Create a color_picker field labeled ‘Background Color’. Set the default color to #ff0000

Date picker

• Create a standalone date field labeled ‘Event Date’. Set the default date to 2025-01-01

File upload

• Create a standalone file upload field labeled ‘Upload Reference Image’. Accept only .jpg and .png files

4. Create a full configuration

Example prompts:

• Create a configuration called T-Shirt Builder with a base price of 20 and fields for size (select), color (radio), and custom text (text)
• Create a configuration named Car Wrap Configurator using steps: Step 1 Select Material (with a tab ‘Vinyl Options’), Step 2 Upload Files, Step 3 Checkout
• Make a new configuration Custom PC with a left-gallery template and width fullwidth. Add fields for CPU, GPU, Memory, and PSU

5. Adding or editing fields in existing configurations

Example prompts:

• In configuration Custom PC, add a new number field called ‘Warranty Years’ min 1 max 5 default 1.”
• Update configuration Flower Box and edit the field ‘Box Size’ to include a new option ‘Extra Large +20’
• Remove the field ‘Gift Message’ from the configuration Bouquet Builder

6. Steps (pro), tabs, and groups

Example prompts:

• Inside a configuration called Photo Booth, create one step called ‘Style Options’ with a tab named ‘Backdrop Colors’ containing a group ‘Fabric Choices’ with three color swatch options
• Add a new step called ‘Review’ to the configuration Kitchen Planner.
• Create a tab labeled ‘Dimensions’ with two number fields width and height to the configuration Kitchen Planner

7. Conditional logic examples (pro)

Example prompts:

• In configuration Furniture Builder, show the field ‘Stain Color’ only when ‘Wood Type’ equals ‘Oak’
• For the configuration Car Customizer, hide field ‘Turbo Options’ when ‘Engine Type’ not_equals ‘Sport’
• In configuration Bike Builder, show ‘Battery Options’ when ‘Model’ contains ‘Electric’

8. Complex multi-element prompts

Example prompts:

• Create a full configuration named Backyard Shed Configurator. Step 1 Dimensions (width, depth, height). Step 2 Door Options (one radio field). Step 3 Paint Colors with options (red, green, blue, yellow). Set main action to quote.
• For configuration Gift Basket, add a new step called ‘Fruits’, with a tab ‘Citrus’, containing a group ‘Oranges’ and a checkbox field for fruit selections.
• Create a group called ‘Advanced Options’ inside a tab named ‘Performance’ inside a step named ‘Engine’ for configuration “Car Builder”. Add three number fields.

Tips for best results

Here is a small checklist to save you headaches and gives you the best results:

• Always name the configuration when doing creation or updates
• Say “no configuration” when you want only fields
• Be specific about:
  • Step names
  • Tab names
  • Group names
  • Field types
  • Min/max/default
  • Options (label, price, sku)
• Describe conditional logic clearly
• Ask for only what you need