Kategorivalidering
Produktkategorier beskriver vad en artikel är, vanligtvis som en hierarki från en bred root till ett specifikt leaf — till exempel ["Footwear", "Athletic", "Running Shoes"]. Korrekta kategorier håller er katalog ren och matar efterföljande processer som klassificering och handelscompliance, där en felkategoriserad artikel kan ge fel resultat.
Kataloger samlar på sig kategorifel över tid — från manuell inmatning, leverantörsflöden eller migreringar mellan system. Zonos Category Validation kontrollerar om kategorierna som tilldelats en artikel faktiskt beskriver den artikeln, och när de inte gör det föreslår den bättre kategorier hämtade från de kategorier er organisation redan använder.
Så fungerar det
Zonos Category Validation använder AI för att bedöma om den kategorihierarki ni anger korrekt beskriver en artikel, baserat på artikelns name och eventuella ytterligare detaljer ni anger, såsom brand, material och description.
För varje artikel returneras en verdict med värdet CORRECT eller WRONG tillsammans med en konfidenspoäng. När verdict är WRONG returneras en rankad lista med föreslagna kategorier så att ni kan korrigera tilldelningen. Förslag hämtas från er organisations kategoriträd — den uppsättning kategorivägar er organisation använder — och alla kategorier ni skickar in läggs till i trädet automatiskt, så att ett välskött träd ger bättre förslag över tid.
Detta är en batch-endpoint — ni kan validera många artiklar i en enda begäran, och resultaten returneras i samma ordning som indata.
Verdict och konfidens
Varje resultat innehåller en verdict:
CORRECT— artikeln hör plausibelt hemma i de tilldelade kategorierna.WRONG— artikeln hör inte hemma i de tilldelade kategorierna.
Varje resultat innehåller också en confidenceScore mellan 0.0 och 1.0 som anger hur säker modellen är på den returnedade verdict. Poängen speglar säkerhet i själva verdict, så ett säkert WRONG-resultat har en hög confidenceScore precis som ett säkert CORRECT-resultat. När verdict är WRONG innehåller listan suggestedCategories alternativa kategorihierarkier, var och en med ett confidence-värde och sorterade från mest till minst sannolika. När verdict är CORRECT är suggestedCategories tom.
Vi rekommenderar att ni använder konfidenspoängen för att avgöra vilka resultat som ska accepteras automatiskt och vilka som ska skickas till manuell granskning.
Validera kategorier
För att validera kategorier använder ni mutationen categoriesValidate. Varje artikel kräver ett name och hierarkin categories som ska valideras. Ni kan valfritt inkludera brand, material, description, amount, currencyCode, globalTradeItemNumber och imageUrl för att förbättra noggrannheten. Skicka in flera artiklar i en enda begäran för att validera i bulk.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}I exemplet ovan bekräftas den första artikelns kategorier som CORRECT med hög konfidens och utan förslag. Den andra artikeln flaggas säkert som WRONG, och listan suggestedCategories föreslår bättre passande kategorier rankade efter konfidens.
Hantera ert kategoriträd
Er organisations kategoriträd är den uppsättning kategorivägar Zonos vet att er organisation använder. Category Validation hämtar sina suggestedCategories från detta träd, så att hålla det korrekt och komplett förbättrar direkt kvaliteten på förslagen. Kategorier ni skickar in till categoriesValidate läggs till i trädet automatiskt, men ni kan också hantera det direkt.
Varje kategori är en hierarki lagrad som en path-array, från bred root till specifikt leaf — till exempel ["Footwear", "Athletic", "Running Shoes"].
Lista era kategorier
Använd frågan categories för att hämta er organisations kategoriträd. Resultaten är paginerade.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Lägg till kategorier
Använd mutationen categoriesCreate för att lägga till en eller flera kategorivägar i ert träd. Det är användbart för att så trädet före validering så att förslag kan dra nytta av er fulla taxonomi.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Uppdatera eller ta bort kategorier
Använd mutationen categoryUpdate för att korrigera en kategoris path via dess id, eller mutationen categoryDelete för att ta bort en kategori som inte längre gäller. Att rensa bort föråldrade eller felaktiga kategorier håller förslagen relevanta.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}För att ta bort en kategori skickar ni dess id till mutationen categoryDelete. Den returnerar SUCCESS eller FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Kategorivalidering
Kontrollera om artiklarnas tilldelade kategorier passar produkten, och få bättre kategoriförslag när de inte gör det.