Verifique se as categorias atribuídas a cada item realmente o descrevem.
GraphQL
A mutação categoriesValidate valida se as categorias fornecidas de cada item descrevem corretamente o item. Para cada item enviado, ela retorna um verdict e um confidenceScore. 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.
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 hierarquia category (raiz → folha) e uma pontuação confidence — a probabilidade do modelo de ser a categoria mais adequada, ordenada de forma decrescente. Quando o veredicto é CORRECT, suggestedCategories fica vazio.
Envie um ou mais itens em uma única solicitação. name e categories são obrigatórios para cada item; incluir detalhes opcionais como description, brand, material e amount melhora a precisão. O exemplo abaixo valida dois itens — um corretamente categorizado e outro claramente mal categorizado.
Validação de categoria
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.
Veredictos e confiança
Cada item na resposta carrega um
verdicte umconfidenceScore(0–1) que expressa a confiança do modelo nesse veredicto.CORRECTWRONGQuando 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,suggestedCategoriesfica vazio.Validar categorias via API
Envie um ou mais itens em uma única solicitação.
nameecategoriessão obrigatórios para cada item; incluir detalhes opcionais comodescription,brand,materialeamountmelhora a precisão. O exemplo abaixo valida dois itens — um corretamente categorizado e outro claramente mal categorizado.mutation CategoriesValidate($input: [CategoryValidateInput!]!) {categoriesValidate(input: $input) {idnamecategoriesverdictconfidenceScoresuggestedCategories {categoryconfidence}}}Campos de entrada
nameString!categories[String!]!amountDecimalcurrencyCodeCurrencyCodebrandStringdescriptionStringmaterialStringglobalTradeItemNumberStringimageUrlStringOs campos descritivos são ecoados em cada
CategoryValidationda resposta, para que cada validação armazenada seja autodescritiva.CategoryValidateInput
categoriesValidate
Esta página foi útil?