Kategorvalidering
Produktkategorier beskriver hva en vare er, vanligvis som et hierarki fra en bred rot til et spesifikt blad — for eksempel ["Footwear", "Athletic", "Running Shoes"]. Nøyaktige kategorier holder katalogen din ren og mater nedstrøms prosesser som klassifisering og handelssamsvar, der en feilkategorisert vare kan gi feil resultat.
Kataloger akkumulerer kategorifeil over tid — fra manuell registrering, leverandørfeeds eller migreringer mellom systemer. Zonos Kategorvalidering sjekker om kategoriene som er tildelt en vare faktisk beskriver den varen, og når de ikke gjør det, foreslår bedre kategorier hentet fra kategoriene organisasjonen din allerede bruker.
Hvordan det fungerer
Zonos Kategorvalidering bruker AI til å bedømme om kategorihierarkiet du oppgir korrekt beskriver en vare, basert på varens name og eventuelle tilleggsdetaljer du oppgir som brand, material og description.
For hver vare returnerer den en verdict på CORRECT eller WRONG sammen med en sikkerhetsscore. Når dommen er WRONG, returnerer den en rangert liste over foreslåtte kategorier slik at du kan korrigere tildelingen. Forslaginger hentes fra organisasjonens kategoritre — settet med kategoristier organisasjonen bruker — og eventuelle kategorier du sender inn legges automatisk til treet, så et godt vedlikeholdt tre produserer bedre forslaginger over tid.
Dette er et batch-endepunkt — du kan validere mange varer i en enkelt forespørsel, og resultatene returneres i samme rekkefølge som inndataene.
Dom og sikkerhet
Hvert resultat inkluderer en verdict:
CORRECT— varen tilhører plausibelt de tildelte kategoriene.WRONG— varen tilhører ikke de tildelte kategoriene.
Hvert resultat inkluderer også en confidenceScore mellom 0.0 og 1.0 som indikerer hvor sikker modellen er på dommen den returnerte. Scoren reflekterer sikkerhet i selve dommen, så et sikkert WRONG-resultat har en høy confidenceScore akkurat som et sikkert CORRECT gjør. Når dommen er WRONG, inneholder suggestedCategories-listen alternative kategorihierakier, hver med en confidence-verdi og sortert fra mest til minst sannsynlig. Når dommen er CORRECT, er suggestedCategories tom.
Vi anbefaler å bruke sikkerhetscoren til å avgjøre hvilke resultater som skal aksepteres automatisk og hvilke som skal rutes til manuell gjennomgang.
Validere kategorier
For å validere kategorier, bruk categoriesValidate-mutasjonen. Hver vare krever et name og kategorihierarkiet som skal valideres. Du kan valgfritt inkludere brand, material, description, amount, currencyCode, globalTradeItemNumber og imageUrl for å forbedre nøyaktigheten. Send inn flere varer i en enkelt forespørsel for å validere i bulk.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}I eksemplet ovenfor bekreftes den første varens kategorier som CORRECT med høy sikkerhet og ingen forslag. Den andre varen er selvsikkert flagget som WRONG, og suggestedCategories-listen foreslår bedre passende kategorier rangert etter sikkerhet.
Administrer kategoritreet ditt
Organisasjonens kategoritre er settet med kategoristier som Zonos vet at organisasjonen din bruker. Kategorvalidering henter suggestedCategories fra dette treet, så å holde det nøyaktig og komplett forbedrer direkte kvaliteten på forslagingene. Kategorier du sender til categoriesValidate legges automatisk til treet, men du kan også administrere det direkte.
Hver kategori er et hierarki lagret som en path-matrise, fra bred rot til spesifikt blad — for eksempel ["Footwear", "Athletic", "Running Shoes"].
Liste dine kategorier
Bruk categories-spørringen til å hente organisasjonens kategoritre. Resultatene er paginert.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Legg til kategorier
Bruk categoriesCreate-mutasjonen for å legge til en eller flere kategoristier i treet ditt. Dette er nyttig for å seede treet før validering slik at forslaginger kan trekke på hele taksonomiien din.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Oppdater eller fjern kategorier
Bruk categoryUpdate-mutasjonen for å korrigere en kategoris path med dens id, eller categoryDelete-mutasjonen for å fjerne en kategori som ikke lenger gjelder. Å trimme foreldede eller feilaktige kategorier holder forslag relevant.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}For å fjerne en kategori, send dens id til categoryDelete-mutasjonen. Den returnerer SUCCESS eller FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Kategorvalidering
Sjekk om en vares tildelte kategorier passer til produktet, og få bedre kategoriforslaginger når de ikke gjør det.