Admin-handleiding · Magento & Mage-OS

Elke Mago-instelling, scherm voor scherm

Voor wie Mago inricht in de Magento-admin. Geen servertoegang nodig. Waar elke instelling staat, wat hij doet en wat wij aanraden, met screenshots uit de Mago-demoshop.

Alleen backend-toegang nodig Je AI-provider-key Zo’n 15 minuten
laten de standaard klopt voor de meeste shops aanpassen stel dit in voor jouw shop optioneel jouw keuze

De instellingen vinden

Stores › Mago Assistant

Alles van Mago in de admin staat in een eigen blok onder Stores: Statistics, Conversations, Answer Feedback, Skills & Permissions en Configuration. De AI-provider en de key staan een niveau hoger, in de gedeelde AI-instellingen van Mage-OS.

Het Stores-menu in de Magento-admin met het blok Mago Assistant: Statistics, Conversations, Answer Feedback, Skills and Permissions, Configuration
“Use system value”. Bij de meeste velden staat dit vinkje. Haal het weg om het veld aan te passen, zet het terug voor de standaardwaarde van Mago. Klik bovenaan op Save Config als je klaar bent.

Je AI-provider en API-key toevoegen

Stores › Configuration › Mage-OS › AI Configuration › Services
  1. Klik onder Configured Services op een provider, bijvoorbeeld Anthropic of OpenAI. Er verschijnt een nieuwe rij.
  2. Plak je API Key. Na het opslaan zie je alleen nog puntjes.
  3. Kies een Model. Neem een actueel chatmodel, geen beeld-, audio- of embeddingmodel. Met ↻ ververs je de lijst.
  4. Klik op Save Config en daarna op Test Connection. Pas als die antwoord geeft, kan Mago dat ook.
  5. Optioneel: klik op het potloodje om de service een naam te geven die je team herkent, zoals “OpenAI productie”.
AI Configuration services: een OpenAI-rij met API-key, modelkeuze en de knop Test Connection, plus knoppen om andere providers toe te voegen

Grijze providers (Azure OpenAI, Gemini, DeepSeek, Ollama en andere) melden package not installed. Een developer moet die eenmalig installeren; in het vak eronder staat het precieze commando om door te sturen.

Gebruik een key alleen voor deze shop en stel een maandlimiet in op het dashboard van de provider zelf. Dan heb je een harde grens aan de kosten, wat er ook gebeurt in de admin.

Usage Tracking

zelfde pagina, onder Services
Report
optioneel
Link naar het AI Token Usage-rapport: tokens van elke module die deze AI-laag gebruikt, niet alleen Mago.
Enable Usage Tracking
laten
Yes. Nodig voor de kostencijfers in rapporten en in de Statistics van Mago.
Raw / Daily Usage Retention
laten
Hoe lang detailgegevens (30 dagen) en dagtotalen (730 dagen) bewaard blijven. Alleen zichtbaar als tracking aan staat.
Cleanup Cron Schedule
laten
Wanneer oude gebruiksregels worden opgeruimd. Standaard: dagelijks om 03:00.
Usage Tracking-instellingen met rapportlink, aan/uit, bewaartermijnen en opruimschema

Mago aanzetten en de service kiezen

Stores › Mago Assistant › Configuration › General and API Settings
Groep General met versie en Enabled op Yes
API Settings met AI Service op Automatic, Max Tokens en Enable Streaming

General

Version
info
De geïnstalleerde Mago-versie. Handig als je een probleem meldt.
Enabled
aanpassen
Yes. Na installatie staat Mago uit. Herlaad daarna de admin, dan verschijnt het Mago-icoon rechtsboven.

API Settings

AI Service per store view
laten
Automatic pakt de eerste werkende service uit AI Configuration. Kies er alleen zelf een als je er meerdere hebt, bijvoorbeeld een andere per store view.
Max Tokens
laten
Maximale lengte van één antwoord. Verhoog alleen als lange antwoorden worden afgekapt. Standaard 4096.
Enable Streaming
laten
Yes: antwoorden verschijnen terwijl Mago ze schrijft.

Taal, systeemprompt en uiterlijk

Stores › Mago Assistant › Configuration › Chat Settings
Chat Settings met Response Language op Auto-detect en een ingevulde voorbeeld-systeemprompt

Chat Settings

meestal per store view
Response Language
aanpassen
Auto-detect, zodat iedereen antwoord krijgt in de taal waarin hij schrijft. Kies alleen een vaste taal als het hele team in één taal werkt.
System Prompt
aanpassen
Gaat mee met elk gesprek. De instelling die de antwoorden het meest verbetert. Schrijf een paar regels over je shop: wat je verkoopt, je store views en talen, prijzen incl. of excl. btw, tone of voice en huisregels. Haal eerst het vinkje Use system value weg.
Answer Widgets
laten
Yes: antwoorden als cijferkaarten, grafieken en tabellen in plaats van lange lappen tekst.
Max Tool Iterations alleen default scope
laten
Hoeveel opzoekingen Mago achter elkaar mag doen voor één vraag. Met 10 lukken vergelijkingen en klussen in meerdere stappen.
Assistant Name
optioneel
Geef de assistent een andere naam, bijvoorbeeld die van je shop.
Accent Color / Text Color on Accent
optioneel
Laat het chatpaneel bij je huisstijl passen. Houd genoeg contrast tussen de twee.

Voorbeeld-systeemprompt

Wij zijn Voorbeeld Outdoor, een Nederlandse webshop voor wandel- en kampeerspullen.
Store views: NL (standaard, Nederlands) en BE-FR (Frans). Prijzen zijn inclusief btw.
Schrijf producttekst vriendelijk en praktisch, en spreek de klant aan met "je".
Beloof nooit levertijden in productteksten.
Als een verzoek per store view kan verschillen, vraag dan welke ik bedoel.

Spraakinvoer

Stores › Mago Assistant › Configuration › Voice Input
Groep Voice Input met Enabled op No
Enabled
optioneel
Zet een microfoonknop naast Send. De browser zet spraak om in tekst, dus het geluid gaat naar de maker van de browser (Google bij Chrome), niet naar Mago. Staat standaard uit. Laat elke admin Account Settings › Interface Locale op de taal zetten die hij spreekt.

Tools

Stores › Mago Assistant › Configuration › Tools
Groep Tools: Max Tool Response Tokens, Allow reindexing, Customer E-mail Interval
Max Tool Response Tokens
laten
Kort heel grote opzoekresultaten in, zodat één lange lijst het gesprek niet verdringt. Standaard 4000.
Allow reindexing
laten
No, tenzij je developer bevestigt dat de achtergrondqueue (async.operations.all) draait. Een volledige reindex kan een grote shop lang belasten.
Customer E-mail Interval
laten
Mago mailt een klant over een bestelling hooguit eens per 60 minuten, zodat een bulkverzoek geen inbox kan overspoelen. Zet dit nooit op 0 in een live shop.

Add-ons

Stores › Mago Assistant › Configuration › Add-ons
Groep Add-ons met Show new add-ons
Show new add-ons
optioneel
Toont de nieuwste Mago-add-ons in het chatpaneel. Opent een admin de chat, dan haalt Mago een openbare lijst op van askmago.com en bewaart die een week. In dat verzoek zit geen informatie over je shop. Staat standaard uit.

Antwoorden uit de officiële docs

Stores › Mago Assistant › Configuration › Documentation
Groep Documentation: documentation grounding aan, bronrepository, branch, resultaten per zoekopdracht, synchronisatieschema
Enable documentation grounding
aanpassen
Yes. Vragen als “Hoe stel ik…” worden dan beantwoord uit de officiële Magento-admindocumentatie, met een link naar de gebruikte pagina. De eerste index draait bij de volgende geplande sync; wil je niet wachten, laat een developer dan bin/magento mago:docs:index --force draaien.
Source repository / branch
laten
Waar de docs vandaan komen. Standaard: de Mage-OS-mirror van de Magento-admindocumentatie, branch main. Een developer kan in plaats daarvan een vaste commit kiezen.
Results per search
laten
Hoeveel docpagina’s Mago per vraag leest. 5 is een goede balans; meer kost meer.
Sync schedule
laten
Hoe vaak de docs worden ververst. Standaard: maandelijks.

Privacy en debug

Stores › Mago Assistant › Configuration › Privacy & Data Retention and Debug & Logging
Privacy and Data Retention: Conversation History Retention 90 dagen
Debug and Logging: Debug Mode No, Payload Retention 30 dagen
Conversation History Retention
aanpassen
Chats die ouder zijn worden elke nacht verwijderd, samen met hun antwoordfeedback en privacycodes. Stem dit af op je privacyverklaring. Standaard 90 dagen. Met 0 blijft alles voor altijd bewaard.
Debug Mode
aanpassen
No in een live shop. Met debug aan worden volledige AI-verzoeken en -antwoorden opgeslagen. Zet het alleen even aan als je een probleem uitzoekt.
Payload Retention
laten
Hoe lang die debugregels bewaard blijven. Standaard 30 dagen. Tokenstatistieken blijven staan.
Privacy mode staat altijd aan. Klantnamen, e-mailadressen, telefoonnummers, adressen en reviewteksten gaan nooit naar de AI-provider. Een verwerkersovereenkomst met je provider heb je nog steeds nodig. Zo beschermt Mago je gegevens →

KVK Lookup

Stores › Mago Assistant › Configuration › KVK Lookup (alleen met de KVK-add-on)
Groep KVK Lookup: KVK Number Attribute en Cache Lifetime
KVK Number Attribute
optioneel
De attribuutcode waarin je shop het KvK-nummer opslaat. Mago kijkt eerst naar het factuuradres van de bestelling, daarna naar de klant. Laat leeg als je het niet opslaat; vraag dan met het nummer zelf.
Cache Lifetime (days)
laten
De open data van de KVK staat één verzoek per minuut toe, dus antwoorden worden gecachet. Standaard 7 dagen.

Add-ons can add their own block here. Add-ons that call an outside service, such as the KVK and VIES lookups, need a grant on the Skills & rechten screen before an admin can look up a number they type in. Looking up the company behind an order only needs the right to view orders.

Wie mag Mago gebruiken: gebruikersrollen

System › Permissions › User Roles › een rol › Role Resources

Mago werkt als de admin die aan het chatten is. Het ziet en wijzigt alleen wat de rol van die admin elders in de admin toestaat. Zet Resource Access op Custom en vink per rol aan wat die krijgt onder Mago Assistant.

Role resources-boom met Mago Assistant: Read Operations, Write Operations, Manage Conversations, Answer Feedback, View Statistics, Skills and Permissions, Reindex All Indexers
ResourceGeeft toegang totShopmanagerTeamlid
Mago AssistantDe chat zelfJaJa
Read OperationsVragen stellen over verkoop, producten, klanten, instellingenJaJa
Write OperationsMago wijzigingen laten doen, altijd na AllowJaAls nodig
Manage ConversationsDe chats van elke admin lezen; verwijderen is een apart vinkjeJaNee
Answer FeedbackAntwoorden nalopen die het team als fout markeerdeJaNee
View StatisticsDashboard met gebruik en kostenJaNee
Skills & PermissionsRechten per gebruiker en skill bekijken en wijzigenJaNee
Reindex All IndexersMago een volledige reindex laten draaienAlleen als nodigNee
Mago Assistant ConfigurationDe configuratieschermen van Mago (onder Stores › Settings › Configuration)JaNee
Administrators met resource access “All” krijgen automatisch alles. Voor elke andere rol doen deze keuzes ertoe.

Fijnregelen per persoon: Skills & Permissions

Stores › Mago Assistant › Skills & Permissions › Edit

De lijst toont elke skill met zijn categorie en of hij leest of schrijft. Klik bij een skill op Edit om per admin-gebruiker te kiezen: Default (ACL), Read Only, Read & Write of Disabled. Default betekent dat de gebruikersrol beslist. Add-on-skills die een externe dienst aanroepen tonen Default (not granted): niemand krijgt die tot je ze hier toekent.

Gebruik het voor uitzonderingen, bijvoorbeeld een contentredacteur die Mago productteksten mag laten schrijven (content_generator) maar geen instellingen mag laten wijzigen (config_writer).

Lijst Skills and Permissions met skillnamen, omschrijvingen, categorieën en type lezen of schrijven
Edit Skill content_generator met per admin-gebruiker een keuzelijst voor het recht

Statistieken, gesprekken en feedback

Stores › Mago Assistant › Statistics / Conversations / Answer Feedback
  • Statistics: verzoeken, tokens en geschatte kosten per dag, per gebruiker en per skill. Kijk er de eerste maand wekelijks naar.
  • Conversations: elke chat, met wie hem voerde en wat hij kostte. Lees er een paar om te zien wat je team vraagt.
  • Answer Feedback: antwoorden die als niet behulpzaam zijn gemarkeerd. De snelste manier om te vinden wat er nog in de systeemprompt moet.
Mago Assistant Statistics: verzoeken, tokens, geschatte kosten, dagtrend, topgebruikers en populaire skills
Voor je team

Voorbeeldvragen, per onderwerp

Mago antwoordt in de taal waarin je schrijft. Noem de periode en de store view voor het beste antwoord. Elke wijziging toont eerst een kaart met Allow / Not now.

Verkoop & rapporten

  • Vergelijk de omzet van oktober met september
  • Top 10 producten dit kwartaal
  • Welke producten zijn het vaakst terugbetaald?

Producten & catalogus

  • Waarom is product MH03 niet zichtbaar in de shop?
  • Welke categorieën hebben geen live producten?
  • Maak een simple product aan voor…

Voorraad

  • Welke producten raken bijna op?
  • Toon dode voorraad ouder dan 90 dagen
  • Voorraad van SKU 24-WG080 per source

Bestellingen & klanten

  • Toon bestelling #100004521
  • Hoeveel nieuwe klanten hebben zich vorige maand aangemeld?
  • Wie zijn onze beste klanten?

Marketing

  • Welke kortingscodes zijn actief?
  • Maak een code van 10% voor de nieuwsbrief
  • Toon de catalog price rules

Content & SEO

  • Schrijf een productomschrijving voor de Hero Hoodie
  • Vertaal hem voor de Franse store view
  • Maak een redirect van /sale naar /outlet

Reviews

  • Welke reviews wachten op goedkeuring?
  • Keur de 5-sterrenreviews van deze week goed

Instellingen & systeem

  • Staat afrekenen als gast aan?
  • Falen er cronjobs?
  • Welke versie van de Mollie-module is geïnstalleerd?

Hoe doe ik…

  • Hoe stel ik een cart price rule in?
  • Breng me naar de verzendinstellingen
  • /cache status