بحث سير عمل ترجمة منتجات Shopify بالذكاء الاصطناعي

اختر مسار الترجمة الذي تحتاجه

استخدم أدوات التاجر في Shopify عندما يستطيع محرر إدارة الترجمات مباشرة. استخدم GraphQL Admin API عندما تحتاج إلى قائمة انتظار مراجعة خارجية قابلة للتكرار ويستطيع مطور صيانة التطبيق. في مسار API، يصوغ عميل نموذج منفصل النص بينما تتولى Shopify الترجمات المخزنة.

ابدأ بمتجر تطوير ومنتج واحد. اقرأ حقوله القابلة للترجمة، وجهّز مرشحًا، واحصل على المراجعة، ثم أرسل التغييرات المقصودة فقط. أبقِ إعدادات النموذج وبيانات اعتماد المتجر وأذونات النشر منفصلة حتى يمكن فحص كل خطوة وتصحيحها بصورة مستقلة.

اختر سير عمل تاجر أو تطبيقًا

تصف وثائق Translate & Adapt في Shopify التحرير اليدوي والترجمة الآلية مع المراجعة قبل النشر. قد يكفي ذلك عندما يريد التاجر تحكمًا تحريريًا مباشرًا من دون بناء تطبيق. لا يكون التكامل المخصص منطقيًا إلا عندما تبرر حاجة محددة، مثل قائمة مراجعة خارجية، امتلاك الموصل.

اختر وفق من سيصون قائمة المراجعة وتعيين الحقول. في تطبيق طرف ثالث، افحص التهيئة الموثقة والأذونات وسلوك التصدير قبل تثبيته. يحل محرر موجه للتاجر وتطبيق يصوغ بواسطة نموذج خارجي احتياجات تشغيلية مختلفة.

خطّط لحدود المصادقة والإصدار

يتطلب مرجع translatableResource صلاحية read_translations؛ وتتطلب طفرة translationsRegister صلاحية write_translations. استخدم متجر تطوير وسجّل تثبيت التطبيق وإصدار API والنطاقات الممنوحة أثناء الاختبار. لا تصادق بيانات اعتماد بوابة LLM على طلب Shopify Admin API، ولا يجوز إرسال رمز Shopify إلى نقطة نهاية النموذج.

ابدأ بوصول القراءة للاكتشاف عندما يسمح تصميم التطبيق. أضف الصلاحيات اللازمة لسير العمل المصرح به لاحقًا فقط. ثبّت إصدار API مدعومًا بعد فحص مرجعه بدل النشر على alias latest غير مسجل. أبقِ الرموز على الخادم واستبعدها من صادرات المراجعة وسجلات الطلب.

اقرأ الحقول القابلة للترجمة مع بصماتها

يعيد الاستعلام الموثق معرّف مورد وإدخالات قابلة للترجمة تحتوي على المفتاح والقيمة والبصمة واللغة المحلية. احتفظ بهذه البصمات الخاصة بالحقول مع لقطة المصدر. فهي تربط الترجمة المقترحة بالمحتوى المقروء فعليًا لا بعنوان منتج منسوخ من جدول.

الاستعلام أدناه مثال للقراءة فقط مقتبس من المخطط الرسمي. قدّم GID لمنتج مصرح به في بيئة تطوير. افحص المفاتيح المعادة واستخدم قائمة حقول مسموحة صريحة؛ واستخدم لغة المصدر المعادة بدل استنتاجها من لغة المتصفح.

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

ولّد مرشح ترجمة خارج Shopify

أنشئ سجل مرشح داخليًا يتضمن معرّف المورد ومفتاح الحقل وبصمة المصدر واللغة المستهدفة ومراجعة المسرد وقيمة المسودة. أرسل النص وسياق المنتج اللازم فقط إلى النموذج. أبقِ SKU والسعر والعملة والمخزون وهوية المتغير خارج التصحيح المولّد.

تحقق من النص المطلوب والمحارف النائبة والمصطلحات المعتمدة قبل عرض المرشح على مراجع ثنائي اللغة. اطلب من مراجع المنتج فحص الادعاءات والتحذيرات مقابل المصدر الأصلي. لا تنشئ إضافة متصفح تترجم واجهة المتجر هذا السجل ولا تثبت أن Shopify خزنت ترجمة؛ إنها أداة فحص فقط.

سجّل الترجمات الحالية المعتمدة فقط

تقبل طفرة translationsRegister حقولًا مترجمة مع translatableContentDigest. وتتضمن نتيجتها الموثقة userErrors. يجب على الموصل فحص النتيجة بدل اعتبار استجابة HTTP وحدها دليل نجاح التسجيل.

قبل كتابة مصرح بها، قارن المصدر الحالي باللقطة التي راجعها البشر. إذا تغير، فأوقف المرشح واحصل على مراجعة جديدة. احتفظ بقائمة صريحة لتغييرات الحقول المقصودة والترجمات السابقة للاستعادة. ابدأ بحقل واحد في متجر التطوير واقرأه بعد ذلك قبل توسيع التصحيح.

تحقق من واجهة المتجر بصورة منفصلة

الترجمة المخزنة وتوفرها في واجهة المتجر نقطتا تحقق منفصلتان في سير Shopify الموثق. خطّط لإعداد اللغة وفحوص القالب مع التاجر. لا ينبغي لحفظ قيمة مترجمة أن يجيز تلقائيًا نشر لغة أو تغيير إعدادات السوق.

في متجر التطوير، افحص المنتج الهدف ومحدد اللغة ومحتوى fallback والروابط وتسميات المتغيرات. اقرأ الترجمة المخزنة وقارنها بالقيمة المعتمدة. إذا غاب حقل، فحقق في دعم المورد أو عرض القالب قبل توليد ترجمة أخرى. احتفظ بالملاحظات دون تقديم متجر تطوير كنجاح تاجر حي.

الأدلة وحدود الموصل

تثبت المراجع الرسمية واجهات ترجمة Shopify. لم يُختبر هنا تطبيق متصل بـ APIsRouter، ولا تثبت المصادر المراجعة إعداد baseURL عشوائيًا لبوابة في Shopify أو Translate & Adapt. تعامل مع مسار التطبيق المخصص كبحث موصل حتى تتوفر نتيجة من متجر تطوير.

لاختبار كامل، احتفظ بإصدار التطبيق وسجل المصادقة المحدد والاستعلام المصدر والمرشح والموافقة ونتيجة التسجيل ومقارنة القراءة اللاحقة. أدرج تعارض تغيير المصدر وطلبًا مرفوضًا. سجّل هوية النموذج واستخدامه منفصلين عن عمليات المتجر حتى يكون ادعاء التوافق محدد النطاق.

الأسئلة الشائعة