カテゴリ検証
商品カテゴリは、品目が何であるかを、広いルートから特定のリーフまでの階層として記述します — 例: ["Footwear", "Athletic", "Running Shoes"]。正確なカテゴリはカタログを整理し、分類や貿易コンプライアンスなどの下流プロセスに供給します。誤ったカテゴリの品目は誤った結果を生む可能性があります。
カタログには、手動入力、サプライヤーフィード、システム間の移行などから、時間とともにカテゴリエラーが蓄積されます。Zonos Category Validationは、品目に割り当てられたカテゴリが実際にその品目を記述しているかを確認し、適合しない場合は組織が既に使用しているカテゴリからより適切なカテゴリを提案します。
仕組み
Zonos Category ValidationはAIを使用して、品目の name および brand、material、description など提供された追加詳細に基づき、提供されたカテゴリ階層が品目を正しく記述しているかを判定します。
各品目について CORRECT または WRONG の verdict と信頼度スコアを返します。verdict が WRONG の場合、割り当てを修正できるよう、ランク付けされた推奨カテゴリのリストを返します。提案は組織のカテゴリツリー — 組織が使用するカテゴリパスの集合 — から取得され、送信したカテゴリは自動的にそのツリーに追加されるため、適切に維持されたツリーほど時間とともに提案の品質が向上します。
これはバッチエンドポイントです — 単一のリクエストで多数の品目を検証でき、結果は入力と同じ順序で返されます。
判定と信頼度
各結果には verdict が含まれます。
CORRECT— 品目は割り当てられたカテゴリに妥当に属します。WRONG— 品目は割り当てられたカテゴリに属しません。
各結果には、返された判定に対するモデルの信頼度を示す 0.0 から 1.0 の confidenceScore も含まれます。スコアは判定自体の確信度を反映するため、自信を持って WRONG と判定された結果も、自信を持って CORRECT と判定された結果と同様に高い confidenceScore を持ちます。verdict が WRONG の場合、suggestedCategories リストには、それぞれ confidence 値を持つ代替カテゴリ階層が含まれ、最も可能性が高い順にソートされます。verdict が CORRECT の場合、suggestedCategories は空です。
信頼度スコアを使用して、どの結果を自動的に受け入れ、どの結果を手動レビューに回すかを判断することをお勧めします。
カテゴリを検証する
カテゴリを検証するには、categoriesValidate mutationを使用します。各品目には name と検証する categories 階層が必要です。精度向上のため、任意で brand、material、description、amount、currencyCode、globalTradeItemNumber、imageUrl を含めることができます。一括検証のため、単一のリクエストで複数の品目を送信できます。
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}上記の例では、最初の品目のカテゴリは高い信頼度で CORRECT と確認され、提案はありません。2番目の品目は自信を持って WRONG とフラグ付けされ、suggestedCategories リストは信頼度順にランク付けされたより適合するカテゴリを提案します。
カテゴリツリーを管理する
組織のカテゴリツリーは、Zonosが組織が使用していると認識しているカテゴリパスの集合です。Category Validationはこのツリーから suggestedCategories を取得するため、正確で完全なツリーを維持することで提案の品質が直接向上します。categoriesValidate に送信したカテゴリは自動的にツリーに追加されますが、直接管理することもできます。
各カテゴリは、広いルートから特定のリーフまでの path 配列として保存される階層です — 例: ["Footwear", "Athletic", "Running Shoes"]。
カテゴリを一覧表示する
組織のカテゴリツリーを取得するには、categories クエリを使用します。結果はページネーションされます。
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}カテゴリを追加する
1つ以上のカテゴリパスをツリーに追加するには、categoriesCreate mutationを使用します。検証前にツリーをシードして、提案が完全なタクソノミーから取得できるようにするのに便利です。
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}カテゴリを更新または削除する
id によってカテゴリの path を修正するには categoryUpdate mutationを、不要になったカテゴリを削除するには categoryDelete mutationを使用します。古くなったまたは誤ったカテゴリを整理することで、提案の関連性が保たれます。
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}カテゴリを削除するには、その id を categoryDelete mutationに渡します。SUCCESS または FAILURE を返します。
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Category Validation
品目に割り当てられたカテゴリが商品に適合するかを確認し、適合しない場合はより適切なカテゴリの提案を取得します。