判定結果和信心度
回應中的每個項目都包含 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時,回應也會傳回您組織的分類範圍內的合理替代分類。使用它在不正確的分類影響下游分類、登陸成本或限制結果之前,捕捉分類錯誤的項目,並將正確的分類建議回給輸入項目的人。