分類驗證

分類驗證 

產品分類描述商品是什麼，通常以從寬泛的根到具體葉子的階層結構呈現 — 例如，["Footwear", "Athletic", "Running Shoes"]。精確的分類可以保持目錄整潔，並為下游流程（如分類和貿易合規性）提供資料，其中分類錯誤的商品可能會產生錯誤的結果。

目錄會隨著時間累積分類錯誤 — 來自手動輸入、供應商資料或系統遷移。Zonos 分類驗證檢查指派給商品的分類是否實際描述該商品，如果不是，則建議貴組織已使用的分類中更佳的分類。

運作方式 

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

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

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

判決和信心分數 

每個結果都包含 verdict：

• CORRECT — 商品合理地屬於指派的分類。
• WRONG — 商品不屬於指派的分類。

每個結果還包含 0.0 到 1.0 之間的 confidenceScore，指示模型對返回的判決的信心程度。分數反映對判決本身的確定性，因此自信的 WRONG 結果與自信的 CORRECT 結果一樣具有高 confidenceScore。當判決為 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。