Built-in tools
Tools are capabilities that the AI assistant can invoke during a conversation. Each tool has a name, description, input parameters, and output format. Tools are filtered by the admin user's ACL permissions — Copilot can only use tools that the logged-in admin's role has access to.
Read-only and write tools
Nine of the built-in tools can only read from your store; the rest can change it. This is worth knowing when deciding what to grant a role in Configure role permissions - granting only the left-hand column gives a role an assistant that can investigate and report but never alter anything.
| Read-only | Can change store data |
|---|---|
| Store Info, Packages, Mirasvit Modules Info, Database Reader, Log Reader, Cron Checker, Doc Search, Manual Search, Who Am I | REST API, GraphQL Query, Cache Manager, Indexer |
Database Reader is read-only because it rejects anything other than SELECT, DESCRIBE, SHOW, EXPLAIN and WITH. REST API and GraphQL Query are on the right because both can reach write endpoints and mutations, whatever a given call happens to do.
Cache Manager and Indexer can each be restricted to their read-only actions by a setting - see their pages.
The AI Copilot extension includes thirteen built-in tools:
📄️ Store Info
The Store Info tool returns store configuration and structure — websites, store views, currencies, and locale settings.
📄️ Database Reader
The Database Reader tool executes read-only SQL queries against the Magento database. It supports SELECT, DESCRIBE, SHOW, and EXPLAIN statements.
📄️ REST API
The REST API tool provides full access to Magento's REST API — the same endpoints available at /rest/V1/*. It supports GET, POST, PUT, and DELETE methods, as well as asynchronous and bulk operations.
📄️ GraphQL Query
The GraphQL Query tool executes queries and mutations against Magento's GraphQL API.
📄️ Doc Search
The Doc Search tool browses and searches documentation shipped with installed Magento modules. It provides Copilot with usage guides, required workflows, and common pitfalls — information that cannot be auto-discovered through REST API schemas or database structure.
📄️ Manual Search
The Manual Search tool searches and browses the official Mirasvit extension manuals — installation guides, configuration instructions, troubleshooting steps, feature documentation, and per-module changelogs.
📄️ Packages
The Packages tool lists the Composer packages installed on the Magento instance — one row per shippable extension. Each entry carries the Composer package name, the user-facing title, the installed version, its status, the technical modules it provides, and the other packages it requires.
📄️ Mirasvit Modules Info
The Mirasvit Modules Info tool returns every installed Mirasvit package enriched with its latest stable version (from the Mirasvit feed) and its license status (from the Mirasvit license server). One call answers questions that would otherwise require scraping each module's changelog.
📄️ Who Am I
The Who Am I tool returns the identity of the logged-in admin user that Copilot is acting on behalf of: user_id, email, firstname, and lastname.
📄️ Cache Manager
The Cache Manager tool inspects and manages Magento cache types. It can list all cache types with their status, and clean, flush, enable, or disable them.
📄️ Cron Checker
The Cron Checker tool diagnoses the health of Magento cron. It reports overall cron health, per-group heartbeat, detects failing, stuck, and never-scheduled jobs, and returns a bounded run history with error messages. It is read-only.
📄️ Indexer
The Indexer tool lists Magento indexers with their status, mode, last update time, and backlog, and can invalidate indexers to schedule an asynchronous rebuild.
📄️ Log Reader
The Log Reader tool inspects Magento log and report files under var/log and var/report. It can list files, tail them, grep across them, read a whole file, or read a line range. Every action is bounded. It is read-only.