Verdict と confidence
レスポンス内の各品目には verdict と confidenceScore(0–1)が含まれ、その verdict に対するモデルの信頼度を示します。
| Verdict↕ | Meaning↕ |
|---|---|
CORRECT | 品目は割り当てられたカテゴリに妥当に属します。 |
WRONG | 品目は割り当てられたカテゴリに明らかに属しません。 |
verdict が WRONG の場合、suggestedCategories には組織のカテゴリ universe からの妥当な代替候補が入力されます。各候補には独自の category 階層(root → leaf)と confidence スコアがあり、最適なカテゴリである確率を降順で示します。verdict が CORRECT の場合、suggestedCategories は空です。
API 経由でカテゴリを検証
1 回のリクエストで 1 件以上の品目を送信します。各品目には name と categories が必須です。description、brand、material、amount などの任意の詳細を含めると精度が向上します。以下の例では、2 件の品目を検証しています。1 件は正しく分類され、もう 1 件は明らかに誤分類されています。
1
mutation CategoriesValidate($input: [CategoryValidateInput!]!) {2
categoriesValidate(input: $input) {3
id4
name5
categories6
verdict7
confidenceScore8
suggestedCategories {9
category10
confidence11
}12
}13
}入力フィールド
| Field↕ | Type↕ | Description↕ |
|---|---|---|
name | String! | 商品名または短い説明。必須。 |
categories | [String!]! | 検証するカテゴリ階層(root → leaf)。必須。 |
amount | Decimal | 品目の価格。 |
currencyCode | CurrencyCode | amount の通貨。 |
brand | String | 品目のブランド。 |
description | String | 品目に関連付けられた完全な説明。 |
material | String | 品目の素材構成。 |
globalTradeItemNumber | String | UPC、EAN、GTIN-8、GTIN-14 などの Global Trade Item Number(GTIN)。 |
imageUrl | String | 品目に関連する画像の場所。 |
説明フィールドはレスポンス内の各 CategoryValidation にエコーバックされるため、保存された各検証は自己記述的です。
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS
MUTATIONS
Category validation
各品目に割り当てられたカテゴリが実際に品目を説明しているか確認します。
GraphQL
categoriesValidatemutation は、各品目に提供されたカテゴリが品目を正しく説明しているかを検証します。送信した各品目について、verdictとconfidenceScoreを返します。verdict がWRONGの場合、レスポンスには組織のカテゴリ universe から得られた妥当な代替カテゴリも返されます。誤ったカテゴリが下流の classification、landed cost、制限結果に影響を与える前に、誤分類された品目をキャッチするために使用してください。品目を入力した担当者に正しいカテゴリを提案することもできます。