Knowledge Base
The Knowledge Base is the content the assistant is allowed to answer from. Most of it arrives automatically from your Magento store; the rest you add here.
What arrives from Magento
The extension's sync pushes five content sources into the knowledge base, each into its own category, which the extension creates on the first document:
| Source | --type | Category |
|---|---|---|
| Store information | store_info | Store Information |
| Products, with variants, attributes, and images | product | Products |
| Categories | category | Categories |
| CMS pages | cms_page | CMS Pages |
| Mirasvit Knowledge Base articles | kb_article | Knowledge Base |
The sync runs daily at 2:00 AM and can be triggered by hand - see How to sync data manually. Other extensions can add their own sources; see How to add a custom data source.
Browsing and filtering
Documents are listed per category, with a Filter by name or SKU box and a separate filter for the category tree. Long lists are paginated and the pager shows the total (Page 2 of 14 - 1,382 documents).
Adding a document by hand
Click New Document and fill in:
| Field | Description |
|---|---|
| Name | The document title. Required. |
| Body | The content. Markdown is supported. |
| Category | The category the document belongs to. |
| Identifier | A unique key for this document within the workspace. See the warning below. |
| Visibility | Currently only All. The field is reserved for future use. |
Uploading files
Upload Documents takes files by drag and drop, or by clicking to select them, and imports them when you press Import.
Allowed formats: .txt, .md, .html, .csv, .json, .yaml, .xml, .pdf, .docx.
Categories
A category has a Name, an Identifier, a Description, a Parent category, and a Visibility. Categories nest, so you can group, for example, all policy documents under one parent.
Removing a category also removes every document inside it, and every child category with all of their documents. There is no undo.
Two rules worth knowing
A synced document is matched by its identifier (product.42, cms_page.7, and so on), and the next sync overwrites whatever is stored under that identifier. If you edit a synced product or CMS document here, your edit is replaced the next time the sync runs - at 2:00 AM at the latest.
To add content that survives the sync, give it an identifier of your own that no provider uses, for example policy.warranty-eu. Editing the source in Magento is the reliable way to change a synced document.
With nothing synced, the assistant has no store-specific information to work with. The Widget tab has a Hide the chat until the knowledge base has content switch for exactly this window - see Settings.
Managing the knowledge base programmatically
Everything on this screen is also available over HTTP, which is the way to push content from a help desk, a blog, or a CI pipeline. See the REST API section.