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.

VerdettoSignificato
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

CampoTipoDescrizione
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?