Validation de catégories
Les catégories produit décrivent ce qu'est un article, généralement sous forme de hiérarchie d'une racine large à une feuille spécifique — par exemple, ["Footwear", "Athletic", "Running Shoes"]. Des catégories précises maintiennent votre catalogue propre et alimentent les processus en aval tels que la classification et la conformité commerciale, où un article mal catégorisé peut produire un mauvais résultat.
Les catalogues accumulent des erreurs de catégorisation au fil du temps — saisie manuelle, flux fournisseurs ou migrations entre systèmes. Zonos Category Validation vérifie si les catégories assignées à un article décrivent réellement cet article, et lorsqu'elles ne le font pas, suggère de meilleures catégories tirées de celles que votre organisation utilise déjà.
Fonctionnement
Zonos Category Validation utilise l'IA pour juger si la hiérarchie de catégories que vous fournissez décrit correctement un article, sur la base du name de l'article et de tout détail supplémentaire que vous fournissez, comme brand, material et description.
Pour chaque article, il renvoie un verdict de CORRECT ou WRONG ainsi qu'un score de confiance. Lorsque le verdict est WRONG, il renvoie une liste classée de catégories suggérées pour corriger l'assignation. Les suggestions proviennent de l'arborescence de catégories de votre organisation — l'ensemble des chemins de catégories que votre organisation utilise — et toute catégorie que vous soumettez est ajoutée automatiquement à cette arborescence, de sorte qu'une arborescence bien entretenue produit de meilleures suggestions au fil du temps.
Il s'agit d'un endpoint batch — vous pouvez valider de nombreux articles en une seule requête, et les résultats sont renvoyés dans le même ordre que l'input.
Verdict et confiance
Chaque résultat inclut un verdict :
CORRECT— l'article appartient plausiblement aux catégories assignées.WRONG— l'article n'appartient pas aux catégories assignées.
Chaque résultat inclut aussi un confidenceScore entre 0.0 et 1.0 indiquant la confiance du modèle dans le verdict renvoyé. Le score reflète la certitude du verdict lui-même : un résultat WRONG avec une confiance élevée a donc un confidenceScore élevé, tout comme un résultat CORRECT avec une confiance élevée en a un. Lorsque le verdict est WRONG, la liste suggestedCategories contient des hiérarchies de catégories alternatives, chacune avec une valeur confidence et triées de la plus à la moins probable. Lorsque le verdict est CORRECT, suggestedCategories est vide.
Nous recommandons d'utiliser le score de confiance pour décider quels résultats accepter automatiquement et lesquels orienter vers une revue manuelle.
Valider les catégories
Pour valider des catégories, utilisez la mutation categoriesValidate. Chaque article requiert un name et la hiérarchie categories à valider. Vous pouvez inclure optionnellement brand, material, description, amount, currencyCode, globalTradeItemNumber et imageUrl pour améliorer la précision. Soumettez plusieurs articles en une seule requête pour valider en lot.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}Dans l'exemple ci-dessus, les catégories du premier article sont confirmées comme CORRECT avec une confiance élevée et sans suggestions. Le second article est signalé avec confiance comme WRONG, et la liste suggestedCategories propose des catégories mieux adaptées, classées par confiance.
Gérer votre arborescence de catégories
L'arborescence de catégories de votre organisation est l'ensemble des chemins de catégories dont Zonos sait qu'ils sont utilisés par votre organisation. Category Validation tire ses suggestedCategories de cette arborescence ; la maintenir précise et complète améliore donc directement la qualité des suggestions. Les catégories que vous soumettez à categoriesValidate sont ajoutées automatiquement à l'arborescence, mais vous pouvez aussi la gérer directement.
Chaque catégorie est une hiérarchie stockée sous forme de tableau path, de la racine large à la feuille spécifique — par exemple, ["Footwear", "Athletic", "Running Shoes"].
Lister vos catégories
Utilisez la query categories pour récupérer l'arborescence de catégories de votre organisation. Les résultats sont paginés.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Ajouter des catégories
Utilisez la mutation categoriesCreate pour ajouter un ou plusieurs chemins de catégories à votre arborescence. Utile pour initialiser l'arborescence avant la validation afin que les suggestions puissent s'appuyer sur votre taxonomie complète.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Mettre à jour ou supprimer des catégories
Utilisez la mutation categoryUpdate pour corriger le path d'une catégorie par son id, ou la mutation categoryDelete pour supprimer une catégorie qui ne s'applique plus. Élaguer les catégories obsolètes ou incorrectes maintient la pertinence des suggestions.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}Pour supprimer une catégorie, passez son id à la mutation categoryDelete. Elle renvoie SUCCESS ou FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Category Validation
Vérifiez si les catégories assignées à un article correspondent au produit, et obtenez de meilleures suggestions de catégories lorsqu'elles ne correspondent pas.