分類驗證

分類驗證 

商品分類用於描述商品是什麼，通常是從廣泛的根節點到特定葉子的層次結構 — 例如，["Footwear", "Athletic", "Running Shoes"]。準確的分類能夠保持您的目錄整潔，並為下游流程（如分類和貿易合規）提供支持，其中分類錯誤的商品可能會產生錯誤的結果。

目錄會隨著時間積累分類錯誤 — 來自人工輸入、供應商數據源或系統遷移。Zonos Category Validation 檢查指定給商品的分類是否實際描述了該商品，當不適合時，會建議從您的組織已使用的分類中選擇更好的分類。

如何運作 

Zonos Category Validation 使用 AI 根據商品的 name 和您提供的任何其他詳細資訊（如 brand、material 和 description）來判斷您提供的分類層次結構是否正確描述商品。

對於每個商品，它返回 verdict（CORRECT 或 WRONG）以及信心分數。當判斷為 WRONG 時，它返回建議分類的排名清單，以便您可以更正分配。建議來自您組織的分類樹 — 您的組織使用的分類路徑集合 — 您提交的任何分類都會自動添加到該樹中，因此維護良好的樹會隨著時間產生更好的建議。

這是一個批量端點 — 您可以在單個請求中驗證許多商品，結果按與輸入相同的順序返回。

判斷結果和信心分數 

每個結果包括一個 verdict：

• CORRECT — 商品在合理情況下屬於指定的分類。
• WRONG — 商品不屬於指定的分類。

每個結果還包括一個 confidenceScore，介於 0.0 和 1.0 之間，表示模型對返回的判斷結果的信心程度。分數反映對判斷結果本身的確定性，因此自信的 WRONG 結果具有高 confidenceScore，就如自信的 CORRECT 結果一樣。當判斷為 WRONG 時，suggestedCategories 清單包含替代分類層次結構，每個都有一個 confidence 值，並按從最可能到最不可能排序。當判斷為 CORRECT 時，suggestedCategories 為空。

我們建議使用信心分數來決定哪些結果自動接受，哪些路由到手動審查。

驗證分類 

若要驗證分類，請使用 categoriesValidate mutation。每個商品需要 name 和要驗證的 categories 層次結構。您可以選擇包括 brand、material、description、amount、currencyCode、globalTradeItemNumber 和 imageUrl 以提高準確性。在單個請求中提交多個商品以批量驗證。

在上面的示例中，第一個商品的分類被確認為 CORRECT，信心度很高，沒有建議。第二個商品被自信地標記為 WRONG，suggestedCategories 清單建議按信心度排序的更適合的分類。

管理您的分類樹 

您的組織的分類樹是 Zonos 知道您的組織使用的分類路徑集合。Category Validation 從此樹中提取其 suggestedCategories，因此保持它的準確性和完整性會直接改善建議的品質。您提交到 categoriesValidate 的分類會自動添加到樹中，但您也可以直接管理它。

每個分類是儲存為 path 陣列的層次結構，從廣泛的根節點到特定的葉子 — 例如，["Footwear", "Athletic", "Running Shoes"]。

列出您的分類

使用 categories query 檢索您的組織的分類樹。結果是分頁的。

添加分類

使用 categoriesCreate mutation 將一個或多個分類路徑添加到您的樹中。這對於在驗證之前對樹進行種子化非常有用，使建議能夠利用您完整的分類法。

更新或移除分類

使用 categoryUpdate mutation 按其 id 更正分類的 path，或使用 categoryDelete mutation 移除不再適用的分類。修剪過時或不正確的分類會保持建議的相關性。

若要移除分類，請將其 id 傳遞給 categoryDelete mutation。它返回 SUCCESS 或 FAILURE。