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 wspierają procesy downstream, 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 — ze wkładów ręcznych, ź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 ranking listy sugerowanych kategorii, abyś mógł poprawić przypisanie. Sugestie pochodzą z drzewa kategorii Twojej organizacji — zestawu ścieżek kategorii, które 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 można uzasadnić należeć 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 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.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}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, które Zonos wie, że Twoja organizacja używa. 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.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}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.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}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.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}Aby usunąć kategorię, przekaż jej id do mutacji categoryDelete. Zwraca SUCCESS lub FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Walidacja kategorii
Sprawdź, czy przypisane kategorie przedmiotu pasują do produktu, i uzyskaj lepsze sugestie kategorii, gdy tak nie jest.