分类验证

分类验证 

产品分类描述项目是什么，通常作为从广泛的根类别到具体的叶子类别的层次结构，例如 ["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 以提高准确性。在单个请求中提交多个项目以进行批量验证。

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

管理您的分类树 

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

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

列出您的分类

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

添加分类

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

更新或删除分类

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

要删除分类，请将其 id 传递给 categoryDelete 变更。它返回 SUCCESS 或 FAILURE。