gtstudio/module-ai-widgets

AI-powered admin widgets for Magento 2. Provides the floating chat assistant and PageBuilder content generation backed by Gtstudio_AiAgents.

Maintainers

Package info

github.com/gabrielgts/module-ai-widgets

Language:JavaScript

Type:magento2-module

pkg:composer/gtstudio/module-ai-widgets

Statistics

Installs: 5

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.0.3 2026-03-11 03:11 UTC

Requires

BUSL-1.1 6861e673c1ef865ec86a8011811d2a96e53b43ba

  • Gabriel Silveira

This package is auto-updated.

Last update: 2026-03-26 12:35:16 UTC

README

AI-powered admin widgets for Magento 2. Provides a floating chat assistant on every admin page and an AI content generator inside PageBuilder HTML blocks.

Preview

AiWidgets — floating chat assistant and PageBuilder AI content generation

AI Studio Ecosystem

Part of the AI Studio suite for Magento 2. See all modules:

Module Repository Description
Gtstudio_AiConnector module-aiconnector Core AI provider abstraction
Gtstudio_AiAgents module-ai-agents Agent & tool orchestration, cron scheduling, execution log
Gtstudio_AiWidgets (this module) Floating admin chat widget + PageBuilder AI generator
Gtstudio_AiDataQuery module-ai-data-query Natural-language store analytics (privacy-first)
Gtstudio_AiKnowledgeBase module-ai-knowledge-base Document upload & RAG retrieval for agents
Gtstudio_AiDashboard module-ai-dashboard AI-powered KPI dashboard with ML insights

What It Does

  • Floating Chat Widget — a persistent chat panel in the Magento admin, powered by the admin_assistant agent
  • PageBuilder AI Generator — an AI Generate button inside PageBuilder HTML blocks to create or rewrite content via the page_builder_generator agent
  • Token and cost estimation displayed in real time for every message

Requirements

  • Magento 2.4.4+
  • PHP 8.1+
  • Gtstudio_AiConnector enabled and configured
  • Gtstudio_AiAgents enabled
  • Magento_PageBuilder (bundled with Adobe Commerce; available as OSS extension for Community)

Installation

composer require gtstudio/module-ai-widgets
php bin/magento module:enable Gtstudio_AiWidgets
php bin/magento setup:upgrade

Setup

Admin Chat Assistant

  1. Go to AI Studio → Agents → Add New
  2. Set Code to admin_assistant
  3. Fill in Background, Steps, and Output Instructions to define the assistant's persona
  4. Save — the widget appears automatically for users with the Gtstudio_AiWidgets::management ACL resource

PageBuilder Generator

  1. Create an agent with code page_builder_generator
  2. In PageBuilder, open any HTML block — an AI Generate button appears in the toolbar
  3. Type a prompt and click Generate; the result is inserted into the block

Extensibility

Swapping the agent used by the chat widget

The agent code is hardcoded as admin_assistant in AdminChatService. Override the service via DI preference to change this or add additional logic:

<!-- etc/di.xml -->
<preference for="Gtstudio\AiWidgets\Model\Service\AdminChatService"
            type="Vendor\Module\Model\Service\CustomAdminChatService"/>

Customising the chat widget template

Override via standard Magento layout XML:

<!-- view/adminhtml/layout/default.xml -->
<page>
    <body>
        <referenceBlock name="gtstudio.ai.chat.widget">
            <action method="setTemplate">
                <argument name="template" xsi:type="string">
                    Vendor_Module::chat/custom-widget.phtml
                </argument>
            </action>
        </referenceBlock>
    </body>
</page>

The default templates are in:

view/adminhtml/templates/chat/widget.phtml
view/adminhtml/web/js/admin-chat.js

Adding token pricing for a custom model

Extend TokenCostService via di.xml — see the Gtstudio_AiConnector README for the full pattern.

ACL Resources

Resource Controls
Gtstudio_AiWidgets::management Access to all widget features and the chat API endpoint