Penyelidikan aliran kerja terjemahan produk AI Shopify

Pilih laluan terjemahan yang diperlukan

Gunakan alat pedagang Shopify apabila editor boleh mengurus terjemahan secara terus. Gunakan GraphQL Admin API apabila anda memerlukan baris gilir semakan luaran yang boleh diulang dan pembangun boleh menyelenggara aplikasi itu. Dalam laluan API, klien model berasingan mendraf teks sementara Shopify mengendalikan terjemahan yang disimpan.

Mulakan dengan development store dan satu produk. Baca medan boleh terjemahnya, sediakan calon, dapatkan semakan dan hanya selepas itu hantar perubahan yang dimaksudkan. Asingkan tetapan model, kelayakan kedai dan kebenaran penerbitan supaya setiap langkah boleh diperiksa dan dibetulkan secara bebas.

Pilih aliran kerja pedagang atau aplikasi

Dokumentasi Translate & Adapt Shopify menerangkan penyuntingan manual dan terjemahan automatik, dengan semakan sebelum penerbitan. Itu mungkin memadai apabila pedagang mahukan kawalan editorial terus tanpa membina aplikasi. Integrasi tersuai hanya wajar apabila keperluan khusus, seperti baris gilir semakan luaran, mengjustify pemilikan penyambung.

Pilih berdasarkan pihak yang akan menyelenggara baris gilir semakan dan pemetaan medan. Untuk aplikasi pihak ketiga, periksa konfigurasi, kebenaran dan tingkah laku eksport yang didokumentasikan sebelum pemasangan. Editor untuk pedagang dan aplikasi dengan draf model luaran menyelesaikan keperluan operasi yang berbeza.

Rancang pengesahan dan sempadan versi

Rujukan translatableResource memerlukan read_translations; translationsRegister memerlukan write_translations. Gunakan development store dan rekod pemasangan aplikasi, versi API serta skop yang diberikan ketika menguji. Kelayakan gateway LLM tidak mengesahkan permintaan Shopify Admin API, dan token Shopify tidak boleh dihantar ke endpoint model.

Mulakan dengan akses baca untuk penemuan apabila reka bentuk aplikasi membenarkannya. Tambah kebenaran yang diperlukan sahaja untuk aliran kerja yang dibenarkan kemudian. Pin versi API yang disokong selepas menyemak rujukannya dan jangan deploy menggunakan alias latest yang tidak direkodkan. Simpan token di sisi pelayan dan keluarkan token daripada eksport semakan serta log permintaan.

Baca medan boleh terjemah bersama digestnya

Pertanyaan yang didokumentasikan memulangkan pengecam resource dan entri boleh terjemah dengan key, value, digest dan locale. Kekalkan digest khusus medan ini bersama snapshot sumber. Ia menghubungkan terjemahan yang dicadangkan kepada kandungan yang benar-benar dibaca, bukan kepada tajuk produk yang disalin daripada hamparan.

Pertanyaan di bawah diadaptasi daripada skema rasmi sebagai contoh baca sahaja. Bekalkan GID produk yang dibenarkan dalam persekitaran pembangunan. Periksa key yang dipulangkan dan gunakan allowlist medan yang jelas; gunakan locale sumber yang dipulangkan dan jangan membuat kesimpulan daripadanya berdasarkan bahasa pelayar.

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

Jana calon terjemahan di luar Shopify

Bina rekod calon dalaman yang mengandungi resource ID, field key, source digest, target locale, semakan glosari dan nilai draf. Hantar teks serta konteks produk yang diperlukan sahaja kepada model. Keluarkan SKU, harga, mata wang, inventori dan identiti varian daripada tampalan yang dijana.

Sahkan teks yang diperlukan, placeholder dan istilah yang diluluskan sebelum penyemak dwibahasa melihat calon itu. Minta penyemak produk memeriksa dakwaan dan amaran terhadap sumber asal. Sambungan pelayar yang menterjemah storefront tidak mencipta rekod ini atau membuktikan bahawa Shopify telah menyimpan terjemahan; ia hanya alat pemeriksaan.

Daftar terjemahan yang diluluskan dan semasa sahaja

Mutasi translationsRegister menerima medan terjemahan dengan translatableContentDigest. Hasil yang didokumentasikan merangkumi userErrors. Penyambung mesti memeriksa hasil itu dan tidak menganggap respons HTTP sahaja sebagai bukti pendaftaran yang berjaya.

Sebelum penulisan yang dibenarkan, bandingkan sumber semasa dengan snapshot yang disemak. Jika berubah, tahan calon dan dapatkan semakan baharu. Kekalkan senarai medan perubahan yang dimaksudkan dan terjemahan terdahulu untuk pemulihan. Mulakan dengan satu medan dalam development store dan baca semula medan itu sebelum mengembangkan tampalan.

Sahkan storefront secara berasingan

Terjemahan yang disimpan dan ketersediaan storefront ialah checkpoint berasingan dalam aliran kerja Shopify yang didokumentasikan. Rancang konfigurasi locale dan semakan tema bersama pedagang. Menyimpan nilai terjemahan tidak sepatutnya secara automatik membenarkan penerbitan bahasa atau perubahan tetapan pasaran.

Dalam development store, periksa produk sasaran, pemilih locale, kandungan fallback, pautan dan label varian. Baca semula terjemahan tersimpan dan bandingkannya dengan nilai yang diluluskan. Jika medan tiada, siasat sokongan resource atau pemaparan tema sebelum menjana terjemahan lain. Kekalkan pemerhatian tanpa membentangkan development store sebagai kejayaan pedagang langsung.

Bukti dan had penyambung

Rujukan rasmi mengesahkan antara muka terjemahan Shopify. Aplikasi yang disambungkan kepada APIsRouter belum diuji di sini, dan sumber yang disemak tidak mengesahkan tetapan baseURL gateway sewenang-wenangnya dalam Shopify atau Translate & Adapt. Anggap laluan aplikasi tersuai sebagai penyelidikan penyambung sehingga ia mempunyai hasil daripada development store.

Untuk ujian lengkap, kekalkan versi aplikasi, rekod pengesahan berskop, pertanyaan sumber, calon, kelulusan, hasil pendaftaran dan perbandingan baca balik. Sertakan konflik perubahan sumber dan permintaan yang ditolak. Rekod identiti model dan penggunaan secara berasingan daripada operasi kedai supaya dakwaan keserasian yang terhasil mempunyai skop yang jelas.

Soalan lazim