DOCS

Category Validation

Controleer of de toegewezen categorieën van een item bij het product passen, en ontvang betere categoriesuggesties wanneer dat niet het geval is.

Categorievalidatie 

Productcategorieën beschrijven wat een item is, meestal als een hiërarchie van een brede hoofdcategorie naar een specifieke subcategorie — bijvoorbeeld ["Footwear", "Athletic", "Running Shoes"]. Nauwkeurige categorieën houden uw catalogus schoon en voeden downstreamprocessen zoals classificatie en handelscompliance, waarbij een verkeerd gecategoriseerd item een onjuist resultaat kan opleveren.

Catalogi verzamelen in de loop van de tijd categoriefouten — door handmatige invoer, leveranciersfeeds of migraties tussen systemen. Zonos Category Validation controleert of de categorieën die aan een item zijn toegewezen dat item daadwerkelijk beschrijven, en stelt, wanneer dat niet zo is, betere categorieën voor op basis van de categorieën die uw organisatie al gebruikt.

Hoe het werkt 

Zonos Category Validation gebruikt AI om te beoordelen of de categoriehiërarchie die u opgeeft een item correct beschrijft, op basis van de name van het item en eventuele extra details die u opgeeft, zoals brand, material en description.

Voor elk item retourneert het een verdict van CORRECT of WRONG, samen met een betrouwbaarheidsscore. Wanneer het oordeel WRONG is, retourneert het een gerangschikte lijst met voorgestelde categorieën, zodat u de toewijzing kunt corrigeren. Suggesties komen uit de categorieboom van uw organisatie — de verzameling categoriepaden die uw organisatie gebruikt — en elke categorie die u indient, wordt automatisch aan die boom toegevoegd, zodat een goed onderhouden boom na verloop van tijd betere suggesties oplevert.

Dit is een batch-endpoint — u kunt veel items in één verzoek valideren, en de resultaten worden in dezelfde volgorde als de invoer geretourneerd.

Oordeel en betrouwbaarheid 

Elk resultaat bevat een verdict:

  • CORRECT — het item behoort waarschijnlijk tot de toegewezen categorieën.
  • WRONG — het item behoort niet tot de toegewezen categorieën.

Elk resultaat bevat ook een confidenceScore tussen 0.0 en 1.0, die aangeeft hoe zeker het model is van het geretourneerde oordeel. De score weerspiegelt de zekerheid van het oordeel zelf, dus een overtuigend WRONG-resultaat heeft een even hoge confidenceScore als een overtuigend CORRECT-resultaat. Wanneer het oordeel WRONG is, bevat de lijst suggestedCategories alternatieve categoriehiërarchieën, elk met een confidence-waarde en gesorteerd van meest naar minst waarschijnlijk. Wanneer het oordeel CORRECT is, is suggestedCategories leeg.

We raden aan de betrouwbaarheidsscore te gebruiken om te bepalen welke resultaten automatisch worden geaccepteerd en welke naar handmatige controle worden doorgestuurd.

Categorieën valideren 

Gebruik de categoriesValidate-mutatie om categorieën te valideren. Elk item vereist een name en de categories-hiërarchie die moet worden gevalideerd. U kunt optioneel brand, material, description, amount, currencyCode, globalTradeItemNumber en imageUrl opgeven om de nauwkeurigheid te verbeteren. Dien meerdere items in binnen één verzoek om in bulk te valideren.

1mutation CategoriesValidate($input: [CategoryValidateInput!]!) {
2 categoriesValidate(input: $input) {
3 id
4 name
5 categories
6 verdict
7 confidenceScore
8 suggestedCategories {
9 category
10 confidence
11 }
12 }
13}

In het bovenstaande voorbeeld worden de categorieën van het eerste item bevestigd als CORRECT, met hoge betrouwbaarheid en zonder suggesties. Het tweede item wordt met hoge zekerheid gemarkeerd als WRONG, en de lijst suggestedCategories stelt beter passende categorieën voor, gerangschikt op betrouwbaarheid.

Uw categorieboom beheren 

De categorieboom van uw organisatie is de verzameling categoriepaden waarvan Zonos weet dat uw organisatie ze gebruikt. Category Validation haalt zijn suggestedCategories uit deze boom, dus door deze nauwkeurig en volledig te houden, verbetert u direct de kwaliteit van de suggesties. Categorieën die u indient bij categoriesValidate worden automatisch aan de boom toegevoegd, maar u kunt de boom ook rechtstreeks beheren.

Elke categorie is een hiërarchie die wordt opgeslagen als een path-array, van brede hoofdcategorie naar specifieke subcategorie — bijvoorbeeld ["Footwear", "Athletic", "Running Shoes"].

Uw categorieën weergeven

Gebruik de categories-query om de categorieboom van uw organisatie op te halen. De resultaten worden gepagineerd.

1query Categories {
2 categories(first: 50) {
3 totalCount
4 edges {
5 node {
6 id
7 path
8 }
9 }
10 }
11}

Categorieën toevoegen

Gebruik de categoriesCreate-mutatie om een of meer categoriepaden aan uw boom toe te voegen. Dit is nuttig om de boom te vullen voordat u valideert, zodat suggesties gebruik kunnen maken van uw volledige taxonomie.

1mutation CategoriesCreate($input: [CategoryCreateInput!]!) {
2 categoriesCreate(input: $input) {
3 id
4 path
5 }
6}

Categorieën bijwerken of verwijderen

Gebruik de categoryUpdate-mutatie om het path van een categorie te corrigeren aan de hand van de id, of de categoryDelete-mutatie om een categorie te verwijderen die niet meer van toepassing is. Door verouderde of onjuiste categorieën te verwijderen, blijven de suggesties relevant.

1mutation CategoryUpdate($input: CategoryUpdateInput!) {
2 categoryUpdate(input: $input) {
3 id
4 path
5 }
6}

Om een categorie te verwijderen, geeft u de id door aan de categoryDelete-mutatie. Deze retourneert SUCCESS of FAILURE.

1mutation CategoryDelete($id: ID!) {
2 categoryDelete(id: $id)
3}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Boek een demo

Was deze pagina nuttig?