Veredictos e confiança
Cada item na resposta carrega um verdict e um confidenceScore (0–1) que expressa a confiança do modelo nesse veredicto.
| Veredicto↕ | Significado↕ |
|---|---|
CORRECT | O item pertence de forma plausível às categorias atribuídas. |
WRONG | O item claramente não pertence às categorias atribuídas. |
Quando o veredicto é WRONG ,suggestedCategoriesé preenchido com alternativas plausíveis do universo de categorias da sua organização. Cada sugestão tem sua própria hierarquiacategory(raiz → folha) e uma pontuaçãoconfidence— a probabilidade do modelo de ser a categoria mais adequada, ordenada de forma decrescente. Quando o veredicto éCORRECT, suggestedCategories fica vazio.
Validar categorias via API
Envie um ou mais itens em uma única solicitação.name e categoriessão obrigatórios para cada item; incluir detalhes opcionais comodescription,brand,materiale amount melhora a precisão. O exemplo abaixo valida dois itens — um corretamente categorizado e outro 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! | O nome do produto ou uma descrição curta. Obrigatório. |
categories | [String!]! | A hierarquia de categorias (raiz → folha) a validar. Obrigatório. |
amount | Decimal | O preço do item. |
currencyCode | CurrencyCode | A moeda do valor. |
brand | String | A marca do item. |
description | String | A descrição completa associada ao item. |
material | String | A composição de materiais do item. |
globalTradeItemNumber | String | Um Global Trade Item Number (GTIN), como UPC, EAN, GTIN-8 ou GTIN-14. |
imageUrl | String | A localização de uma imagem relacionada ao item. |
Os campos descritivos são ecoados em cada CategoryValidation da resposta, para que cada validação armazenada seja autodescritiva.
Validação de categoria
Verifique se as categorias atribuídas a cada item realmente o descrevem.
GraphQL
A mutação
categoriesValidatevalida se as categorias fornecidas de cada item descrevem corretamente o item. Para cada item enviado, ela retorna umverdicte umconfidenceScore. Quando o veredicto éWRONG, a resposta também retorna categorias alternativas plausíveis extraídas do universo de categorias da sua organização.Use-a para detectar itens categorizados incorretamente antes que categorias erradas afetem resultados posteriores de classificação, landed cost ou restrições — e para sugerir a categoria certa a quem inseriu o item.