DOCS

分类验证

分类验证

检查项目的分配分类是否适合产品,当不匹配时获取更好的分类建议。

分类验证 

产品分类描述项目是什么,通常作为从广泛的根类别到具体的叶子类别的层次结构,例如 ["Footwear", "Athletic", "Running Shoes"]。准确的分类可以使目录保持整洁,并支持下游流程,如分类和贸易合规,其中分类错误的项目可能会产生错误的结果。

目录会随着时间的推移而积累分类错误 — 来自手动输入、供应商数据源或系统间的迁移。Zonos Category Validation 检查分配给项目的分类是否真正描述该项目,如果不匹配,会建议从您的组织已使用的分类中提取的更好的分类。

工作原理 

Zonos Category Validation 使用 AI 根据项目的 name 和您提供的任何其他详细信息(如 brandmaterialdescription)来判断您提供的分类层次结构是否正确描述了该项目。

对于每个项目,它返回 verdictCORRECTWRONG,以及置信度分数。当评决为 WRONG 时,它返回建议分类的排序列表,以便您可以更正分配。建议从您的组织分类树中提取 — 即您的组织使用的分类路径集合 — 您提交的任何分类都会自动添加到该树中,因此维护良好的树会随着时间的推移产生更好的建议。

这是一个批量端点 — 您可以在单个请求中验证多个项目,结果以与输入相同的顺序返回。

判定和置信度 

每个结果都包括一个 verdict:

  • CORRECT — 项目合理地属于分配的分类。
  • WRONG — 项目不属于分配的分类。

每个结果还包括一个介于 0.01.0 之间的 confidenceScore,指示模型对其返回的判定的置信度。分数反映了对判定本身的确定性,因此一个明确 WRONG 的结果的 confidenceScore 与一个明确 CORRECT 的结果一样高。当判定为 WRONG 时,suggestedCategories 列表包含替代分类层次结构,每个都有 confidence 值并按从最可能到最不可能排序。当判定为 CORRECT 时,suggestedCategories 为空。

我们建议使用置信度分数来决定哪些结果自动接受,哪些结果路由到手动审查。

验证分类 

要验证分类,请使用 categoriesValidate 变量。每个项目都需要 name 和要验证的 categories 层次结构。您可以选择包含 brandmaterialdescriptionamountcurrencyCodeglobalTradeItemNumberimageUrl 以提高准确性。在单个请求中提交多个项目以进行批量验证。

1mutation CategoriesValidate($input: [CategoryValidateInput!]!) {
2 categoriesValidate(input: $input) {
3 id
4 name
5 categories
6 verdict
7 confidenceScore
8 suggestedCategories {
9 category
10 confidence
11 }
12 }
13}

在上面的示例中,第一个项目的分类被确认为 CORRECT,置信度很高,没有建议。第二个项目被明确标记为 WRONG,suggestedCategories 列表提议按置信度排序的更合适的分类。

管理您的分类树 

您的组织的分类树是 Zonos 知道您的组织使用的分类路径集合。分类验证从此树中提取其 suggestedCategories,因此保持其准确和完整直接改善建议的质量。提交给 categoriesValidate 的分类会自动添加到树中,但您也可以直接管理它。

每个分类都是作为 path 数组存储的层次结构,从广泛的根到具体的叶子 — 例如 ["Footwear", "Athletic", "Running Shoes"]

列出您的分类

使用 categories 查询来检索您的组织的分类树。结果是分页的。

1query Categories {
2 categories(first: 50) {
3 totalCount
4 edges {
5 node {
6 id
7 path
8 }
9 }
10 }
11}

添加分类

使用 categoriesCreate 变量将一个或多个分类路径添加到您的树中。这对于在验证前填充树很有用,以便建议可以利用您的完整分类。

1mutation CategoriesCreate($input: [CategoryCreateInput!]!) {
2 categoriesCreate(input: $input) {
3 id
4 path
5 }
6}

更新或删除分类

使用 categoryUpdate 变量通过其 id 更正分类的 path,或使用 categoryDelete 变量删除不再适用的分类。剪除陈旧或不正确的分类可以使建议保持相关性。

1mutation CategoryUpdate($input: CategoryUpdateInput!) {
2 categoryUpdate(input: $input) {
3 id
4 path
5 }
6}

要删除分类,请将其 id 传递给 categoryDelete 变量。它返回 SUCCESSFAILURE

1mutation CategoryDelete($id: ID!) {
2 categoryDelete(id: $id)
3}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
预约演示

这个页面有帮助吗?


在此页面: