分类验证
产品分类描述项目是什么,通常作为从广泛的根类别到具体的叶子类别的层次结构,例如 ["Footwear", "Athletic", "Running Shoes"]。准确的分类可以使目录保持整洁,并支持下游流程,如分类和贸易合规,其中分类错误的项目可能会产生错误的结果。
目录会随着时间的推移而积累分类错误 — 来自手动输入、供应商数据源或系统间的迁移。Zonos Category Validation 检查分配给项目的分类是否真正描述该项目,如果不匹配,会建议从您的组织已使用的分类中提取的更好的分类。
工作原理
Zonos Category Validation 使用 AI 根据项目的 name 和您提供的任何其他详细信息(如 brand、material 和 description)来判断您提供的分类层次结构是否正确描述了该项目。
对于每个项目,它返回 verdict 为 CORRECT 或 WRONG,以及置信度分数。当评决为 WRONG 时,它返回建议分类的排序列表,以便您可以更正分配。建议从您的组织分类树中提取 — 即您的组织使用的分类路径集合 — 您提交的任何分类都会自动添加到该树中,因此维护良好的树会随着时间的推移产生更好的建议。
这是一个批量端点 — 您可以在单个请求中验证多个项目,结果以与输入相同的顺序返回。
判定和置信度
每个结果都包括一个 verdict:
CORRECT— 项目合理地属于分配的分类。WRONG— 项目不属于分配的分类。
每个结果还包括一个介于 0.0 和 1.0 之间的 confidenceScore,指示模型对其返回的判定的置信度。分数反映了对判定本身的确定性,因此一个明确 WRONG 的结果的 confidenceScore 与一个明确 CORRECT 的结果一样高。当判定为 WRONG 时,suggestedCategories 列表包含替代分类层次结构,每个都有 confidence 值并按从最可能到最不可能排序。当判定为 CORRECT 时,suggestedCategories 为空。
我们建议使用置信度分数来决定哪些结果自动接受,哪些结果路由到手动审查。
验证分类
要验证分类,请使用 categoriesValidate 变量。每个项目都需要 name 和要验证的 categories 层次结构。您可以选择包含 brand、material、description、amount、currencyCode、globalTradeItemNumber 和 imageUrl 以提高准确性。在单个请求中提交多个项目以进行批量验证。
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}在上面的示例中,第一个项目的分类被确认为 CORRECT,置信度很高,没有建议。第二个项目被明确标记为 WRONG,suggestedCategories 列表提议按置信度排序的更合适的分类。
管理您的分类树
您的组织的分类树是 Zonos 知道您的组织使用的分类路径集合。分类验证从此树中提取其 suggestedCategories,因此保持其准确和完整直接改善建议的质量。提交给 categoriesValidate 的分类会自动添加到树中,但您也可以直接管理它。
每个分类都是作为 path 数组存储的层次结构,从广泛的根到具体的叶子 — 例如 ["Footwear", "Athletic", "Running Shoes"]。
列出您的分类
使用 categories 查询来检索您的组织的分类树。结果是分页的。
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}添加分类
使用 categoriesCreate 变量将一个或多个分类路径添加到您的树中。这对于在验证前填充树很有用,以便建议可以利用您的完整分类。
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}更新或删除分类
使用 categoryUpdate 变量通过其 id 更正分类的 path,或使用 categoryDelete 变量删除不再适用的分类。剪除陈旧或不正确的分类可以使建议保持相关性。
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}要删除分类,请将其 id 传递给 categoryDelete 变量。它返回 SUCCESS 或 FAILURE。
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
分类验证
检查项目的分配分类是否适合产品,当不匹配时获取更好的分类建议。