As categorias de produtos descrevem o que é um item, normalmente sob a forma de uma hierarquia que vai de uma raiz abrangente até uma folha específica — por exemplo, ["Footwear", "Athletic", "Running Shoes"]. Categorias precisas mantêm o seu catálogo organizado e alimentam processos posteriores, como a classificação e a conformidade comercial, nos quais um item mal categorizado pode produzir um resultado errado.
Os catálogos acumulam erros de categoria ao longo do tempo — devido à introdução manual de dados, a feeds de fornecedores ou a migrações entre sistemas. A Validação de categorias da Zonos verifica se as categorias atribuídas a um item descrevem efetivamente esse item e, quando não o descrevem, sugere categorias mais adequadas, retiradas das categorias que a sua organização já utiliza.
A Validação de categorias da Zonos utiliza IA para avaliar se a hierarquia de categorias que fornece descreve corretamente um item, com base no name do item e em quaisquer detalhes adicionais que indique, como brand, material e description.
Para cada item, devolve um verdict de CORRECT ou WRONG, juntamente com uma pontuação de confiança. Quando o veredicto é WRONG, devolve uma lista ordenada de categorias sugeridas para que possa corrigir a atribuição. As sugestões são retiradas da árvore de categorias da sua organização — o conjunto de caminhos de categoria que a sua organização utiliza — e todas as categorias que enviar são adicionadas automaticamente a essa árvore, pelo que uma árvore bem mantida produz sugestões cada vez melhores ao longo do tempo.
Este é um endpoint em lote — pode validar muitos itens num único pedido, e os resultados são devolvidos pela mesma ordem da entrada.
CORRECT — o item pertence plausivelmente às categorias atribuídas.
WRONG — o item não pertence às categorias atribuídas.
Cada resultado inclui também um confidenceScore entre 0.0 e 1.0, que indica o grau de confiança do modelo no veredicto devolvido. A pontuação reflete a certeza quanto ao próprio veredicto, pelo que um resultado WRONG com elevada confiança tem um confidenceScore alto, tal como um resultado CORRECT com elevada confiança. Quando o veredicto é WRONG, a lista suggestedCategories contém hierarquias de categorias alternativas, cada uma com um valor de confidence e ordenadas da mais para a menos provável. Quando o veredicto é CORRECT, suggestedCategories está vazia.
Recomendamos que utilize a pontuação de confiança para decidir que resultados aceitar automaticamente e quais encaminhar para revisão manual.
Para validar categorias, utilize a mutação categoriesValidate. Cada item requer um name e a hierarquia categories a validar. Opcionalmente, pode incluir brand, material, description, amount, currencyCode, globalTradeItemNumber e imageUrl para melhorar a precisão. Envie vários itens num único pedido para validar em lote.
No exemplo acima, as categorias do primeiro item são confirmadas como CORRECT, com elevada confiança e sem sugestões. O segundo item é assinalado como WRONG com elevada confiança, e a lista suggestedCategories propõe categorias mais adequadas, ordenadas por confiança.
A árvore de categorias da sua organização é o conjunto de caminhos de categoria que a Zonos sabe que a sua organização utiliza. A Validação de categorias retira as suas suggestedCategories desta árvore, pelo que mantê-la precisa e completa melhora diretamente a qualidade das sugestões. As categorias que envia para categoriesValidate são adicionadas automaticamente à árvore, mas também a pode gerir diretamente.
Cada categoria é uma hierarquia armazenada como uma matriz path, desde uma raiz abrangente até uma folha específica — por exemplo, ["Footwear", "Athletic", "Running Shoes"].
Listar as suas categorias
Utilize a consulta categories para obter 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
Utilize a mutação categoriesCreate para adicionar um ou mais caminhos de categoria à sua árvore. Isto é útil para preencher a árvore antes da validação, para que as sugestões possam basear-se em toda a sua taxonomia.
Utilize a mutação categoryUpdate para corrigir o path de uma categoria através do respetivo id, ou a mutação categoryDelete para remover uma categoria que já não se aplique. Eliminar categorias desatualizadas ou incorretas mantém as sugestões relevantes.
Validação de categorias
Validação de categorias
Verifique se as categorias atribuídas a um item se adequam ao produto e obtenha melhores sugestões de categorias quando não se adequarem.
Validação de categorias
As categorias de produtos descrevem o que é um item, normalmente sob a forma de uma hierarquia que vai de uma raiz abrangente até uma folha específica — por exemplo,
["Footwear", "Athletic", "Running Shoes"]. Categorias precisas mantêm o seu catálogo organizado e alimentam processos posteriores, como a classificação e a conformidade comercial, nos quais um item mal categorizado pode produzir um resultado errado.Os catálogos acumulam erros de categoria ao longo do tempo — devido à introdução manual de dados, a feeds de fornecedores ou a migrações entre sistemas. A Validação de categorias da Zonos verifica se as categorias atribuídas a um item descrevem efetivamente esse item e, quando não o descrevem, sugere categorias mais adequadas, retiradas das categorias que a sua organização já utiliza.
Como funciona
A Validação de categorias da Zonos utiliza IA para avaliar se a hierarquia de categorias que fornece descreve corretamente um item, com base no
namedo item e em quaisquer detalhes adicionais que indique, comobrand,materialedescription.Para cada item, devolve um
verdictdeCORRECTouWRONG, juntamente com uma pontuação de confiança. Quando o veredicto éWRONG, devolve uma lista ordenada de categorias sugeridas para que possa corrigir a atribuição. As sugestões são retiradas da árvore de categorias da sua organização — o conjunto de caminhos de categoria que a sua organização utiliza — e todas as categorias que enviar são adicionadas automaticamente a essa árvore, pelo que uma árvore bem mantida produz sugestões cada vez melhores ao longo do tempo.Este é um endpoint em lote — pode validar muitos itens num único pedido, e os resultados são devolvidos pela 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 inclui também um
confidenceScoreentre0.0e1.0, que indica o grau de confiança do modelo no veredicto devolvido. A pontuação reflete a certeza quanto ao próprio veredicto, pelo que um resultadoWRONGcom elevada confiança tem umconfidenceScorealto, tal como um resultadoCORRECTcom elevada confiança. Quando o veredicto éWRONG, a listasuggestedCategoriescontém hierarquias de categorias alternativas, cada uma com um valor deconfidencee ordenadas da mais para a menos provável. Quando o veredicto éCORRECT,suggestedCategoriesestá vazia.Recomendamos que utilize a pontuação de confiança para decidir que resultados aceitar automaticamente e quais encaminhar para revisão manual.
Validar categorias
Para validar categorias, utilize a mutação
categoriesValidate. Cada item requer umnamee a hierarquiacategoriesa validar. Opcionalmente, pode incluirbrand,material,description,amount,currencyCode,globalTradeItemNumbereimageUrlpara melhorar a precisão. Envie vários itens num único pedido para validar em lote.mutation CategoriesValidate($input: [CategoryValidateInput!]!) {categoriesValidate(input: $input) {idnamecategoriesverdictconfidenceScoresuggestedCategories {categoryconfidence}}}No exemplo acima, as categorias do primeiro item são confirmadas como
CORRECT, com elevada confiança e sem sugestões. O segundo item é assinalado comoWRONGcom elevada confiança, e a listasuggestedCategoriespropõe categorias mais adequadas, ordenadas por confiança.Gerir a sua árvore de categorias
A árvore de categorias da sua organização é o conjunto de caminhos de categoria que a Zonos sabe que a sua organização utiliza. A Validação de categorias retira as suas
suggestedCategoriesdesta árvore, pelo que mantê-la precisa e completa melhora diretamente a qualidade das sugestões. As categorias que envia paracategoriesValidatesão adicionadas automaticamente à árvore, mas também a pode gerir diretamente.Cada categoria é uma hierarquia armazenada como uma matriz
path, desde uma raiz abrangente até uma folha específica — por exemplo,["Footwear", "Athletic", "Running Shoes"].Listar as suas categorias
Utilize a consulta
categoriespara obter a árvore de categorias da sua organização. Os resultados são paginados.query Categories {categories(first: 50) {totalCountedges {node {idpath}}}}Adicionar categorias
Utilize a mutação
categoriesCreatepara adicionar um ou mais caminhos de categoria à sua árvore. Isto é útil para preencher a árvore antes da validação, para que as sugestões possam basear-se em toda a sua taxonomia.mutation CategoriesCreate($input: [CategoryCreateInput!]!) {categoriesCreate(input: $input) {idpath}}Atualizar ou remover categorias
Utilize a mutação
categoryUpdatepara corrigir opathde uma categoria através do respetivoid, ou a mutaçãocategoryDeletepara remover uma categoria que já não se aplique. Eliminar categorias desatualizadas ou incorretas mantém as sugestões relevantes.mutation CategoryUpdate($input: CategoryUpdateInput!) {categoryUpdate(input: $input) {idpath}}Para remover uma categoria, passe o respetivo
idà mutaçãocategoryDelete. Esta devolveSUCCESSouFAILURE.mutation CategoryDelete($id: ID!) {categoryDelete(id: $id)}CategoryCreateInput CategoryUpdateInput CategoryValidateInput
categoriesCreate categoriesValidate categoryDelete categoryUpdate
Esta página foi útil?