DOCS
Strona głównaDla dostawców logistyki Walidacja kategorii

Walidacja kategorii

Sprawdź, czy przypisane kategorie przedmiotu pasują do produktu, i uzyskaj lepsze sugestie kategorii, gdy tak nie jest.

Walidacja kategorii 

Kategorie produktów opisują, czym jest przedmiot, zwykle jako hierarchia od szerokiego korzenia do konkretnego liścia — na przykład ["Obuwie", "Sportowe", "Buty do biegania"]. Dokładne kategorie utrzymują katalog czystym i zasilają kolejne procesy, takie jak klasyfikacja i zgodność handlowa, gdzie nieprawidłowo skategoryzowany przedmiot może dać błędny wynik.

Katalogi gromadzą błędy kategoryzacji w miarę upływu czasu — z ręcznego wprowadzania danych, źródeł dostawcy lub migracji między systemami. Zonos Category Validation sprawdza, czy kategorie przypisane do przedmiotu faktycznie go opisują, a gdy tak nie jest, sugeruje lepsze kategorie pochodzące z kategorii, które już wykorzystuje Twoja organizacja.

Jak to działa 

Zonos Category Validation wykorzystuje sztuczną inteligencję do oceny, czy podana hierarchia kategorii prawidłowo opisuje przedmiot, na podstawie pola name przedmiotu i wszelkich dodatkowych szczegółów, które możesz dostarczyć, takich jak brand, material i description.

Dla każdego przedmiotu zwraca verdict w postaci CORRECT lub WRONG wraz z oceną pewności. Gdy werdykt to WRONG, zwraca uszeregowaną listę sugerowanych kategorii, abyś mógł poprawić przypisanie. Sugestie pochodzą z drzewa kategorii Twojej organizacji — zestawu ścieżek kategorii, których Twoja organizacja używa — i wszystkie przedłożone kategorie są automatycznie dodawane do tego drzewa, więc dobrze utrzymane drzewo daje lepsze sugestie w miarę upływu czasu.

Jest to punkt końcowy usługi wsadowej — możesz walidować wiele przedmiotów w jednym żądaniu, a wyniki są zwracane w tej samej kolejności co dane wejściowe.

Werdykt i pewność 

Każdy wynik zawiera verdict:

  • CORRECT — przedmiot prawdopodobnie należy do przypisanych kategorii.
  • WRONG — przedmiot nie należy do przypisanych kategorii.

Każdy wynik zawiera również confidenceScore między 0.0 a 1.0 wskazujący, jak pewny jest model werdyktu, który zwrócił. Wynik odzwierciedla pewność samego werdyktu, więc wynik pewnie WRONG ma wysokie confidenceScore tak jak wynik pewnie CORRECT. Gdy werdykt to WRONG, lista suggestedCategories zawiera alternatywne hierarchie kategorii, każda z wartością confidence i posortowana od najbardziej do najmniej prawdopodobnej. Gdy werdykt to CORRECT, suggestedCategories jest pusta.

Zalecamy używanie wyniku pewności do decydowania, które wyniki zaakceptować automatycznie, a które skierować do przeglądu ręcznego.

Waliduj kategorie 

Aby walidować kategorie, użyj mutacji categoriesValidate. Każdy przedmiot wymaga name i hierarchii categories do walidacji. Opcjonalnie możesz dołączyć brand, material, description, amount, currencyCode, globalTradeItemNumber i imageUrl, aby poprawić dokładność. Prześlij wiele przedmiotów w jednym żądaniu, aby walidować zbiorczo.

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}

W powyższym przykładzie kategorie pierwszego przedmiotu są potwierdzone jako CORRECT z wysoką pewnością i bez sugestii. Drugi przedmiot jest pewnie oznaczony jako WRONG, a lista suggestedCategories proponuje kategorie lepiej dopasowane, posortowane według pewności.

Zarządzaj swoim drzewem kategorii 

Drzewo kategorii Twojej organizacji to zestaw ścieżek kategorii, o których Zonos wie, że korzysta z nich Twoja organizacja. Category Validation czerpie swoje suggestedCategories z tego drzewa, więc utrzymanie go dokładnym i kompletnym bezpośrednio poprawia jakość sugestii. Kategorie, które przesyłasz do categoriesValidate, są automatycznie dodawane do drzewa, ale możesz również zarządzać nim bezpośrednio.

Każda kategoria jest hierarchią przechowywana jako tablica path, od szerokiego korzenia do konkretnego liścia — na przykład ["Obuwie", "Sportowe", "Buty do biegania"].

Wypisz swoje kategorie

Użyj zapytania categories, aby pobrać drzewo kategorii Twojej organizacji. Wyniki są paginowane.

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

Dodaj kategorie

Użyj mutacji categoriesCreate, aby dodać jedną lub więcej ścieżek kategorii do Twojego drzewa. Jest to przydatne do inicjowania drzewa przed walidacją, aby sugestie mogły czerpać z Twojej pełnej taksonomii.

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

Aktualizuj lub usuń kategorie

Użyj mutacji categoryUpdate, aby poprawić path kategorii za pomocą jej id, lub mutacji categoryDelete, aby usunąć kategorię, która już nie ma zastosowania. Oczyszczanie starych lub niepoprawnych kategorii utrzymuje sugestie istotne.

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

Aby usunąć kategorię, przekaż jej id do mutacji categoryDelete. Zwraca SUCCESS lub 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

Czy ta strona była pomocna?

Uzyskaj wsparcie·Dokumenty prawne·© 2026 Zonos
Na tej stronie:
  • Walidacja kategorii
  • Walidacja kategorii
  • Jak to działa
  • Werdykt i pewność
  • Waliduj kategorie
  • Zarządzaj swoim drzewem kategorii