DOCS
홈물류 제공업체용 Category Validation

Category Validation

품목에 지정된 카테고리가 제품에 맞는지 확인하고, 맞지 않을 때 더 나은 카테고리 제안을 받아보세요.

카테고리 검증 

제품 카테고리는 품목이 무엇인지를 설명하며, 보통 넓은 최상위 범주에서 구체적인 하위 범주로 이어지는 계층 구조를 가집니다 — 예를 들어 ["Footwear", "Athletic", "Running Shoes"]와 같습니다. 정확한 카테고리는 카탈로그를 깔끔하게 유지하고 분류(classification), 무역 규정 준수(trade compliance)와 같은 후속 프로세스에 반영되는데, 카테고리가 잘못 지정된 품목은 잘못된 결과로 이어질 수 있습니다.

카탈로그는 수동 입력, 공급업체 피드, 시스템 간 마이그레이션 등을 거치며 시간이 지날수록 카테고리 오류가 쌓입니다. Zonos Category Validation은 품목에 지정된 카테고리가 실제로 그 품목을 올바르게 설명하는지 확인하고, 그렇지 않은 경우 조직에서 이미 사용 중인 카테고리 가운데 더 적합한 카테고리를 제안합니다.

작동 방식 

Zonos Category Validation은 AI를 사용해 품목의 name과 brand, material, description 등 추가로 제공된 세부 정보를 바탕으로, 지정한 카테고리 계층 구조가 해당 품목을 올바르게 설명하는지 판단합니다.

각 품목에 대해 CORRECT 또는 WRONG의 verdict와 신뢰도 점수(confidence score)를 함께 반환합니다. verdict가 WRONG이면 할당을 수정할 수 있도록 순위가 매겨진 제안 카테고리 목록을 반환합니다. 제안은 조직의 카테고리 트리 — 조직이 사용 중인 카테고리 경로(category path)의 집합 — 에서 가져오며, 제출한 카테고리는 자동으로 이 트리에 추가되므로 잘 관리된 트리일수록 시간이 지나면서 더 나은 제안을 만들어냅니다.

이 엔드포인트는 배치(batch) 엔드포인트로, 한 번의 요청으로 여러 품목을 검증할 수 있으며 결과는 입력과 동일한 순서로 반환됩니다.

판정과 신뢰도 

각 결과에는 verdict가 포함됩니다:

  • CORRECT — 품목이 지정된 카테고리에 속할 가능성이 높습니다.
  • WRONG — 품목이 지정된 카테고리에 속하지 않습니다.

각 결과에는 모델이 반환한 verdict에 대해 얼마나 확신하는지를 나타내는 0.0에서 1.0 사이의 confidenceScore도 포함됩니다. 이 점수는 verdict 자체에 대한 확신도를 반영하므로, 확신도가 높은 WRONG 결과는 확신도가 높은 CORRECT 결과와 마찬가지로 높은 confidenceScore를 가질 수 있습니다. verdict가 WRONG이면 suggestedCategories 목록에는 각각 confidence 값을 가진 대안 카테고리 계층들이 가능성이 높은 순서로 정렬되어 담깁니다. verdict가 CORRECT이면 suggestedCategories는 비어 있습니다.

신뢰도 점수(confidence score)를 활용해 어떤 결과를 자동으로 승인하고 어떤 결과를 수동 검토로 보낼지 결정하는 것을 권장합니다.

카테고리 검증하기 

카테고리를 검증하려면 categoriesValidate mutation을 사용하세요. 각 품목에는 name과 검증할 categories 계층 구조가 필요합니다. 정확도를 높이기 위해 brand, material, description, amount, currencyCode, globalTradeItemNumber, imageUrl을 선택적으로 포함할 수 있습니다. 한 번의 요청에 여러 품목을 제출하면 일괄로 검증할 수 있습니다.

1mutation CategoriesValidate($input: [CategoryValidateInput!]!) {
2 categoriesValidate(input: $input) {
3 id
4 name
5 categories
6 verdict
7 confidenceScore
8 suggestedCategories {
9 category
10 confidence
11 }
12 }
13}

위 예시에서 첫 번째 품목의 카테고리는 높은 확신도로 CORRECT로 확인되었으며 제안이 없습니다. 두 번째 품목은 확신도 높게 WRONG으로 표시되었고, suggestedCategories 목록은 확신도 순으로 더 적합한 카테고리를 제안합니다.

카테고리 트리 관리 

조직의 카테고리 트리는 Zonos가 인식하고 있는, 조직이 사용 중인 카테고리 경로의 집합입니다. Category Validation은 이 트리에서 suggestedCategories를 가져오므로, 트리를 정확하고 완전하게 유지하면 제안의 품질이 직접적으로 향상됩니다. categoriesValidate에 제출한 카테고리는 자동으로 트리에 추가되지만, 직접 관리할 수도 있습니다.

각 카테고리는 넓은 최상위 범주에서 구체적인 하위 범주까지 이어지는 계층 구조로, path 배열로 저장됩니다 — 예: ["Footwear", "Athletic", "Running Shoes"].

카테고리 목록 조회

조직의 카테고리 트리를 가져오려면 categories query를 사용하세요. 결과는 페이지 단위로 반환됩니다.

1query Categories {
2 categories(first: 50) {
3 totalCount
4 edges {
5 node {
6 id
7 path
8 }
9 }
10 }
11}

카테고리 추가

트리에 하나 이상의 카테고리 경로를 추가하려면 categoriesCreate mutation을 사용하세요. 이는 검증 전에 트리를 미리 채워두어, 제안이 전체 분류 체계(taxonomy)를 활용할 수 있게 하는 데 유용합니다.

1mutation CategoriesCreate($input: [CategoryCreateInput!]!) {
2 categoriesCreate(input: $input) {
3 id
4 path
5 }
6}

카테고리 수정 또는 삭제

categoryUpdate mutation을 사용하면 id를 기준으로 카테고리의 path를 수정할 수 있고, categoryDelete mutation을 사용하면 더 이상 적용되지 않는 카테고리를 삭제할 수 있습니다. 오래되었거나 잘못된 카테고리를 정리하면 제안의 관련성을 유지할 수 있습니다.

1mutation CategoryUpdate($input: CategoryUpdateInput!) {
2 categoryUpdate(input: $input) {
3 id
4 path
5 }
6}

카테고리를 삭제하려면 categoryDelete mutation에 해당 id를 전달하세요. SUCCESS 또는 FAILURE를 반환합니다.

1mutation CategoryDelete($id: ID!) {
2 categoryDelete(id: $id)
3}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CategoryCreateInput CategoryUpdateInput CategoryValidateInput

MUTATIONS

categoriesCreate categoriesValidate categoryDelete categoryUpdate

이 페이지가 도움이 되었나요?

지원 받기·법적 문서·© 2026 Zonos
이 페이지에서:
  • Category Validation
  • 카테고리 검증
  • 작동 방식
  • 판정과 신뢰도
  • 카테고리 검증하기
  • 카테고리 트리 관리