AI Assistant for Magento 2

CommerceGears AI Assistant: an AI chatbot for selected admin users, using OpenAI or Anthropic models, with read-only access to the store data, code and logs, CSV reports, issue tickets and cost analytics. Store-specific knowledge and tools are added by other modules.

  • Magento 2.4.7 – 2.4.9
  • PHP 8.3 – 8.5
  • Hyvä and Luma
  • Version 3.1.0
User guide Ask a question
$699

One-off payment, with 12 months of updates.

What is included

  • Install with Composer, or download a zip from your account
  • Licence for one production domain, staging and development copies included

No subscription or automatic renewal. Keep using the versions included in your update period. Update and licence details

Key features

  • AI chat in the admin for selected users; admin only, so the storefront theme (Luma or Hyvä) does not matter
  • Anthropic (default) or OpenAI, with your own API key
  • Read-only database access, enforced by MySQL
See all features

Composer package commercegears/module-ai-assistant

  • Reads, never rewrites

    Queries run in read-only transactions on their own connection, so the database itself rejects writes. The assistant can only create a few things, through write tools defined in code, after the user presses Yes.

  • Answers without a developer

    Ask why an order has not shipped, what went wrong in the logs today or how a setting is configured. The assistant looks at the store records, logs, configuration and code and answers in the user's language.

  • Costs under control

    Every request is priced per user, model and conversation in Cost Analytics. Set a daily question limit per user and a monthly budget; when it is used up, the chat waits until next month.

All features

What is included

Chat

  • Full chat page and a floating chat on every admin page
  • Knows the open order, product or customer page
  • Charts (bar, line, pie) and CSV reports in answers
  • Rename, pin, archive and share conversations
  • Optional voice input in supported browsers

What it can read

  • Store database through a read-only connection
  • Configuration, logs and the store's code (credential files excluded)
  • Chosen CMS pages as a company knowledge base
  • New Relic monitoring data (optional, read-only key)
  • Personal data and secrets masked before sending

What it can create (after Yes)

  • Issue tickets, with masked evidence
  • Scheduled questions answered into the Inbox
  • Inactive CMS page drafts with an admin-only preview
  • Inactive cart price rule drafts with coupons
  • Every creation recorded in the write log

Control and costs

  • Only users you allow by command line
  • Separate ACL permissions for every page and action
  • Cost Analytics per user, model and conversation
  • Questions per user per day and a monthly budget
  • Ready Reports, daily summary and test set for checking answers

Feature tour

Everything your shoppers and your team see

01 / 06

Ask about the store in plain words

AI Assistant > Chat, or the floating chat on any admin page. Only the admin users you allow can use it, and their role needs the Chat permission.

02 / 06

Your provider, your key, your model

Anthropic is the default provider, OpenAI is optional. The API key is stored encrypted, "Refresh model list" loads the models your key can use, and Answer Depth sets how thoroughly the assistant investigates.

03 / 06

The database refuses every write

The assistant and Ready Reports read through their own connection in read-only transactions. For extra safety, add a database user with SELECT grants only: the module prints the SQL for it.

04 / 06

Ask once, download again any time

After a report in the chat the assistant offers to save it. Ready Reports then lists it under its group, with a start and an end date when it covers a period: choose new dates and download the CSV. It runs in the store database and costs nothing.

05 / 06

Drafts only after Yes

When a user asks, the assistant can prepare an inactive CMS page or an inactive cart price rule. The server shows a summary with Yes and No; nothing is created before Yes, and every creation goes into the write log.

06 / 06

One permission per action

Chat, tickets, Cost Analytics, Ready Reports, feedback and each write tool have their own ACL resource under AI Assistant, so every role gets exactly what it needs.

Live demo

Try it before you install it

A full Magento store with the module installed, on Luma and on Hyvä. The admin demo signs you in with one click.

Compatibility

Requirements and compatibility

Compatibility of AI Assistant
Magento2.4.7 – 2.4.9
PlatformsMagento Open Source and Adobe Commerce (one price)
Storefront themes Luma Blank Hyvä
PHP8.3 – 8.5
Latest version 3.1.0
composer.json requires php ~8.3.0||~8.4.0||~8.5.0 ext-mysqli * magento/framework * commercegears/module-core ^2.0 free, installed by Composer with this module commercegears/module-ai-core ^2.0 free, installed by Composer with this module magento/module-backend * magento/module-store * magento/module-user * magento/module-sales * magento/module-catalog * magento/module-customer * magento/module-cms * magento/module-sales-rule * magento/module-cron * anthropic-ai/sdk ^0.54

Installation

Up and running in minutes

After you buy, create a Composer key in your account. Then, in the root of your Magento project:

  1. 01Add the repository and your key (once per project)

    composer config repositories.commercegears composer https://repo.commercegears.com
    composer config --auth http-basic.repo.commercegears.com PUBLIC_KEY PRIVATE_KEY
  2. 02Install the module

    composer require commercegears/module-ai-assistant
  3. 03Enable it

    bin/magento setup:upgrade
    bin/magento setup:di:compile
    bin/magento setup:static-content:deploy
    bin/magento cache:flush

    The last three are only needed in production mode.

Prefer a zip? Every version you are entitled to can be downloaded from My modules. More about Composer access

User guide

Setting up AI Assistant

The user guide has its own page: how to install AI Assistant, what each option does and how to use it in your store. Written for version 3.1.0; a copy ships with the module.

In the guide

Read the user guide

Changelog

Release notes

3.1.0

Latest
  • New: attach images, PDFs and text files to a question (paperclip, drag and drop or paste a screenshot)
  • New: attached files show under the question, also on shared conversations, and unsent files are cleaned up

3.0.1

  • Improvement: user guide screenshots and links updated for the CommerceGears name

3.0.0

  • Improvement: renamed to CommerceGears (new Composer package, admin menu and settings paths)

FAQ

Questions, answered

Something else on your mind? The developers who wrote the module answer before and after you buy.

Ask a question →

Already installed it? Open a support ticket

What do I need besides the module?

An API key from the AI provider you choose: Anthropic (the default) or OpenAI. You create the key in your own provider account, and the provider bills you directly for what the assistant uses. The module itself makes no charge per question. Image generation for CMS page drafts needs an OpenAI key in any case. The keys are entered once under Stores > Configuration > CommerceGears > AI > AI Providers & Costs, shared by all CommerceGears AI modules (the free CommerceGears AI Core module, installed with the assistant).

How much does a question cost?

That depends on the model, how much the assistant has to look up and the provider's prices, so there is no fixed figure. Every request is recorded with its token counts and cost in AI Assistant > Cost Analytics, per user, model and conversation, at the prices in AI Providers & Costs > Costs > Model Prices (check them against your provider's pricing page). You can limit Questions per User per Day, set a Monthly Budget for all AI modules in AI Providers & Costs and, if you like, an AI Assistant Monthly Limit (USD) for the assistant alone. Saved reports under Ready Reports run in the store database and cost nothing.

Who can use the chat?

Admin users whose role has AI Assistant > Chat. A store can narrow this further (for example to a list of named users); users kept away see nothing of the AI Assistant. CSV reports from the chat contain real customer data, so give the Chat permission only to roles that may see it.

Can the assistant change or delete data in my store?

It cannot change or delete existing data. Every query it writes runs on a separate connection in read-only transactions, so MySQL itself rejects INSERT, UPDATE, DELETE and similar statements. It can only create new things through four write tools defined in the module's code: issue tickets, scheduled questions, inactive CMS pages and inactive cart price rules. Each one needs its own role permission, shows a summary written by the server with Yes and No buttons, is created only after Yes and is recorded in the write log (bin/magento commercegears:ai-assistant:write-log).

What data is sent to the AI provider?

The questions, the store data the assistant reads to answer them and, when it looks at code, parts of the store's source code. Names, e-mail addresses, phone numbers, addresses, credentials and similar values are masked before they leave the store, and password hashes and tokens are hidden even in CSV reports. Files such as env.php and auth.json cannot be read at all. Check that your provider's terms and your data protection duties allow this before you switch the module on.

Should I use Anthropic or OpenAI?

Anthropic is the default and the module's reference provider. OpenAI works with the same tools, permissions, read-only connection, masking, confirmation and budget. Every answer shows which provider and model wrote it, and conversations continue when you switch.

Will a published page or a live promotion appear by accident?

No. CMS pages and cart price rules made by the assistant are always created inactive. A CMS draft can be checked through a signed preview link that only admins with the Pages permission get, valid for one hour. You activate the page or rule yourself in the usual Magento screens. Both draft tools can also be switched off in Capabilities.

Can I get reports without using AI at all?

Yes, once a report is saved. Ask the assistant for a report once; after the CSV it offers to save it under AI Assistant > Ready Reports. From then on you download it there with new dates (or other filters), with no model involved and at no cost.

Does it work in my admin language?

The assistant answers in the language the user writes in. The admin screens come with English and Turkish translations; other languages can be added with a standard Magento translation file.

Does it affect the storefront or its speed?

No. The module works in the admin only. Daily summaries, scheduled questions and test runs run in their own cron group (commercegears_ai_assistant), so they do not delay other cron jobs. The only storefront part is the admin-only preview of CMS drafts, which is never cached and marked noindex.

Can I teach it about my store?

Yes. Choose CMS pages (for example returns, shipping or FAQ) under Capabilities > Knowledge Base Pages and the assistant reads them for process questions and links the source page. Describe your integrations, custom tables and status codes under Store Knowledge > Store Instructions. With Store Memory on, the assistant also offers to remember what it worked out about your store; after Yes the note appears under AI Assistant > Store Notes, where you can correct, turn off or delete it.

Can it look at monitoring and other systems?

With New Relic set up (a User API key of a read-only user), the assistant can query errors and slow transactions. Other systems are not queried directly: the assistant uses the statuses your integrations save in the store database.

Can I get a chat report again later for other dates?

Yes. After a CSV report the assistant offers to save it under Ready Reports with filters such as a date range. You then download it there with new values, without the assistant and at no cost.

Support

Help from the developers who wrote it

From the blog

Guides and articles