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.
| Verdict↕ | Signification↕ |
|---|---|
CORRECT | L'article appartient plausiblement aux catégories assignées. |
WRONG | L'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é.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}Champs d'input
| Field↕ | Type↕ | Description↕ |
|---|---|---|
name | String! | Nom ou courte description du produit. Obligatoire. |
categories | [String!]! | Hiérarchie de catégories (racine → feuille) à valider. Obligatoire. |
amount | Decimal | Prix de l'article. |
currencyCode | CurrencyCode | Devise du montant. |
brand | String | Marque de l'article. |
description | String | Description complète associée à l'article. |
material | String | Composition matérielle de l'article. |
globalTradeItemNumber | String | Global Trade Item Number (GTIN) tel que UPC, EAN, GTIN-8 ou GTIN-14. |
imageUrl | String | Emplacement 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.
Validation de catégories
Vérifiez si les catégories assignées à chaque article le décrivent réellement.
GraphQL
La mutation
categoriesValidatevalide si les catégories fournies pour chaque article décrivent correctement l'article. Pour chaque article soumis, elle renvoie unverdictet unconfidenceScore. Lorsque le verdict estWRONG, 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.