Kategorivalidering
Produktkategorier beskriver, hvad en vare er, typisk som et hierarki fra en bred rod til et specifikt blad — f.eks. ["Footwear", "Athletic", "Running Shoes"]. Nøjagtige kategorier holder dit katalog rent og understøtter downstream-processer som klassificering og trade compliance, hvor en fejlkategoriseret vare kan give det forkerte resultat.
Kataloger akkumulerer kategorifejl over tid — fra manuel indtastning, leverandørfeeds eller migrationer mellem systemer. Zonos Category Validation tjekker, om de kategorier, der er tildelt en vare, faktisk beskriver den, og når de ikke gør, foreslår den bedre kategorier hentet fra de kategorier, din organisation allerede bruger.
Sådan fungerer det
Zonos Category Validation bruger AI til at vurdere, om det kategorihierarki, du angiver, korrekt beskriver en vare, baseret på varens name og eventuelle yderligere detaljer, du angiver, såsom brand, material og description.
For hver vare returnerer den en verdict på CORRECT eller WRONG sammen med en confidence score. Når kendelsen er WRONG, returnerer den en rangeret liste over foreslåede kategorier, så du kan rette tildelingen. Forslag hentes fra din organisations kategoritræ — mængden af kategoristier, din organisation bruger — og alle kategorier, du indsender, tilføjes automatisk til det træ, så et velvedligeholdt træ giver bedre forslag over tid.
Dette er et batch-endpoint — du kan validere mange varer i en enkelt anmodning, og resultaterne returneres i samme rækkefølge som input.
Kendelse og confidence
Hvert resultat inkluderer en verdict:
CORRECT— varen hører plausibelt til i de tildelte kategorier.WRONG— varen hører ikke til i de tildelte kategorier.
Hvert resultat inkluderer også en confidenceScore mellem 0.0 og 1.0, der angiver, hvor sikker modellen er på den returnerede kendelse. Scoren afspejler sikkerheden i selve kendelsen, så et sikkert WRONG-resultat har en høj confidenceScore ligesom et sikkert CORRECT-resultat. Når kendelsen er WRONG, indeholder suggestedCategories-listen alternative kategorihierarkier, hver med en confidence-værdi og sorteret fra mest til mindst sandsynlig. Når kendelsen er CORRECT, er suggestedCategories tom.
Vi anbefaler at bruge confidence score til at afgøre, hvilke resultater der accepteres automatisk, og hvilke der sendes til manuel gennemgang.
Valider kategorier
For at validere kategorier skal du bruge categoriesValidate-mutationen. Hver vare kræver et name og det categories-hierarki, der skal valideres. Du kan valgfrit inkludere brand, material, description, amount, currencyCode, globalTradeItemNumber og imageUrl for at forbedre nøjagtigheden. Indsend flere varer i en enkelt anmodning for at validere i bulk.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}I eksemplet ovenfor bekræftes den første vares kategorier som CORRECT med høj confidence og uden forslag. Den anden vare markeres sikkert som WRONG, og suggestedCategories-listen foreslår bedre passende kategorier rangeret efter confidence.
Administrer dit kategoritræ
Din organisations kategoritræ er mængden af kategoristier, Zonos ved, at din organisation bruger. Category Validation henter sine suggestedCategories fra dette træ, så at holde det nøjagtigt og komplet forbedrer direkte kvaliteten af forslag. Kategorier, du indsender til categoriesValidate, tilføjes automatisk til træet, men du kan også administrere det direkte.
Hver kategori er et hierarki gemt som et path-array, fra bred rod til specifikt blad — f.eks. ["Footwear", "Athletic", "Running Shoes"].
List dine kategorier
Brug categories-forespørgslen til at hente din organisations kategoritræ. Resultater er paginerede.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Tilføj kategorier
Brug categoriesCreate-mutationen til at tilføje en eller flere kategoristier til dit træ. Dette er nyttigt til at seede træet før validering, så forslag kan trække på din fulde taksonomi.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Opdater eller fjern kategorier
Brug categoryUpdate-mutationen til at rette en kategoris path via dens id, eller categoryDelete-mutationen til at fjerne en kategori, der ikke længere gælder. At fjerne forældede eller forkerte kategorier holder forslag relevante.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}For at fjerne en kategori skal du angive dens id til categoryDelete-mutationen. Den returnerer SUCCESS eller FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Category Validation
Tjek om de kategorier, der er tildelt en vare, passer til produktet, og få bedre kategoriforslag, når de ikke gør.