Chatbot settings (persona and prompts)
Navigation: WordPress Admin → WooCommerce → AI Assistant → Settings → Chatbot
Stored in option aiwsa_prompts. Used when an AI provider is configured. Native catalog turns do not apply persona/tone to product ranking.
Persona
What it does Short description of how the assistant should speak.
Default value Empty.
Available options Plain text (sanitized).
Recommended configuration One clause, e.g. “a helpful boutique stylist”.
When to use it Brand voice.
Effect on the frontend Wording style of LLM replies.
Dependencies AI provider.
Important notes Does not override guardrails or tool allow-lists.
Example a concise auto-parts specialist
Tone
What it does Preset tone fragment in the system prompt.
Default value friendly
Available options
| Value | Label |
|---|---|
friendly | Friendly |
professional | Professional |
concise | Concise |
enthusiastic | Enthusiastic |
Recommended configuration Professional for B2B; Friendly for DTC.
When to use it Match brand guidelines.
Effect on the frontend Style of LLM text only.
Dependencies AI provider.
Important notes Empty persona + Friendly is a reasonable default.
Example Professional for a medical-supply catalog.
Store note
What it does Facts the assistant should know, such as shipping cut-offs or return policy.
Default value Empty.
Available options Textarea (sanitized).
Recommended configuration Only facts you would print on the site. Do not paste customer PII.
When to use it Policies not stored on products.
Effect on the frontend LLM may mention these facts. They are not executed as code.
Dependencies AI provider. The model can still be wrong; keep copy short and accurate.
Important notes This is not a legal contract engine.
Example Orders placed before 2pm ship same day. Returns within 30 days.
Custom instructions (Prompt Settings accordion)
What it does Optional extra system text.
Default value Empty.
Available options Textarea.
Recommended configuration Keep short. Catalog facts still come from WooCommerce tools.
When to use it Hard rules (“Never mention competitors”).
Effect on the frontend LLM behavior.
Dependencies AI. Filter aiwsa_prompt_fragments for developers.
Important notes Long custom prompts increase token use and can fight tool instructions.
Example Never recommend products over the shopper’s stated budget.