Veredictos y confianza
Cada artículo en la respuesta incluye un verdict y un confidenceScore (0–1) que expresa la confianza del modelo en ese veredicto.
| Veredicto↕ | Significado↕ |
|---|---|
CORRECT | El artículo pertenece plausiblemente a las categorías asignadas. |
WRONG | El artículo claramente no pertenece a las categorías asignadas. |
Cuando el veredicto es WRONG, suggestedCategories se rellena con alternativas plausibles del universo de categorías de su organización. Cada sugerencia tiene su propia jerarquía de category (raíz → hoja) y una puntuación de confidence: la probabilidad del modelo de que sea la categoría más adecuada, ordenada de forma descendente. Cuando el veredicto es CORRECT, suggestedCategories está vacío.
Validar categorías mediante la API
Envíe uno o más artículos en una sola solicitud. name y categories son obligatorios para cada artículo; incluir detalles opcionales como description, brand, material y amount mejora la precisión. El ejemplo siguiente valida dos artículos: uno correctamente categorizado y otro claramente mal categorizado.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}Campos de entrada
| Field↕ | Type↕ | Description↕ |
|---|---|---|
name | String! | El nombre del producto o descripción breve. Obligatorio. |
categories | [String!]! | La jerarquía de categorías (raíz → hoja) a validar. Obligatorio. |
amount | Decimal | El precio del artículo. |
currencyCode | CurrencyCode | La moneda en la que se expresa el importe. |
brand | String | La marca del artículo. |
description | String | La descripción completa asociada al artículo. |
material | String | La composición de materiales del artículo. |
globalTradeItemNumber | String | Un Global Trade Item Number (GTIN) como UPC, EAN, GTIN-8 o GTIN-14. |
imageUrl | String | La ubicación de una imagen relacionada con el artículo. |
Los campos descriptivos se devuelven en cada CategoryValidation de la respuesta, de modo que cada validación almacenada es autodescriptiva.
Validación de categorías
Compruebe si las categorías asignadas a cada artículo realmente lo describen.
GraphQL
La mutación
categoriesValidatevalida si las categorías proporcionadas de cada artículo describen correctamente el artículo. Por cada artículo que envíe, devuelve unverdicty unconfidenceScore. Cuando el veredicto esWRONG, la respuesta también devuelve categorías alternativas plausibles extraídas del universo de categorías de su organización.Úsela para detectar artículos mal categorizados antes de que las categorías incorrectas afecten los resultados posteriores de clasificación, landed cost o restricciones, y para sugerir la categoría correcta a quien haya introducido el artículo.