DOCS

Convalida della categoria

Verifica se le categorie assegnate a ciascun elemento lo descrivono effettivamente.

GraphQL

La mutazione categoriesValidate verifica se le categorie fornite per ciascun elemento lo descrivono correttamente. Per ogni elemento inviato, restituisce un verdict e un confidenceScore. Quando il verdetto è WRONG, la risposta restituisce anche categorie alternative plausibili tratte dall'universo delle categorie della tua organizzazione.

Usalo per individuare gli elementi categorizzati in modo errato prima che categorie non corrette influiscano sui risultati a valle di classificazione, landed cost o restrizione, e per suggerire la categoria corretta a chiunque abbia inserito l'elemento.

Verdetti e livello di confidenza 

Ogni elemento della risposta include un verdict e un confidenceScore (0–1) che esprime il livello di confidenza del modello in tale verdetto.

Verdetto↕Significato↕
CORRECTÈ plausibile che l'elemento appartenga alle categorie assegnate.
WRONGL'elemento chiaramente non appartiene alle categorie assegnate.

Quando il verdetto è WRONG, suggestedCategories viene popolato con alternative plausibili tratte dall'universo delle categorie della tua organizzazione. Ogni suggerimento include una propria gerarchia category (radice → foglia) e un punteggio confidence, ovvero la probabilità stimata dal modello che si tratti della categoria più adatta, in ordine decrescente. Quando il verdetto è CORRECT, suggestedCategories è vuoto.

Convalida le categorie tramite API 

Invia uno o più elementi in un'unica richiesta. name e categories sono obbligatori per ogni elemento; includere dettagli facoltativi come description, brand, material e amount migliora l'accuratezza. L'esempio seguente convalida due elementi: uno categorizzato correttamente e uno chiaramente categorizzato in modo errato.

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}

Campi di input

Campo↕Tipo↕Descrizione↕
nameString!Il nome del prodotto o una breve descrizione. Obbligatorio.
categories[String!]!La gerarchia delle categorie (radice → foglia) da convalidare. Obbligatorio.
amountDecimalIl prezzo dell'elemento.
currencyCodeCurrencyCodeLa valuta in cui è espresso l'importo.
brandStringIl marchio dell'elemento.
descriptionStringLa descrizione completa associata all'elemento.
materialStringLa composizione del materiale dell'elemento.
globalTradeItemNumberStringUn Global Trade Item Number (GTIN), ad esempio UPC, EAN, GTIN-8 o GTIN-14.
imageUrlStringLa posizione di un'immagine relativa all'elemento.

I campi descrittivi vengono restituiti in ogni CategoryValidation della risposta, quindi ogni convalida memorizzata è autodescrittiva.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

Questa pagina è stata utile?