Download the PHP package gtstudio/module-aiconnector without Composer

Gtstudio_AiConnector

Core AI provider abstraction for Magento 2. Every other Gtstudio AI module depends on this one to communicate with external AI providers.

Preview

AI Studio Ecosystem

Gtstudio_AiConnector is the foundation of the AI Studio suite — a collection of modules that bring AI capabilities to the Magento admin without coupling your store to a single provider. Each module builds on top of this connector and can be installed independently.

Gtstudio_AiAgents — Agent & Tool Orchestration

Define AI agents directly in the admin UI and attach reusable tools they can call. Each agent has a structured system prompt (background, reasoning steps, output rules) and a list of tools with property schemas that the LLM uses to decide what to execute.

Key advantages

• No code required to create a new agent — everything is configured in the admin
• Run Now — execute any agent on-demand from its edit page and see the result immediately
• Cron scheduling — attach a cron expression to any agent so it runs automatically (e.g. generate a daily sales report every morning)
• Execution log — every run is recorded with status, token counts, input, output, and trigger source; old entries are pruned automatically
• Extensible tool registry — implement ToolExecutorInterface and register it via di.xml to give agents access to any custom PHP logic

Gtstudio_AiWidgets — Admin UI Widgets

Surfaces AI capabilities directly inside the Magento admin without requiring users to leave the page they are working on.

Key advantages

• Floating chat assistant — a persistent panel available on every admin page, backed by any agent you define (default: admin_assistant)
• PageBuilder AI generator — an AI Generate button inside PageBuilder HTML blocks lets content editors describe what they want and have the AI write clean semantic HTML into the block
• Real-time token and cost estimation on every message
• Fully overridable via standard Magento layout XML and DI preferences — no core patches

Gtstudio_AiDataQuery — Natural-Language Store Analytics

Lets admin users ask plain-English questions about their store data and receive structured results — without ever sending store data to the LLM.

Key advantages

• Privacy-first two-phase architecture: the LLM only sees the user's question and returns a structured intent (which tool to call, which parameters); all actual database queries run locally on your server
• Built-in analytics tools cover the most common reporting needs: order analytics, customer lifetime value, product performance, and a general entity query
• Fully extensible: register custom query tools and entity handlers via di.xml; override the planner prompt to teach the LLM about your custom tools

Gtstudio_AiKnowledgeBase — Document Context for Agents

Upload PDF or plain-text documents in the admin and associate them with agents. At query time, relevant excerpts are retrieved and prepended to the agent's context — enabling retrieval-augmented generation (RAG) without a vector database.

Key advantages

• No external vector store required — excerpts are stored and matched in the Magento database
• Only the most relevant excerpts are sent to the LLM, keeping token usage low
• Extensible extraction pipeline: add support for new file formats (DOCX, CSV, etc.) by implementing ExtractorInterface and registering via di.xml
• Swappable retrieval strategy: replace the default keyword matcher with OpenSearch k-NN or any other similarity search by implementing RetrievalServiceInterface

What It Does

• Wraps neuron-core/neuron-ai to expose a single, consistent interface regardless of which AI provider is configured
• Provides a REST endpoint for on-demand AI text generation
• Manages all provider configuration (API key, model, temperature, max tokens) in one place under Stores → Configuration → AI Connector
• Ships a TokenCostService for tracking and estimating token costs across providers

Supported Providers

Requirements

• Magento 2.4.4+
• PHP 8.1+
• neuron-core/neuron-ai ^2

Installation

Configuration

Stores → Configuration → Gtstudio → AI Connector → General

REST API

Generate text

Request body

All fields except prompt are optional and fall back to the admin-configured values.

Extensibility

Adding a new provider

Create a plugin on NeuronClient::resolveProvider():

Extending the token pricing table

Magento merges xsi:type="array" arguments automatically — add or override prices in your module's di.xml:

Using NeuronClient in another module

Inject NeuronClient and call resolveProvider() to get a ready-to-use AIProviderInterface:

Injecting a custom system prompt at runtime

Set rules on the AiRequestInterface object — it overrides the admin-configured default for that request only.