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?"
Available Tools
The AI assistant has access to 8 read-only tools:
| 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 |
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.
The AI assistant only has read-only access to data. It cannot create, modify, or delete any records. All queries require Admin authentication.
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.