Werdykty i pewność
Każdy artykuł w odpowiedzi zawiera verdict i confidenceScore (0–1) wyrażający pewność modelu w tym werdykcie.
| Werdykt↕ | Znaczenie↕ |
|---|---|
CORRECT | Artykuł prawdopodobnie należy do przypisanych kategorii. |
WRONG | Artykuł wyraźnie nie należy do przypisanych kategorii. |
Gdy werdykt to WRONG, pole suggestedCategories jest wypełnione wiarygodnymi alternatywami z uniwersum kategorii Twojej organizacji. Każda sugestia ma swoją hierarchię category (root → leaf) i wynik confidence — prawdopodobieństwo modelu, że jest to najlepiej dopasowana kategoria, posortowana malejąco. Gdy werdykt to CORRECT, pole suggestedCategories jest puste.
Weryfikuj kategorie za pośrednictwem API
Prześlij jeden lub więcej artykułów w jednym żądaniu. name i categories są wymagane dla każdego artykułu; dodanie opcjonalnych szczegółów, takich jak description, brand, material i amount, poprawia dokładność. Poniższy przykład weryfikuje dwa artykuły — jeden prawidłowo skategoryzowany i jeden wyraźnie błędnie skategoryzowany.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}Pola wejściowe
| Pole↕ | Typ↕ | Opis↕ |
|---|---|---|
name | String! | Nazwa produktu lub krótki opis. Wymagane. |
categories | [String!]! | Hierarchia kategorii (root → leaf) do weryfikacji. Wymagane. |
amount | Decimal | Cena artykułu. |
currencyCode | CurrencyCode | Waluta, w której podana jest kwota. |
brand | String | Marka artykułu. |
description | String | Pełny opis artykułu. |
material | String | Skład materiałowy artykułu. |
globalTradeItemNumber | String | Globalny numer artykułu handlowego (GTIN), taki jak UPC, EAN, GTIN-8 lub GTIN-14. |
imageUrl | String | Lokalizacja obrazu związanego z artykułem. |
Pola opisowe są echowane z powrotem na każdej CategoryValidation w odpowiedzi, dzięki czemu każda przechowywana weryfikacja jest samookreślająca.
Weryfikacja kategorii
Sprawdź, czy kategorie przypisane do każdego artykułu faktycznie go opisują.
GraphQL
Mutacja
categoriesValidateweryfikuje, czy kategorie podane dla każdego artykułu prawidłowo go opisują. Dla każdego przesłanego artykułu zwracaverdicticonfidenceScore. Gdy werdykt toWRONG, odpowiedź zawiera również wiarygodne alternatywne kategorie pochodzące z uniwersum kategorii Twojej organizacji.Użyj go, aby wychwycić błędnie skategoryzowane artykuły, zanim nieprawidłowe kategorie wpłyną na wyniki klasyfikacji, koszty lądowania lub ograniczenia — i aby zasugerować właściwą kategorię z powrotem osobie, która wpisała artykuł.