Xác thực danh mục
Danh mục sản phẩm mô tả sản phẩm là gì, thường là một hệ thống phân cấp từ một gốc rộng đến một lá cụ thể - ví dụ: ["Footwear", "Athletic", "Running Shoes"]. Các danh mục chính xác giữ cho danh mục của bạn sạch sẽ và cung cấp cho các quy trình hạ lưu như phân loại và tuân thủ thương mại, nơi mà một sản phẩm được phân loại sai có thể tạo ra kết quả sai.
Các danh mục tích lũy các lỗi phân loại theo thời gian - từ nhập liệu thủ công, nguồn cấp từ nhà cung cấp hoặc di chuyển giữa các hệ thống. Zonos Category Validation kiểm tra xem các danh mục được gán cho một mục có thực sự mô tả mục đó hay không, và khi chúng không phù hợp, nó gợi ý các danh mục tốt hơn được rút ra từ các danh mục mà tổ chức của bạn đã sử dụng.
Cách hoạt động
Zonos Category Validation sử dụng AI để đánh giá xem liệu hệ thống phân cấp danh mục bạn cung cấp có mô tả chính xác một mục hay không, dựa trên tên mục name và bất kỳ chi tiết bổ sung nào bạn cung cấp như brand, material và description.
Đối với mỗi mục, nó trả về một verdict là CORRECT hoặc WRONG cùng với một điểm độ tin cậy. Khi verdict là WRONG, nó trả về một danh sách các danh mục được gợi ý được xếp hạng để bạn có thể sửa lỗi gán danh mục. Các gợi ý được rút ra từ cây danh mục của tổ chức bạn - tập hợp các đường dẫn danh mục mà tổ chức của bạn sử dụng - và bất kỳ danh mục nào bạn gửi đều được thêm vào cây đó tự động, vì vậy một cây được bảo trì tốt sẽ tạo ra các gợi ý tốt hơn theo thời gian.
Đây là một endpoint batch - bạn có thể xác thực nhiều mục trong một yêu cầu duy nhất và các kết quả được trả về theo cùng thứ tự với đầu vào.
Verdict và độ tin cậy
Mỗi kết quả bao gồm một verdict:
CORRECT— mục có khả năng thuộc về các danh mục được gán.WRONG— mục không thuộc về các danh mục được gán.
Mỗi kết quả cũng bao gồm một confidenceScore giữa 0.0 và 1.0 cho biết mô hình tin tưởng như thế nào vào verdict nó trả về. Điểm phản ánh sự chắc chắn trong chính verdict, vì vậy một kết quả WRONG tự tin sẽ có một confidenceScore cao cũng như một kết quả CORRECT tự tin. Khi verdict là WRONG, danh sách suggestedCategories chứa các hệ thống phân cấp danh mục thay thế, mỗi cái có một giá trị confidence và được sắp xếp từ khả năng cao nhất đến thấp nhất. Khi verdict là CORRECT, suggestedCategories rỗng.
Chúng tôi khuyên bạn sử dụng điểm độ tin cậy để quyết định kết quả nào được chấp nhận tự động và kết quả nào được định tuyến để xem xét thủ công.
Xác thực danh mục
Để xác thực danh mục, hãy sử dụng mutation categoriesValidate. Mỗi mục yêu cầu một tên name và hệ thống phân cấp categories để xác thực. Bạn có thể tùy chọn bao gồm brand, material, description, amount, currencyCode, globalTradeItemNumber và imageUrl để cải thiện độ chính xác. Gửi nhiều mục trong một yêu cầu duy nhất để xác thực hàng loạt.
mutation CategoriesValidate($input: [CategoryValidateInput!]!) { categoriesValidate(input: $input) { id name categories verdict confidenceScore suggestedCategories { category confidence } }}Trong ví dụ trên, các danh mục của mục đầu tiên được xác nhận là CORRECT với độ tin cậy cao và không có gợi ý. Mục thứ hai được đánh dấu WRONG một cách tự tin, và danh sách suggestedCategories đề xuất các danh mục phù hợp hơn được xếp hạng theo độ tin cậy.
Quản lý cây danh mục của bạn
Cây danh mục của tổ chức bạn là tập hợp các đường dẫn danh mục mà Zonos biết tổ chức của bạn sử dụng. Category Validation lấy suggestedCategories của nó từ cây này, vì vậy việc giữ nó chính xác và hoàn chỉnh sẽ trực tiếp cải thiện chất lượng các gợi ý. Các danh mục bạn gửi tới categoriesValidate được thêm vào cây tự động, nhưng bạn cũng có thể quản lý nó trực tiếp.
Mỗi danh mục là một hệ thống phân cấp được lưu trữ dưới dạng mảng path, từ gốc rộng đến lá cụ thể - ví dụ: ["Footwear", "Athletic", "Running Shoes"].
Liệt kê các danh mục của bạn
Sử dụng query categories để lấy cây danh mục của tổ chức bạn. Kết quả được phân trang.
query Categories { categories(first: 50) { totalCount edges { node { id path } } }}Thêm danh mục
Sử dụng mutation categoriesCreate để thêm một hoặc nhiều đường dẫn danh mục vào cây của bạn. Điều này hữu ích để khởi tạo cây trước khi xác thực để các gợi ý có thể sử dụng toàn bộ phân loại của bạn.
mutation CategoriesCreate($input: [CategoryCreateInput!]!) { categoriesCreate(input: $input) { id path }}Cập nhật hoặc xóa danh mục
Sử dụng mutation categoryUpdate để sửa lỗi path của danh mục theo id của nó, hoặc mutation categoryDelete để xóa danh mục không còn áp dụng nữa. Loại bỏ các danh mục cũ hoặc không chính xác giữ cho các gợi ý liên quan.
mutation CategoryUpdate($input: CategoryUpdateInput!) { categoryUpdate(input: $input) { id path }}Để xóa danh mục, hãy chuyển id của nó tới mutation categoryDelete. Nó trả về SUCCESS hoặc FAILURE.
mutation CategoryDelete($id: ID!) { categoryDelete(id: $id)}
Xác thực Danh mục
Kiểm tra xem danh mục được gán có phù hợp với sản phẩm hay không, và nhận các gợi ý danh mục tốt hơn khi chúng không phù hợp.