Validação de categoria
As categorias de produtos descrevem o que é um item, geralmente como uma hierarquia de uma raiz ampla até uma folha específica – por exemplo, ["Footwear", "Athletic", "Running Shoes"]. Categorias precisas mantêm seu catálogo limpo e alimentam processos posteriores, como classificação e conformidade comercial, onde um item categorizado incorretamente pode produzir o resultado errado.
Catalogs acumulam erros de categoria ao longo do tempo — desde entrada manual, feeds de fornecedores ou migrações entre sistemas. Zonos A Validação de Categoria verifica se as categorias atribuídas a um item realmente descrevem esse item e, quando não o fazem, sugere categorias melhores extraídas das categorias que sua organização já utiliza.
Como funciona
Zonos A validação de categoria usa IA para julgar se a hierarquia de categoria que você fornece descreve corretamente um item, com base no item name e quaisquer detalhes adicionais que você fornecer, como brand,material, e description.
Para cada item ele retorna um verdict de CORRECTouWRONGjunto com uma pontuação de confiança. Quando o veredicto for WRONG, ele retornará uma lista classificada de categorias sugeridas para que você possa corrigir a atribuição. As sugestões são extraídas da árvore de categorias da sua organização — o conjunto de caminhos de categorias que sua organização usa — e quaisquer categorias enviadas são adicionadas a essa árvore automaticamente, de modo que uma árvore bem mantida produz sugestões melhores ao longo do tempo.
Este é um endpoint em lote – você pode validar muitos itens em uma única solicitação e os resultados são retornados na mesma ordem da entrada.
Veredicto e confiança
Cada resultado inclui um verdict:
CORRECT— o item pertence plausivelmente às categorias atribuídas.WRONG— o item não pertence às categorias atribuídas.
Cada resultado também inclui um confidenceScore entre 0.0e1.0indicando o quão confiante o modelo está no veredicto que retornou. A pontuação reflete certeza no próprio veredicto, portanto, umWRONGresultado tem um altoconfidenceScoretão confiantementeCORRECTum faz. Quando o veredicto forWRONG, osuggestedCategorieslista contém hierarquias de categorias alternativas, cada uma com umconfidencevalor e classificados do mais para o menos provável. Quando o veredicto forCORRECT, suggestedCategories está vazio.
Recomendamos usar a pontuação de confiança para decidir quais resultados serão aceitos automaticamente e quais serão encaminhados para revisão manual.
Validar categorias
Para validar categorias, use o categoriesValidate mutação. Cada item requer um namee ocategorieshierarquia para validar. Você pode opcionalmente incluirbrand,material,description,amount,currencyCode,globalTradeItemNumber, e imageUrl para melhorar a precisão. Envie vários itens em uma única solicitação para validar em massa.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}No exemplo acima, as categorias do primeiro item são confirmadas como CORRECT com alta confiança e sem sugestões. O segundo item está sinalizado com segurança WRONG, e o suggestedCategories lista propõe categorias mais adequadas, classificadas por confiança.
Gerencie sua árvore de categorias
A árvore de categorias da sua organização é o conjunto de caminhos de categorias que Zonos conhece que sua organização usa. A Validação de Categoria desenha seu suggestedCategories desta árvore, portanto, mantê-la precisa e completa melhora diretamente a qualidade das sugestões. Categorias para as quais você envia categoriesValidate são adicionados à árvore automaticamente, mas você também pode gerenciá-los diretamente.
Cada categoria é uma hierarquia armazenada como um path matriz, da raiz ampla à folha específica - por exemplo, ["Footwear", "Athletic", "Running Shoes"].
Liste suas categorias
Use o categories consulta para recuperar a árvore de categorias da sua organização. Os resultados são paginados.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Adicionar categorias
Use o categoriesCreate mutação para adicionar um ou mais caminhos de categoria à sua árvore. Isso é útil para semear a árvore antes da validação, para que as sugestões possam aproveitar sua taxonomia completa.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Atualizar ou remover categorias
Use o categoryUpdate mutação para corrigir uma categoria pathpor seuid, ou o categoryDelete mutação para remover uma categoria que não se aplica mais. A remoção de categorias obsoletas ou incorretas mantém as sugestões relevantes.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}Para remover uma categoria, passe seu id para o categoryDeletemutação. Ele retornaSUCCESSou FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Validação de categoria
Verifique se as categorias atribuídas a um item se enquadram no produto e obtenha melhores sugestões de categorias quando não o fizerem.