Badanie procesu tłumaczenia produktów Shopify z AI

Wybierz potrzebną ścieżkę tłumaczenia

Narzędzi sprzedawcy Shopify używaj, gdy edytor może bezpośrednio zarządzać tłumaczeniami. GraphQL Admin API wybierz, gdy potrzebujesz powtarzalnej zewnętrznej kolejki przeglądu i deweloper może utrzymywać aplikację. W ścieżce API osobny klient modelu tworzy szkic tekstu, a Shopify obsługuje zapisane tłumaczenia.

Zacznij od sklepu deweloperskiego i jednego produktu. Odczytaj jego pola podlegające tłumaczeniu, przygotuj kandydata, uzyskaj przegląd i dopiero wtedy prześlij zamierzone zmiany. Ustawienia modelu, dane uwierzytelniające sklepu i uprawnienia publikacji przechowuj osobno, aby każdy etap można było niezależnie przejrzeć i poprawić.

Wybierz proces sprzedawcy albo aplikację

Dokumentacja Shopify Translate & Adapt opisuje ręczną i automatyczną translację z przeglądem przed publikacją. Może to wystarczyć, gdy sprzedawca chce bezpośredniej kontroli redakcyjnej bez budowania aplikacji. Niestandardowa integracja ma sens tylko wtedy, gdy konkretne wymaganie, takie jak zewnętrzna kolejka przeglądu, uzasadnia utrzymywanie konektora.

Wybierz według tego, kto będzie utrzymywał kolejkę przeglądu i mapowanie pól. W przypadku aplikacji zewnętrznej przed instalacją przeanalizuj jej udokumentowaną konfigurację, uprawnienia i zachowanie eksportu. Edytor dla sprzedawcy i aplikacja z zewnętrznym tworzeniem szkiców modelu rozwiązują inne potrzeby operacyjne.

Zaplanuj granice uwierzytelniania i wersji

Odwołanie translatableResource wymaga read_translations, a translationsRegister wymaga write_translations. Do testów użyj sklepu deweloperskiego i zapisz instalację aplikacji, wersję API oraz przyznane zakresy. Dane uwierzytelniające gatewaya LLM nie uwierzytelniają żądania Shopify Admin API, a token Shopify nie może być wysłany do endpointu modelu.

Jeśli projekt aplikacji na to pozwala, zacznij od dostępu tylko do odczytu na potrzeby odkrywania. Dodaj wyłącznie uprawnienia potrzebne w późniejszym autoryzowanym procesie. Przypnij obsługiwaną wersję API po sprawdzeniu jej dokumentacji, zamiast wdrażać nieodnotowany alias latest. Tokeny przechowuj po stronie serwera i wyklucz je z eksportów przeglądu oraz logów żądań.

Odczytaj pola tłumaczalne wraz z digestami

Udokumentowane zapytanie zwraca identyfikator zasobu oraz wpisy tłumaczalne z kluczem, wartością, digestem i locale. Te digesty właściwe dla pól zachowaj przy migawce źródła. Łączą proponowane tłumaczenie z rzeczywiście odczytaną treścią, a nie z tytułem produktu skopiowanym z arkusza.

Poniższe zapytanie jest dostosowanym, tylko do odczytu przykładem opartym na oficjalnym schemacie. W środowisku deweloperskim przekaż autoryzowany identyfikator produktu GID. Przejrzyj zwrócone klucze i użyj jawnej listy dozwolonych pól; korzystaj ze zwróconego locale źródłowego, zamiast wnioskować o nim z języka przeglądarki.

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

Utwórz kandydata tłumaczenia poza Shopify

Utwórz wewnętrzny rekord kandydata zawierający ID zasobu, klucz pola, digest źródła, locale docelowe, rewizję glosariusza i wartość szkicu. Do modelu wyślij tylko tekst i potrzebny kontekst produktu. SKU, cenę, walutę, zapasy i tożsamość wariantu trzymaj poza wygenerowanym patchem.

Przed pokazaniem kandydata redaktorowi dwujęzycznemu zweryfikuj wymagany tekst, placeholdery i zatwierdzoną terminologię. Recenzent produktu powinien sprawdzić twierdzenia i ostrzeżenia względem oryginalnego źródła. Rozszerzenie przeglądarki tłumaczące sklep nie tworzy tego rekordu ani nie dowodzi, że Shopify zapisał tłumaczenie; jest tylko pomocą inspekcyjną.

Rejestruj wyłącznie aktualne, zaakceptowane tłumaczenia

Mutacja translationsRegister przyjmuje przetłumaczone pola z translatableContentDigest. Jej udokumentowany wynik zawiera userErrors. Konektor musi przeanalizować ten wynik, zamiast traktować samą odpowiedź HTTP jak dowód udanej rejestracji.

Przed autoryzowanym zapisem porównaj aktualne źródło z przejrzaną migawką. Jeśli się zmieniło, wstrzymaj kandydata i uzyskaj nowy przegląd. Zachowaj jawną listę zamierzonych zmian pól oraz wcześniejszych tłumaczeń na potrzeby odzyskiwania. Zacznij od jednego pola w sklepie deweloperskim i odczytaj je ponownie, zanim rozszerzysz patch.

Osobno zweryfikuj storefront

Zapisane tłumaczenie i dostępność w storefront są osobnymi punktami kontrolnymi w udokumentowanym procesie Shopify. Zaplanuj konfigurację locale i kontrole motywu wspólnie ze sprzedawcą. Zapisanie przetłumaczonej wartości nie powinno automatycznie upoważniać do publikacji języka ani zmiany ustawień rynku.

W sklepie deweloperskim przejrzyj produkt docelowy, selektor locale, treść fallbacku, linki i etykiety wariantów. Odczytaj zapisane tłumaczenie i porównaj je z zaakceptowaną wartością. Jeśli brakuje pola, zbadaj obsługę zasobu lub renderowanie motywu przed wygenerowaniem kolejnego tłumaczenia. Zachowaj obserwacje bez przedstawiania sklepu deweloperskiego jako sukcesu działającego sprzedawcy.

Dowody i granice konektora

Oficjalne odwołania ustanawiają interfejsy tłumaczeniowe Shopify. Połączenie aplikacji APIsRouter nie zostało tutaj przetestowane, a przejrzane źródła nie ustanawiają dowolnego ustawienia bazowego URL gatewaya w Shopify ani Translate & Adapt. Traktuj ścieżkę niestandardowej aplikacji jako badanie konektora do czasu uzyskania wyniku ze sklepu deweloperskiego.

Dla pełnego testu zachowaj wersję aplikacji, rekord uwierzytelniania z zakresami, zapytanie źródłowe, kandydata, akceptację, wynik rejestracji i porównanie odczytu zwrotnego. Dołącz konflikt zmienionego źródła i odrzucone żądanie. Tożsamość modelu i użycie rejestruj osobno od operacji sklepu, aby wynikowe twierdzenie o zgodności miało jasny zakres.

Częste pytania