AI enrichment: instellingen

Instellingen

AI enrichment heeft vijf tabbladen: Overzicht, Producten, Regels, Wachtrij en Instellingen (altijd als laatste). Daarnaast staat er een knop AI enrichment op het scherm van elk product.

Tabblad Instellingen

Hier staat wat voor het hele project geldt, in twee delen: Prompt en Beoordelen. Eén knop Instellingen opslaan onderaan bewaart beide.

Instelling	Wat het doet	Standaard	Wanneer aanpassen
Standaard prompttemplate	De opdracht aan de AI voor elke regel zonder eigen prompt	leeg	Altijd invullen: zonder prompt wordt er niets gegenereerd
Automatisch toepassen	Schrijft een voorstel direct in het product, zonder wachtrij. Dit is de standaard voor elke regel; een regel kan een eigen keuze hebben	uit	Pas aan als je de uitkomst van je prompt vertrouwt

Klik Instellingen opslaan om te bewaren.

Welk AI-model de teksten schrijft, kies je onder Beheer → AI; dat geldt voor het hele project. Wil je één veld vullen bij alle producten waar het leeg is, maak dan een regel met de voorwaarde “veld is leeg”.

Opgepast

Automatisch toepassen slaat de controle over. Een fout in je prompt komt dan meteen in je catalogus en via je koppelingen in je shop. In testmodus doet deze instelling niets.

De prompt schrijven

Er is bewust geen ingebouwde prompt. De prompt bepaalt de toon van je hele catalogus, en een algemene tekst die niemand koos, levert teksten op die niemand wil. Met Gebruik een starttemplate krijg je een begin:

Write the {{field_label}} for this product.
{{field_instruction}}

Product: {{name}} (SKU {{sku}})
Brand: {{brand}}
Category: {{category}}
Current value: {{current_value}}
Known attributes:
{{attributes}}

Tussen dubbele accolades staan placeholders: plekken die Nexym per product invult.

Placeholder	Wordt
{{field_label}}	De naam van het veld dat wordt ingevuld, bijvoorbeeld “Description”
{{field_instruction}}	De ingebouwde schrijfregels van dat veld (zie hieronder)
{{language}}	De taal van de regel, als die een store view als doel heeft
{{name}}	De naam van het product (in die winkel, als die een eigen naam heeft)
{{sku}}	De SKU, of anders de referentie
{{brand}}	Het merk, of unknown
{{category}}	Alle categorieën van het product, of uncategorised
{{current_value}}	Wat er nu in het veld staat, of none
{{attributes}}	De attributen met het vinkje Include in AI generation, of (none)

Omdat één template voor elk veld werkt, geeft {{field_instruction}} per veld de juiste schrijfregels mee:

Veld	Schrijfregel
omschrijving	2 tot 4 korte alinea’s platte tekst, geen koppen, geen opsommingen
naam	Een korte, specifieke producttitel van hoogstens 70 tekens
meta-titel	Een SEO-titel van hoogstens 60 tekens
meta-omschrijving	Een SEO-omschrijving van 120 tot 160 tekens
elk ander veld	Een korte, juiste waarde in platte tekst

Schrijf er in gewone taal bij hoe je klinkt, bijvoorbeeld: “Schrijf zakelijk en kort, geen uitroeptekens, noem het materiaal als dat bekend is.” Je mag de prompt in het Nederlands schrijven.

Twee dingen voegt Nexym altijd zelf toe, ook als je prompt ze niet noemt:

• De taal. Heeft de regel een store view met een taal als doel, dan staat bovenaan “Respond entirely in …” (antwoord helemaal in die taal).
• Eerdere afwijzingen. De laatste drie afgewezen voorstellen voor dit product en dit veld, met de reden, staan onderaan. De AI krijgt de opdracht ze niet te herhalen.

Tabblad Regels

Een regel zegt: “producten die aan deze voorwaarden voldoen, krijgen deze velden verrijkt”. Klik + Nieuwe regel.

Instelling	Wat het doet	Standaard	Wanneer aanpassen
Naam	Hoe de regel in de lijst heet	“Naamloze regel”	Altijd, bijvoorbeeld “Omschrijving groene thee”
Actief	Of de regel meedoet	aan	Uit om hem stil te leggen zonder te verwijderen
Voorwaarden	Welke producten. Kies of alle moeten kloppen of één hoeft te kloppen.	geen = elk product	Bijna altijd: minstens “veld is leeg”
Velden om te verrijken	Welke velden de AI mag invullen	geen	Kies één of meer
Doel → Store view	Naar welke kopie de regel schrijft	Standaard (canonieke waarde)	Kies een store view voor de tekst van één winkel
Doel → Taal	De taal waarin de AI schrijft	leeg = de taal van de store view	Als de store view geen bekende taal heeft
Automatisch toepassen	Of wat deze regel genereert zonder review in het product komt: Zoals bij Instellingen, Ja of Nee	Zoals bij Instellingen	Ja voor een regel die je vertrouwt, Nee voor een regel die je altijd wilt lezen
Eigen prompt	Een prompt alleen voor deze regel	leeg = de standaardprompt	Als deze regel echt een andere toon nodig heeft

Voorwaarden gebruiken dezelfde velden en vergelijkingen als de sync-regels, inclusief je attributen (attr.…).

Welke velden kan de AI invullen? De beschrijvende velden van een product, zoals naam, omschrijving, korte omschrijving, URL-sleutel, meta-titel en meta-omschrijving, plus eigen velden die je koppeling declareert. Niet: velden die een product identificeren of koppelen, zoals de referentie, de externe id of de categoriekoppeling. En ook geen attribuutwaarden: een import zou die bij de volgende sync weer overschrijven.

Store views. Alleen naam, omschrijving, korte omschrijving, URL, meta-titel en meta-omschrijving hebben een eigen kopie per winkel. Kies je bij Doel een store view en heb je een ander veld aangevinkt, dan wordt de regel niet opgeslagen. De melding noemt welke velden het zijn: vink ze uit, of zet Doel op Standaard. Heeft de store view geen bekende taal, vul dan Taal in. Anders weigert de regel te draaien.

Aantal controleren telt hoeveel producten de regel nu zou raken, met de voorwaarden zoals ze op het scherm staan. Je ziet twee getallen: In de catalogus van dit project en Gematcht door deze regel. Matcht er niets, dan staat er: “Niets matcht — dat is waarschijnlijk niet wat je bedoelde.”

In de lijst met regels zie je per regel de voorwaarden, de velden en het doel. Met Nu draaien start je de regel. Er verschijnt eerst een bevestiging, want een gestarte opdracht is niet terug te draaien: de AI wordt aangeroepen en dat kost geld.

Opgepast

Nu draaien raakt elk product dat aan de voorwaarden voldoet, ook als het veld al gevuld is. Een regel zonder voorwaarde “veld is leeg” herschrijft dus ook je bestaande teksten, en kost daar AI-budget voor.

Draai je een regel nog een keer terwijl er voor een product en veld al een voorstel in de wachtrij staat, dan slaat Nexym dat veld over. Er komt geen tweede voorstel en het kost geen AI-budget. In Runs & logs staat dan “er wacht al een voorstel op review”.

Recente runs

Onder de regels staat Recente runs: elke klik op Nu draaien.

Status	Betekent
Bezig — 12/38	Er zijn 12 van de 38 opdrachten klaar
Klaar — 38/38	Alles is gegenereerd
Klaar — 3 mislukt	Een deel kon niet; de reden staat in Runs & logs
Vastgelopen — niemand pakte het op	De opdrachten staan in de wachtrij maar niets verwerkt ze. Meld het bij Nexym.
Onbekend — details verlopen	De details van deze oude run zijn opgeruimd

Met Stoppen stop je een run. Opdrachten die nog niet begonnen zijn, draaien dan niet meer. Wat al gegenereerd is, blijft als voorstel in de wachtrij staan.

Tabblad Wachtrij

De Wachtrij toont elk voorstel, over alle regels en velden heen. Bovenaan staan Wacht op review en Deze maand toegepast. Filter op In wachtrij, Goedgekeurd, Afgewezen, Teruggedraaid of Alles.

Kolom	Betekent
Product	Het product, met een link naar zijn eigen scherm
Veld	Welk veld is voorgesteld
Doel	Standaard, of de store view
Voorstel	De tekst van de AI
Regel	Welke regel het maakte, of Handmatig
Status	In wachtrij, Goedgekeurd, Afgewezen of Teruggedraaid
Gegenereerd	Wanneer

• Goedkeuren schrijft de tekst in het product (alleen als de module op Aan staat).
• Afwijzen vraagt om een reden (optioneel, hoogstens 500 tekens). Klik Afwijzing bevestigen. De reden gaat mee bij de volgende poging.
• Terugdraaien staat bij een goedgekeurd voorstel. Het zet de waarde terug die het voorstel verving, en het voorstel krijgt de status Teruggedraaid. De volgende export stuurt de oude waarde naar je shop. Is het veld na het goedkeuren nog veranderd, met de hand, door een import of door een nieuwer voorstel, dan draait Nexym niets terug. Zo overschrijf je die wijziging niet per ongeluk. Terugdraaien werkt alleen als de module op Aan staat.

Een voorstel kun je niet bewerken voordat je het goedkeurt, en er is geen knop om alles tegelijk goed te keuren. Klopt een tekst bijna, wijs hem dan af met een reden, of keur hem goed en pas het veld daarna zelf aan in het product.

Een voorstel wordt maar één keer beoordeeld. Keurt een collega het al goed of wijst hij het af terwijl jij de wachtrij open hebt, dan krijg je een melding en verandert er niets. Een afgewezen voorstel kun je niet meer goedkeuren. Wil je een goedgekeurde tekst kwijt, gebruik dan Terugdraaien.

Elke keer genereren, goedkeuren, afwijzen en terugdraaien, en elke wijziging aan een regel of aan de instellingen, staat in het auditlog.

Tabblad Overzicht

Bovenaan kies je de periode: 7 dagen, 30 dagen of 90 dagen. Daaronder staan de cijfers van die periode: hoeveel voorstellen er zijn gegenereerd, goedgekeurd en afgewezen, en hoeveel er nu op beoordeling wachten (los van de periode: een achterstand van drie weken geleden is net zo onbeoordeeld). Daarna wat aandacht vraagt: nog geen regel, alle regels uit, geen werkende AI-koppeling, of voorstellen die wachten (met een knop Beoordelen naar de wachtrij). Onderaan staan de tien laatste voorstellen.

Tabblad Producten

Je catalogus afgezet tegen de velden van je actieve regels. Per product en per veld zie je leeg, ingevuld of wacht op review. Zoek op naam of SKU, of filter op categorie. Klik Openen → om een product te bekijken. Zolang er geen regel is, wordt er geen veld gevolgd.

Het scherm van één product

Via Openen →, of via de knop AI enrichment op het productscherm, zie je één product veld voor veld:

• Wat de AI ziet: het merk, de categorie en de attributen met het vinkje Include in AI generation.
• Per veld van je actieve regels de Huidige waarde en, als er een is, het Voorstel met de regel die het maakte. Keur het goed met Goedkeuren & toepassen of wijs het af.
• Genereren met AI maakt voor dit ene veld meteen een nieuw voorstel. Dit gebruikt de standaardprompt van het project en schrijft altijd de standaardwaarde, nooit de tekst van een store view. Staat er al een voorstel voor dit veld in de wachtrij, dan vervangt het nieuwe dat voorstel.
• Historie toont eerdere voorstellen met hun status en afwijsreden. Bij een goedgekeurd voorstel staat Terugdraaien.

Wie wat mag

Iedereen met toegang tot de module kan het overzicht, de wachtrij, de regels en Aantal controleren bekijken. Genereren, goedkeuren, afwijzen, terugdraaien, regels maken of wijzigen, Nu draaien, Stoppen en de instellingen aanpassen kan alleen met de rol Admin of Customer. Een Viewer of Module user ziet de knoppen niet. Zie Gebruikers en rollen.

Instellingen buiten deze module

Waar	Wat
Beheer → AI	Welk AI-model en welk account het project gebruikt
Beheer → Facturatie → Verbruik	Je AI-budget per maand, Waarschuw bij, Bij overschrijding en Mail me als het budget bereikt is
Een attribuut in je catalogus	Het vinkje Include in AI generation (standaard uit)
Operaties → Meldingen	De melding Unreviewed AI proposals