As categorias de produtos descrevem o que é um item, geralmente como uma hierarquia que vai de uma raiz ampla até uma folha específica — por exemplo, ["Footwear", "Athletic", "Running Shoes"]. Categorias precisas mantêm seu catálogo organizado e alimentam processos posteriores, como classificação e conformidade comercial, nos quais um item categorizado incorretamente pode gerar o resultado errado.
Os catálogos acumulam erros de categoria ao longo do tempo — por causa de entradas manuais, feeds de fornecedores ou migrações entre sistemas. A Zonos Validação de categoria verifica se as categorias atribuídas a um item realmente descrevem esse item e, quando não descrevem, sugere categorias melhores, extraídas das categorias que sua organização já utiliza.
A Zonos Validação de categoria usa IA para avaliar se a hierarquia de categorias fornecida por você descreve corretamente um item, com base no name do item e em quaisquer detalhes adicionais fornecidos, como brand, material e description.
Para cada item, ela retorna um verdict de CORRECT ou WRONG, junto com uma pontuação de confiança. Quando o veredito é WRONG, ela retorna 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 categoria que sua organização utiliza — e todas as categorias que você enviar são adicionadas automaticamente a essa árvore, de modo que uma árvore bem mantida produza sugestões cada vez 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.
CORRECT — o item provavelmente pertence às categorias atribuídas.
WRONG — o item não pertence às categorias atribuídas.
Cada resultado também inclui um confidenceScore entre 0.0 e 1.0, indicando o quão confiante o modelo está no veredito retornado. A pontuação reflete a certeza sobre o próprio veredito, portanto um resultado WRONG com alta confiança tem um confidenceScore tão alto quanto um resultado CORRECT igualmente confiante. Quando o veredito é WRONG, a lista suggestedCategories contém hierarquias de categoria alternativas, cada uma com um valor de confidence, classificadas da mais para a menos provável. Quando o veredito é CORRECT, suggestedCategories fica vazio.
Recomendamos usar a pontuação de confiança para decidir quais resultados aceitar automaticamente e quais encaminhar para revisão manual.
Para validar categorias, use a mutação categoriesValidate. Cada item requer um name e a hierarquia categories a ser validada. Você pode incluir opcionalmente brand, 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.
No exemplo acima, as categorias do primeiro item são confirmadas como CORRECT, com alta confiança e sem sugestões. O segundo item é sinalizado com confiança como WRONG, e a lista suggestedCategories propõe categorias mais adequadas, classificadas por confiança.
A árvore de categorias da sua organização é o conjunto de caminhos de categoria que a Zonos sabe que sua organização utiliza. A Validação de categoria extrai suas suggestedCategories dessa árvore, portanto mantê-la precisa e completa melhora diretamente a qualidade das sugestões. As categorias enviadas para categoriesValidate são adicionadas à árvore automaticamente, mas você também pode gerenciá-la diretamente.
Cada categoria é uma hierarquia armazenada como uma matriz path, de uma raiz ampla até uma folha específica — por exemplo, ["Footwear", "Athletic", "Running Shoes"].
Listar suas categorias
Use a consulta categories para recuperar a árvore de categorias da sua organização. Os resultados são paginados.
1queryCategories{
2 categories(first:50){
3 totalCount
4 edges {
5 node {
6 id
7 path
8}
9}
10}
11}
Adicionar categorias
Use a mutação categoriesCreate para adicionar um ou mais caminhos de categoria à sua árvore. Isso é útil para preencher a árvore antes da validação, para que as sugestões possam se basear em toda a sua taxonomia.
Use a mutação categoryUpdate para corrigir o path de uma categoria pelo seu id, ou a mutação categoryDelete para remover uma categoria que não se aplica mais. Remover categorias desatualizadas ou incorretas mantém as sugestões relevantes.
Validação de categoria
Validação de categoria
Verifique se as categorias atribuídas a um item correspondem ao produto e obtenha melhores sugestões de categorias quando isso não acontecer.
Validação de categoria
As categorias de produtos descrevem o que é um item, geralmente como uma hierarquia que vai de uma raiz ampla até uma folha específica — por exemplo,
["Footwear", "Athletic", "Running Shoes"]. Categorias precisas mantêm seu catálogo organizado e alimentam processos posteriores, como classificação e conformidade comercial, nos quais um item categorizado incorretamente pode gerar o resultado errado.Os catálogos acumulam erros de categoria ao longo do tempo — por causa de entradas manuais, feeds de fornecedores ou migrações entre sistemas. A Zonos Validação de categoria verifica se as categorias atribuídas a um item realmente descrevem esse item e, quando não descrevem, sugere categorias melhores, extraídas das categorias que sua organização já utiliza.
Como funciona
A Zonos Validação de categoria usa IA para avaliar se a hierarquia de categorias fornecida por você descreve corretamente um item, com base no
namedo item e em quaisquer detalhes adicionais fornecidos, comobrand,materialedescription.Para cada item, ela retorna um
verdictdeCORRECTouWRONG, junto com uma pontuação de confiança. Quando o veredito éWRONG, ela retorna 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 categoria que sua organização utiliza — e todas as categorias que você enviar são adicionadas automaticamente a essa árvore, de modo que uma árvore bem mantida produza sugestões cada vez 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.
Veredito e confiança
Cada resultado inclui um
verdict:CORRECT— o item provavelmente pertence às categorias atribuídas.WRONG— o item não pertence às categorias atribuídas.Cada resultado também inclui um
confidenceScoreentre0.0e1.0, indicando o quão confiante o modelo está no veredito retornado. A pontuação reflete a certeza sobre o próprio veredito, portanto um resultadoWRONGcom alta confiança tem umconfidenceScoretão alto quanto um resultadoCORRECTigualmente confiante. Quando o veredito éWRONG, a listasuggestedCategoriescontém hierarquias de categoria alternativas, cada uma com um valor deconfidence, classificadas da mais para a menos provável. Quando o veredito éCORRECT,suggestedCategoriesfica vazio.Recomendamos usar a pontuação de confiança para decidir quais resultados aceitar automaticamente e quais encaminhar para revisão manual.
Validar categorias
Para validar categorias, use a mutação
categoriesValidate. Cada item requer umnamee a hierarquiacategoriesa ser validada. Você pode incluir opcionalmentebrand,material,description,amount,currencyCode,globalTradeItemNumbereimageUrlpara melhorar a precisão. Envie vários itens em uma única solicitação para validar em massa.mutation CategoriesValidate($input: [CategoryValidateInput!]!) {categoriesValidate(input: $input) {idnamecategoriesverdictconfidenceScoresuggestedCategories {categoryconfidence}}}No exemplo acima, as categorias do primeiro item são confirmadas como
CORRECT, com alta confiança e sem sugestões. O segundo item é sinalizado com confiança comoWRONG, e a listasuggestedCategoriespropõ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 categoria que a Zonos sabe que sua organização utiliza. A Validação de categoria extrai suas
suggestedCategoriesdessa árvore, portanto mantê-la precisa e completa melhora diretamente a qualidade das sugestões. As categorias enviadas paracategoriesValidatesão adicionadas à árvore automaticamente, mas você também pode gerenciá-la diretamente.Cada categoria é uma hierarquia armazenada como uma matriz
path, de uma raiz ampla até uma folha específica — por exemplo,["Footwear", "Athletic", "Running Shoes"].Listar suas categorias
Use a consulta
categoriespara recuperar a árvore de categorias da sua organização. Os resultados são paginados.query Categories {categories(first: 50) {totalCountedges {node {idpath}}}}Adicionar categorias
Use a mutação
categoriesCreatepara adicionar um ou mais caminhos de categoria à sua árvore. Isso é útil para preencher a árvore antes da validação, para que as sugestões possam se basear em toda a sua taxonomia.mutation CategoriesCreate($input: [CategoryCreateInput!]!) {categoriesCreate(input: $input) {idpath}}Atualizar ou remover categorias
Use a mutação
categoryUpdatepara corrigir opathde uma categoria pelo seuid, ou a mutaçãocategoryDeletepara remover uma categoria que não se aplica mais. Remover categorias desatualizadas ou incorretas mantém as sugestões relevantes.mutation CategoryUpdate($input: CategoryUpdateInput!) {categoryUpdate(input: $input) {idpath}}Para remover uma categoria, passe seu
idpara a mutaçãocategoryDelete. Ela retornaSUCCESSouFAILURE.mutation CategoryDelete($id: ID!) {categoryDelete(id: $id)}CategoryCreateInput CategoryUpdateInput CategoryValidateInput
categoriesCreate categoriesValidate categoryDelete categoryUpdate
Esta página foi útil?