Nghiên cứu quy trình dịch sản phẩm Shopify bằng AI

Chọn đường dịch cần

Dùng công cụ merchant Shopify khi biên tập viên có thể quản lý bản dịch trực tiếp. Dùng GraphQL Admin API khi cần hàng đợi rà soát bên ngoài có thể lặp và developer có thể duy trì ứng dụng. Ở đường API, client model riêng soạn văn bản trong khi Shopify xử lý bản dịch đã lưu.

Bắt đầu với cửa hàng phát triển và một sản phẩm. Đọc trường có thể dịch, chuẩn bị ứng viên, lấy rà soát rồi mới gửi thay đổi dự kiến. Giữ cài đặt model, credential cửa hàng và quyền xuất bản riêng để từng bước có thể kiểm tra và sửa độc lập.

Chọn workflow merchant hay ứng dụng

Tài liệu Translate & Adapt của Shopify mô tả chỉnh sửa thủ công và dịch tự động, có rà soát trước xuất bản. Có thể đủ khi merchant muốn kiểm soát biên tập trực tiếp mà không xây ứng dụng. Tích hợp tùy chỉnh chỉ phù hợp khi yêu cầu cụ thể, như hàng đợi rà soát ngoài, đáng để sở hữu connector.

Chọn theo người duy trì hàng đợi và ánh xạ trường. Với app bên thứ ba, kiểm tra cấu hình, quyền và hành vi export được ghi nhận trước khi cài. Editor hướng merchant và ứng dụng soạn model ngoài giải quyết nhu cầu vận hành khác nhau.

Lập kế hoạch xác thực và ranh giới version

Tham chiếu translatableResource cần read_translations; translationsRegister cần write_translations. Dùng cửa hàng phát triển và ghi app installation, API version cùng scope được cấp khi test. Credential gateway LLM không xác thực request Shopify Admin API, và token Shopify không được gửi tới endpoint model.

Bắt đầu bằng quyền đọc để discovery khi thiết kế cho phép. Chỉ thêm quyền cần cho workflow được ủy quyền về sau. Pin version API được hỗ trợ sau khi kiểm tra tham chiếu thay vì triển khai alias latest không ghi. Giữ token phía server và loại khỏi export review cùng log request.

Đọc trường có thể dịch cùng digest

Query được ghi nhận trả resource identifier và entry có thể dịch gồm key, value, digest cùng locale. Giữ digest theo trường với snapshot nguồn. Chúng nối bản dịch đề xuất với nội dung thật đã đọc, thay vì title sản phẩm sao chép từ bảng tính.

Query bên dưới điều chỉnh từ schema chính thức như ví dụ chỉ đọc. Cung cấp product GID được ủy quyền trong môi trường phát triển. Kiểm tra key trả về và dùng allowlist trường rõ; dùng locale nguồn trả về thay vì suy từ ngôn ngữ browser.

query TranslationSource($resourceId: ID!) {
  translatableResource(resourceId: $resourceId) {
    resourceId
    translatableContent {
      key
      value
      digest
      locale
    }
  }
}

Tạo ứng viên dịch bên ngoài Shopify

Tạo record ứng viên nội bộ gồm resource ID, field key, source digest, target locale, bản sửa glossary và draft value. Chỉ gửi text cùng ngữ cảnh sản phẩm cần cho model. Giữ SKU, giá, tiền tệ, tồn kho và danh tính biến thể ngoài patch.

Xác thực text bắt buộc, placeholder và thuật ngữ đã duyệt trước khi biên tập song ngữ thấy ứng viên. Người rà soát sản phẩm kiểm tra khẳng định và cảnh báo với nguồn gốc. Extension dịch storefront không tạo record hay chứng minh Shopify đã lưu bản dịch; nó chỉ hỗ trợ kiểm tra.

Chỉ đăng ký bản dịch hiện tại đã duyệt

Mutation translationsRegister nhận trường đã dịch với translatableContentDigest. Kết quả ghi nhận gồm userErrors. Connector phải kiểm tra kết quả đó thay vì coi response HTTP một mình là bằng chứng đăng ký thành công.

Trước ghi được ủy quyền, so nguồn hiện tại với snapshot đã rà soát. Nếu đổi, giữ ứng viên và lấy review mới. Giữ danh sách trường định đổi cùng bản dịch trước để khôi phục. Bắt đầu một trường trong cửa hàng phát triển và đọc lại trước khi mở rộng patch.

Xác minh storefront riêng

Bản dịch đã lưu và khả dụng storefront là checkpoint riêng trong workflow Shopify. Lập kế hoạch cấu hình locale cùng kiểm tra theme với merchant. Lưu giá trị dịch không tự ủy quyền xuất bản ngôn ngữ hay đổi cài đặt thị trường.

Trong cửa hàng phát triển, kiểm tra sản phẩm đích, bộ chọn locale, nội dung fallback, liên kết và nhãn biến thể. Đọc bản dịch lưu lại và so với giá trị đã duyệt. Nếu thiếu trường, điều tra hỗ trợ resource hoặc render theme trước khi tạo bản dịch khác. Giữ quan sát mà không trình bày cửa hàng phát triển như thành công merchant thực.

Bằng chứng và giới hạn connector

Tham chiếu chính thức xác lập giao diện dịch Shopify. Ứng dụng kết nối APIsRouter chưa được test ở đây, và nguồn rà soát không xác lập cài đặt baseURL gateway tùy ý trong Shopify hay Translate & Adapt. Coi đường ứng dụng tùy chỉnh là nghiên cứu connector cho tới khi có kết quả cửa hàng phát triển.

Test hoàn chỉnh cần giữ version app, hồ sơ auth theo scope, query nguồn, ứng viên, phê duyệt, kết quả đăng ký và so sánh đọc lại. Bao gồm xung đột nguồn đổi và request bị từ chối. Ghi danh tính model cùng usage riêng với vận hành cửa hàng để khẳng định tương thích có phạm vi rõ.

Câu hỏi thường gặp