AI Assistant
The Backoffice includes a built-in AI chat assistant that can answer questions about your store data using natural language.
Setup
Navigate to Settings → AI Settings.
Provider Configuration
| Field | Description |
|---|---|
| Provider | Select: Ollama, OpenAI, Claude, or Azure OpenAI |
| Base URL | API endpoint URL |
| Chat Model | Model name (e.g., gpt-4o, llama3.1, claude-sonnet-4-20250514) |
| API Key | Authentication key (not required for Ollama) |
Default Settings per Provider
| Provider | Default URL | Default Model |
|---|---|---|
| Ollama | http://localhost:11434 | llama3.1 |
| OpenAI | https://api.openai.com/v1 | gpt-4o |
| Claude | https://api.anthropic.com/v1 | claude-sonnet-4-20250514 |
| Azure OpenAI | Your Azure endpoint | gpt-4o |
Health Check
Use the Test Connection button to verify the AI provider is reachable and configured correctly.
Using the Assistant
Click the sparkles button (✨) floating in the bottom-right corner of any Backoffice page. This opens the AI chat panel.
Example Queries
- "What were yesterday's total sales?"
- "Show me the top 5 selling products this month"
- "How many orders are in Processing status?"
- "Give me a summary of customer John Doe"
- "What discount codes are currently active?"
- "What's the revenue breakdown by order status?"
- "Create a 20% off promotion for the Electronics category this weekend, max ₺50 discount"
- "Set up a buy 2 get 1 free campaign for the Nike brand and make it live"
- "Disable discount code SUMMER20"
Read Tools
The AI assistant has 8 read-only tools for answering questions:
| Tool | Description |
|---|---|
get_order_summary | Order counts and totals by status |
get_recent_orders | Latest orders with details |
get_customer_summary | Customer info and order history |
get_product_summary | Product details and stock |
search_products | Search products by name/SKU |
get_discount_codes | Active discount codes |
get_top_selling_products | Best sellers by quantity |
get_revenue_by_status | Revenue grouped by order status |
Write Actions
The assistant can also make changes when you explicitly ask:
| Tool | Description |
|---|---|
update_discount | Update an existing discount code (value, type, enabled state, usage limit, date range, basket rules) |
create_promotion | Create a new automatic promotion (cart/catalog campaign) from a natural-language prompt |
Creating Promotions
Describe the promotion in plain language and the assistant builds it for you. Supported promotion types: PercentageDiscount, FixedAmountDiscount, FreeShipping, BuyXGetY, BuyXPayY, DiscountedShipping. You can scope a promotion to specific categories or brands by name — the assistant resolves the names to IDs and tells you about any it couldn't match.
New promotions created via chat are disabled (not live) so you can review them in Marketing → Promotions first. They are only created enabled when you explicitly ask to activate / publish / make it live. The assistant always confirms the name, type, scope, validity dates, and enabled state after creating one.
Tiered and Fixed-Price-Bundle promotions are not yet supported via chat — create those from the Promotions screen.
Multi-Turn Conversations
The chat maintains conversation history within a session. You can ask follow-up questions and the assistant will use context from previous messages.
All assistant access requires Admin authentication (and the settings:integrations permission). Beyond read-only queries, the assistant can perform a limited set of write actions (updating discount codes, creating promotions) only when you explicitly request them; new promotions are created disabled for review unless you ask to activate them. It cannot delete records.
For Ollama, you can run a local AI model with no API key cost. Install Ollama, pull a model (ollama pull llama3.1), and configure the Backoffice to point to your local instance.