Shopify yapay zekâ ürün çevirisi iş akışı araştırması

İhtiyacınız olan çeviri yolunu seçin

Bir editör çevirileri doğrudan yönetebiliyorsa Shopify'ın satıcı araçlarını kullanın. Tekrarlanabilir bir harici inceleme kuyruğuna ve uygulamayı sürdürebilecek bir geliştiriciye ihtiyacınız varsa GraphQL Admin API'yi kullanın. API yolunda ayrı bir model istemcisi metin taslağı oluşturur, Shopify saklanan çevirileri yönetir.

Bir geliştirme mağazası ve tek bir ürünle başlayın. Çevrilebilir alanlarını okuyun, bir aday hazırlayın, inceleme alın ve ancak sonra amaçlanan değişiklikleri gönderin. Her adım bağımsız incelenip düzeltilebilsin diye model ayarlarını, mağaza kimlik bilgilerini ve yayım izinlerini ayrı tutun.

Satıcı iş akışı veya uygulama seçin

Shopify Translate & Adapt dokümantasyonu, yayımdan önce inceleme ile manuel düzenlemeyi ve otomatik çeviriyi açıklar. Satıcı bir uygulama kurmadan doğrudan editoryal kontrol istiyorsa bu yeterli olabilir. Özel entegrasyon yalnızca harici inceleme kuyruğu gibi belirli bir gereksinim bağlayıcıyı sahiplenmeyi haklı çıkarıyorsa anlamlıdır.

İnceleme kuyruğunu ve alan eşlemesini kimin sürdüreceğine göre seçim yapın. Üçüncü taraf uygulamada kurulumunu, izinlerini ve dışa aktarma davranışını kurmadan önce inceleyin. Satıcıya dönük editör ile harici model taslağı yapan uygulama farklı operasyonel ihtiyaçları çözer.

Kimlik doğrulama ve sürüm sınırlarını planlayın

translatableResource başvurusu read_translations, translationsRegister ise write_translations gerektirir. Test ederken bir geliştirme mağazası kullanın ve uygulama kurulumunu, API sürümünü ve verilen kapsamları kaydedin. Bir LLM ağ geçidi kimlik bilgisi Shopify Admin API isteğini doğrulamaz; Shopify tokenı da model uç noktasına gönderilmemelidir.

Uygulama tasarımı izin veriyorsa keşif için salt okunur erişimle başlayın. Sonraki yetkili iş akışı için gereken izinleri yalnızca gerektiği kadar ekleyin. Başvuruyu kontrol etmeden kaydedilmemiş latest takma adına dağıtmak yerine desteklenen bir API sürümünü sabitleyin. Tokenları sunucu tarafında tutun ve inceleme dışa aktarmalarından ile istek günlüklerinden çıkarın.

Çevrilebilir alanları digest'leriyle okuyun

Belgelenen sorgu kaynak tanımlayıcısı ile key, value, digest ve locale içeren çevrilebilir girdileri döndürür. Bu alana özgü digest'leri kaynak görüntüsüyle saklayın. Önerilen çeviriyi elektronik tablodan kopyalanmış ürün başlığına değil, gerçekten okunan içeriğe bağlar.

Aşağıdaki sorgu resmî şemadan salt okunur örnek olarak uyarlanmıştır. Yetkili bir ürün GID'sini geliştirme ortamında sağlayın. Dönen anahtarları inceleyin ve açık alan allowlist'i kullanın; kaynak locale'ini tarayıcı dilinden çıkarmak yerine dönen değeri kullanın.

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

Shopify dışında bir çeviri adayı üretin

Kaynak kimliği, alan anahtarı, kaynak digest'i, hedef locale, sözlük revizyonu ve taslak değerini içeren dahili bir aday kaydı oluşturun. Modele yalnızca metni ve gerekli ürün bağlamını gönderin. SKU, fiyat, para birimi, envanter ve varyant kimliğini üretilen yamadan uzak tutun.

İki dilli inceleyen adayı görmeden önce gerekli metni, yer tutucuları ve onaylı terminolojiyi doğrulayın. Ürün inceleyeninin iddiaları ve uyarıları özgün kaynakla kontrol etmesini sağlayın. Mağazayı çeviren bir tarayıcı uzantısı bu kaydı oluşturmaz ve Shopify'ın çeviriyi sakladığını kanıtlamaz; yalnızca inceleme yardımcısıdır.

Yalnızca güncel ve onaylanmış çevirileri kaydedin

translationsRegister mutasyonu translatableContentDigest içeren çevrilmiş alanları kabul eder. Belgelenen sonucu userErrors dahil inceleyin; yalnızca HTTP yanıtını başarılı kayıt kanıtı saymayın.

Yetkili yazmadan önce güncel kaynağı incelenmiş görüntüyle karşılaştırın. Değiştiyse adayı bekletin ve yeni inceleme alın. Amaçlanan alan değişikliklerinin ve kurtarma için önceki çevirilerin açık listesini tutun. Geliştirme mağazasında tek alanla başlayın, yamayı genişletmeden önce geri okuyun.

Mağazayı ayrıca doğrulayın

Shopify'ın belgelenmiş iş akışında saklanan çeviri ile mağazada kullanılabilirlik ayrı kontrol noktalarıdır. Locale yapılandırmasını ve tema kontrollerini satıcıyla planlayın. Çevrilmiş bir değeri kaydetmek bir dili yayımlamayı veya pazar ayarlarını değiştirmeyi otomatik olarak yetkilendirmemelidir.

Geliştirme mağazasında hedef ürünü, locale seçiciyi, geri dönüş içeriğini, bağlantıları ve varyant etiketlerini inceleyin. Saklanan çeviriyi geri okuyup onaylı değerle karşılaştırın. Bir alan yoksa yeni çeviri üretmeden önce kaynak desteğini veya tema oluşturmasını araştırın. Gözlemleri canlı satıcı başarısı olarak sunmadan koruyun.

Kanıt ve bağlayıcı sınırları

Resmî başvurular Shopify çeviri arayüzlerini oluşturur. APIsRouter'a bağlı bir uygulama burada test edilmedi ve incelenen kaynaklar Shopify veya Translate & Adapt içinde keyfî bir ağ geçidi baseURL ayarını kanıtlamıyor. Geliştirme mağazası sonucu oluşana kadar özel uygulama yolunu bağlayıcı araştırması sayın.

Eksiksiz bir test için uygulama sürümünü, kapsamlandırılmış kimlik doğrulama kaydını, kaynak sorgusunu, adayı, onayı, kayıt sonucunu ve geri okuma karşılaştırmasını saklayın. Bir kaynak değişikliği çatışmasını ve reddedilen isteği dahil edin. Son uyumluluk iddiasının sınırı açık olsun diye model kimliğini ve kullanımı mağaza işlemlerinden ayrı kaydedin.

Sık sorulan sorular