判決和信心
回應中的每個商品都帶有一個 verdict 和一個 confidenceScore（0–1），表示該模型對該判決的信心。
| 判決↕ | 含義↕ |
|---|---|
CORRECT | 該商品合理地屬於指定的類別。 |
WRONG | 該商品明顯不屬於指定的類別。 |
當判決為 WRONG 時，suggestedCategories 會填充您機構類別體系中的合理替代方案。每項建議都有其自身的 category 階層結構（根 → 葉）和一個 confidence 分數—— 模型認為它是最佳類別的概率，按遞減排序。當判決為 CORRECT 時，suggestedCategories 為空。
通過 API 驗證類別
在單個請求中提交一個或多個商品。每個商品都需要 name 和 categories；包括可選的詳細資訊（如 description、brand、material 和 amount）可提高準確性。下面的示例驗證了兩個商品—— 一個分類正確，一個明顯分類錯誤。
1
mutation CategoriesValidate($input: [CategoryValidateInput!]!) {2
categoriesValidate(input: $input) {3
id4
name5
categories6
verdict7
confidenceScore8
suggestedCategories {9
category10
confidence11
}12
}13
}輸入欄位
| 欄位↕ | 類型↕ | 描述↕ |
|---|---|---|
name | String! | 商品名稱或簡短描述。必填。 |
categories | [String!]! | 要驗證的類別階層結構（根 → 葉）。必填。 |
amount | Decimal | 商品的價格。 |
currencyCode | CurrencyCode | 金額所用的貨幣。 |
brand | String | 商品的品牌。 |
description | String | 與商品關聯的完整描述。 |
material | String | 商品的材料成分。 |
globalTradeItemNumber | String | 全球貿易商品編號 (GTIN)，例如 UPC、EAN、GTIN-8 或 GTIN-14。 |
imageUrl | String | 與商品相關的影像位置。 |
描述性欄位會在回應中的每個 CategoryValidation 上回聲，因此每個儲存的驗證都是自我描述的。
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS
MUTATIONS
類別驗證
檢查指定予各商品的類別是否實際上正確描述該商品。
GraphQL
categoriesValidate變更驗證各商品供應的類別是否正確描述該商品。對於您提交的每個商品，它會返回一個verdict和一個confidenceScore。當判決為WRONG時，回應也會返回從您機構的類別體系中得出的合理替代類別。使用此功能可在不正確的類別影響下遊 classification、到岸成本或限制結果之前捕捉分類錯誤的商品，並向輸入該商品的人員建議正確的類別。