DOCS

Validation de catégories

Validation de catégories

Vérifiez si les catégories assignées à chaque article le décrivent réellement.

GraphQL

La mutation categoriesValidate valide si les catégories fournies pour chaque article décrivent correctement l'article. Pour chaque article soumis, elle renvoie un verdict et un confidenceScore. Lorsque le verdict est WRONG, la réponse renvoie aussi des catégories alternatives plausibles tirées de l'univers de catégories de votre organisation.

Utilisez-la pour détecter les articles mal catégorisés avant que des catégories incorrectes n'affectent les résultats en aval de classification, coût rendu ou restrictions — et pour suggérer la bonne catégorie à la personne qui a saisi l'article.

Verdicts et confiance 

Chaque article de la réponse porte un verdict et un confidenceScore (0–1) exprimant la confiance du modèle dans ce verdict.

VerdictSignification
CORRECTL'article appartient plausiblement aux catégories assignées.
WRONGL'article n'appartient clairement pas aux catégories assignées.

Lorsque le verdict est WRONG, suggestedCategories est renseigné avec des alternatives plausibles de l'univers de catégories de votre organisation. Chaque suggestion possède sa propre hiérarchie category (racine → feuille) et un score confidence — la probabilité du modèle qu'il s'agisse de la catégorie la mieux adaptée, triée par ordre décroissant. Lorsque le verdict est CORRECT, suggestedCategories est vide.

Valider les catégories via l'API 

Soumettez un ou plusieurs articles en une seule requête. name et categories sont obligatoires pour chaque article ; inclure des détails optionnels comme description, brand, material et amount améliore la précision. L'exemple ci-dessous valide deux articles — l'un correctement catégorisé et l'autre clairement mal catégorisé.

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}

Champs d'input

FieldTypeDescription
nameString!Nom ou courte description du produit. Obligatoire.
categories[String!]!Hiérarchie de catégories (racine → feuille) à valider. Obligatoire.
amountDecimalPrix de l'article.
currencyCodeCurrencyCodeDevise du montant.
brandStringMarque de l'article.
descriptionStringDescription complète associée à l'article.
materialStringComposition matérielle de l'article.
globalTradeItemNumberStringGlobal Trade Item Number (GTIN) tel que UPC, EAN, GTIN-8 ou GTIN-14.
imageUrlStringEmplacement d'une image liée à l'article.

Les champs descriptifs sont renvoyés sur chaque CategoryValidation dans la réponse, chaque validation stockée est donc auto-descriptive.

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

Cette page a-t-elle été utile?