AI-ecommerce-automatisering met reviewpoorten

Updated 2026-09-05

Maak van productwijzigingen traceerbare draftjobs. Houd generatie, validatie, goedkeuring en store-updates afzonderlijk zodat een mislukte run begrijpelijk en hervatbaar is.

Automatiseer de overdracht en niet alleen de prompt

Een herhaalbare contentworkflow moet beantwoorden welk product veranderde, welke bronrevisie werd gebruikt, welk werk resteert en wie mag publiceren. Een geplande prompt met CSV-bijlage kan die vragen niet zelfstandig beantwoorden. Behandel de prompt als één stap in een job waarvan de status buiten de conversatie wordt opgeslagen.

Begin met exporteerbare content en een offline reviewqueue. Geef elke job een duurzaam record en een expliciete volgende actie. Houd live productupdates uitgeschakeld tot de doeladapter en goedkeuringscontroles in een gecontroleerde store zijn getest. Zo kun je generatie en review bouwen voordat je publicatiemachtigingen toevoegt.

Workflow voor cataloguslokalisatie: bronfeiten over het product verzamelen, terminologie vastleggen, vertalen, beschermde velden valideren en een import goedkeuren.
Illustratie van de workflow. Validatie en goedkeuring gaan vooraf aan publicatie in een winkel.

Geef elke job een stabiele identiteit

Gebruik bronrevisie, productidentifier, locale, glossaryrevisie en promptrevisie om het bedoelde werk te identificeren. Een retry van dezelfde job mag geen niet-gerelateerde kandidaat maken of dezelfde import tweemaal toepassen. Een wijziging in bron of regels moet nieuw werk creëren met een zichtbare relatie tot de oudere kandidaat.

Gebruik geen rijnummer als jobkey: sorteren van een export wijzigt rijposities. Houd prijzen en eenheden in de bron-snapshot, maar laat gegenereerde output alleen toe voor goedgekeurde tekstvelden. Het volgende record is een illustratief applicatiecontract om aan te passen voor je jobstore.

{
  "productId": "SYNTHETIC-CATALOG-A",
  "locale": "de",
  "sourceRevision": "source-revision-required",
  "glossaryRevision": "glossary-revision-required",
  "promptRevision": "prompt-revision-required",
  "state": "queued",
  "approval": null,
  "importReceipt": null
}

Bewaar observeerbare statusovergangen

Sla kandidaatoutput op vóór je naar validatie gaat. Sla validatie-issues op vóór je een reviewer toewijst. Koppel goedkeuring aan de exacte kandidaat en bronrevisies. De publisher moet records weigeren waarvan de content na goedkeuring is veranderd, ook als een eerdere versie werd geaccepteerd.

Gebruik een hold-status voor ambigue uitkomsten. Een verbindingsverlies tijdens een import bewijst bijvoorbeeld niet dat de store de write heeft afgewezen. Lees de actuele opgeslagen velden terug vóór je opnieuw probeert. Implementeer de voorgestelde statussen hieronder in je orchestratielaag, met overgangscontroles naast de bewerking die elk resultaat opslaat.

OvergangVereist bewijsWanneer vasthouden
Queued naar draftedOpgeslagen kandidaat en requestidentiteitOntbrekende of incomplete output
Drafted naar reviewableGestructureerde veldcontrolesDrift in beschermde velden
Reviewable naar approvedReviewer en kandidaat­revisieOnopgelost feitelijk probleem
Approved naar importedGeautoriseerde patch en store receiptVerouderde bron of onzekere write
Imported naar verifiedVergelijking van opgeslagen veldenOnverwacht veldverschil

Scheid de modelclient van de storeadapter

Geef de drafting worker alleen de goedgekeurde bronsubset en modelcredentials. Plaats storecredentials in een afzonderlijke adapter met een smalle bewerking, zoals een beschrijvingspatch voorbereiden. Een geslaagd AI-request mag niet als neveneffect een product publiceren.

Shopify's gedocumenteerde vertaalpad gebruikt resourcespecifieke content en digests; WooCommerce documenteert een product-CSV-importer. Geef elke interface een eigen mapper en verificatiestap. Configureer modelcredentials in de draftingclient en houd bronreads en geautoriseerde storewrites in de doeladapter. Test deze grenzen onafhankelijk voordat je de flow samenvoegt.

Begrens retries en isoleer slechte records

Probeer tijdelijke transportfouten opnieuw met een eindig beleid en geregistreerde pogingen. Een structureel ongeldige response herhalen zonder de oorzaak te veranderen kan zowel usage als reviewtijd verspillen. Houd foutcategorieën afzonderlijk: authenticatie, onbeschikbaar model, incomplete generatie, ongeldige velden en afgewezen content vragen verschillende interventies.

Laat geslaagde records beschikbaar terwijl je mislukte records vasthoudt. Bewaar alle pogingen voor het getroffen product, inclusief kandidaten die validatie niet haalden. Een workerrestart moet hervatten vanuit persistente status en niet de hele catalogus opnieuw genereren. Test ook annulering: het stoppen van generatie mag geen importproces ongemerkt laten doorlopen.

Meet geaccepteerd werk en de volledige kost

Koppel usagerecords aan job en poging, inclusief mislukte requests wanneer factureringsbewijs bestaat. Houd draft-, review- en revisiecalls afzonderlijk bij. Bewaar ontbrekende usage als onbekend; een ontbrekende receipt is geen gratis request. Houd editortijd gescheiden van de API-ledger in plaats van onvergelijkbare metingen in één getal te mengen.

Definieer geaccepteerd werk via je releasecriteria, zoals een goedgekeurde product-locale-revisie. Deel geregistreerde kosten alleen door geaccepteerd werk wanneer de noemer niet nul is en de sample duidelijk is afgebakend. Gebruik actuele factureringsinformatie van provider of gateway en bewaar datum en factureringsbron bij het rapport.

Reconcile imports en bereid herstel voor

Maak een importvoorstel met alleen goedgekeurde wijzigingen en sla de eerdere waarden van die velden op. Vergelijk de bronrevisie opnieuw direct vóór een geautoriseerde write. Als een andere editor het product heeft gewijzigd, pauzeer dan en vraag om nieuwe review in plaats van diens werk te overschrijven.

Lees na import de bedoelde velden terug en classificeer mismatches per product en locale. Een reversal mag alleen wijzigingen van deze batch herstellen wanneer de store nog overeenkomt met de geïmporteerde revisie; anders is conflictreview nodig. Houd importmachtigingen gescheiden van de machtiging om tekst te genereren.

Verifieer een kleine flow waarin fouten voorkomen

Gebruik synthetische producten om één geaccepteerde kandidaat, één schending van een beschermd veld en één conflict door gewijzigde bron te testen. Herstart de worker tussen draft en goedkeuring. Controleer dat goedgekeurd werk behouden blijft en dat vastgehouden werk niet in een importvoorstel kan komen. Deze controles oefenen het statuscontract directer uit dan herhaaldelijk promptformuleringen testen.

Test daarna de adapter in een staging-store met expliciete toestemming. Bewaar source-snapshot, gegenereerde revisie, goedkeuring, importreceipt en read-backvergelijking. Een lokale jobsimulatie stelt alleen orchestrationgedrag vast; zij bewijst geen modelkwaliteit of geslaagde store-integratie.

Veelgestelde vragen

Kan de workflow volgens een schema draaien?

Ja, als ontwerpkeuze zodra jobs revisiebewust en persistent zijn. Scheduling moet eligible werk in de wachtrij zetten; het mag validatie niet omzeilen of automatisch publicatierecht geven.

Wat gebeurt er als de bron tijdens review verandert?

Markeer de kandidaat als verouderd en vergelijk de gewijzigde velden. Vereis goedkeuring tegen de nieuwe bronrevisie voordat je een import voorbereidt.

Moeten mislukte rijen de hele catalogus stoppen?

Niet noodzakelijk. Houd getroffen records vast terwijl je geslaagde drafts bewaart, maar blokkeer de batch wanneer een gedeelde fout, zoals een onjuiste glossary, alle records kan raken.

Hoe probeer ik onzekere storewrites opnieuw?

Lees eerst de doelvelden terug. Reconcileer wat er is gebeurd en probeer alleen de openstaande goedgekeurde patch opnieuw, in plaats van aan te nemen dat een timeout geen write betekende.

Welke componenten moet ik eerst implementeren?

Begin met source-snapshots, persistente jobs en de reviewqueue. Voeg daarna de modelclient toe en implementeer en test de doeladapter vóór je geautoriseerde imports inschakelt.