تسريع سير العمل متعدد اللغات باستخدام حل ترجمة قابل للتخصيص تم إنشاؤه باستخدام Amazon Translate

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

ترجمة أمازون هي ملف الترجمة الآلية العصبية خدمة تقدم ترجمة لغة سريعة وعالية الجودة وبأسعار معقولة وقابلة للتخصيص. اليوم ، تدعم Amazon Translate ترجمة لغة قابلة للتطوير لما يزيد عن 5,500 تزاوج لغوي دفعة واحدة وفي الوقت الفعلي. يمكن استخدامه لبناء حلول تتعامل مع التحديات التي تواجهها المؤسسات ذات وحدات العمل المتعددة عند البحث عن طرق لتسريع تدفقات العمل متعددة اللغات مع دعم التخصيص.

على سبيل المثال، مجموعة BMW بحاجة إلى حل ترجمة موحد لمساعدة وحدات الأعمال الخاصة بهم ، مثل المبيعات والتصنيع ، واستخدام تقنية الترجمة على نطاق واسع وإزالة مشكلات الترجمة الخاطئة الشائعة عبر المؤسسة. حلهم مع ترجمة أمازون يقلل وقت الترجمة بأكثر من 75٪ مع منح كل وحدة عمل في نفس الوقت القدرة على تخصيص المخرجات لتلبية متطلبات الترجمة الخاصة بها.

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

حل نظرة عامة

يستخدم الحل الميزات الأصلية لـ Amazon Translate مثل الترجمة في الوقت الفعلي والكشف التلقائي للغة المصدر و المصطلحات المخصصة. عن طريق بوابة أمازون API، يتم الكشف عن هذه الميزات باعتبارها واحدة بسيطة /translate API. تتيح لك المصطلحات المخصصة تحديد أزواج ترجمة مخصصة. لكي تعمل المصطلحات المخصصة ، تحتاج إلى تحميل ملف مصطلحات على Amazon Translate. لذلك ، API آخر /customterm مكشوف.

يوضح الحل خيارين للترجمة: ترجمة قياسية وترجمة مخصصة (باستخدام ميزة المصطلحات المخصصة). ومع ذلك ، يمكنك تعديل هذه الخيارات حسب الحاجة لتناسب متطلبات عملك. يمكن للعملاء استخدام هذه الخيارات باستخدام API Gateway مفاتيح API. عندما تتلقى API طلب ترجمة ، فإنها تتحقق من صحة الطلب (باستخدام ملف AWS لامدا التفويض) ما إذا كان مفتاح API المقدم مصرحًا له بأداء نوع الترجمة المطلوبة. نحن نستخدم ملف الأمازون DynamoDB جدول لتخزين معلومات البيانات الوصفية حول المستهلكين والأذونات ومفاتيح واجهة برمجة التطبيقات.

يلبي هذا الحل ثلاثة أنواع من الشخصيات:

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

يوضح الرسم البياني التالي حل الترجمة المركزي مع بنية التخصيص.

بالنسبة إلى شخصية ترجمة المستخدم ، تتضمن العملية الإجراءات التالية (المسار الأزرق في الرسم التخطيطي السابق):

1a. اتصل ب /translate API وتمرير مفتاح API في رأس API. اختياريًا ، بالنسبة لشخصية الترجمة المخصصة ، يمكن للمستخدم تمكين الترجمة المخصصة عن طريق تمرير معلمة سلسلة طلب البحث الاختيارية (useCustomTerm).

2. تقوم بوابة API بالتحقق من صحة مفتاح API.

3. يتم استدعاء مُخوّل Lambda المخصص للتحقق من صحة الإجراء الذي يسمح بمفتاح API المزود. على سبيل المثال ، لا يمكن لشخصية الترجمة القياسية أن تطلب ترجمة مخصصة ، أو لا يمكن للمسؤول إجراء أي ترجمة نصية.

4. يحصل مفوض Lambda على معلومات المستخدم من جدول DynamoDB ويتحقق من مفتاح واجهة برمجة التطبيقات المقدم.

5a. بعد التحقق من الصحة ، يتم استدعاء وظيفة Lambda أخرى (الترجمة) لاستدعاء Amazon Translate API translate_text.

6a. يتم إرجاع النص المترجم في استجابة API.

يمكن لشخصية المسؤول تحميل ملف مصطلحات مخصص يمكن استخدامه بواسطة شخصية الترجمة المخصصة عن طريق الاتصال بـ /customterm API. فيما يلي خطوات سير العمل (المسار الأخضر في الرسم التخطيطي السابق):

1b. اتصل ب /customterm API وتمرير مفتاح API في رأس API.

2. تقوم بوابة API بالتحقق من صحة مفتاح API.

3. يتم استدعاء مُخوّل Lambda المخصص للتحقق من صحة الإجراء الذي يسمح بمفتاح API المزود. على سبيل المثال ، يمكن للشخص المسؤول فقط تحميل ملفات المصطلحات المخصصة.

4. يحصل مفوض Lambda على معلومات المستخدم من جدول DynamoDB ويتحقق من مفتاح واجهة برمجة التطبيقات المقدم.

5b. بعد التحقق من صحة مفتاح API ، يتم استدعاء وظيفة Lambda أخرى (تحميل) لاستدعاء Amazon Translate API import_terminology.

6b. يتم تحميل ملف المصطلحات المخصص إلى Amazon Translate باسم فريد تم إنشاؤه بواسطة وظيفة Lambda.

في الأقسام التالية ، نتصفح خطوات نشر الحل واختباره.

المتطلبات الأساسية المسبقة

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

لاحظ أنك مسؤول عن تكلفة خدمات AWS المستخدمة أثناء تشغيل نشر العينة هذا. تأتي العديد من هذه الخدمات (مثل Amazon Translate و API Gateway و Lambda) مع فئة مجانية لتبدأ بها. للحصول على التفاصيل الكاملة ، راجع صفحات التسعير لكل خدمة AWS تستخدمها في هذا المنشور.

انشر الحل باستخدام AWS CloudFormation

قم بتشغيل قالب CloudFormation المقدم لنشر الحل في حساب AWS الخاص بك. هذا المكدس يعمل فقط في us-east-1 or eu-west-1 المناطق. إذا كنت ترغب في نشر هذا الحل في مناطق أخرى ، فارجع إلى جيثب ريبو ونشر CloudFormation في المنطقة التي تختارها.

1. انشر أحدث قالب CloudFormation باتباع الرابط الخاص بالمنطقة المفضلة لديك:

بلد المنشأ	مكدس CloudFormation
إن فرجينيا (us-east-1)
أيرلندا (eu-west-1)

2. إذا طُلب منك ذلك ، قم بتسجيل الدخول باستخدام بيانات اعتماد حساب AWS الخاص بك.
3. اترك الحقول على إنشاء مكدس صفحة مع الإعدادات الافتراضية التي تم ملؤها مسبقًا.
4. اختار التالى.
5. في حالة اسم المكدس، أدخل اسم مكدس CloudFormation (لهذا المنشور ، EnterpriseTranslate).
6. في حالة DDBTableName¸ أدخل اسم جدول DynamoDB (EnterpriseTranslateTable).
7. في حالة اسم apiGatewayName، أدخل بوابة API التي تم إنشاؤها بواسطة المكدس (EnterpriseTranslateAPI).
8. في حالة apiGatewayStageName، أدخل اسم البيئة لبوابة API (prod).
9. اختار التالى.
10. في صفحة المراجعة ، حدد مربعات الاختيار للإقرار بإنشاء موارد IAM ، وهذا مطلوب للسماح لـ CloudFormation بإنشاء دور لمنح الوصول إلى الموارد التي يحتاجها المكدس وتسمية الموارد بطريقة ديناميكية.
11. اختار إنشاء مكدس.

يمكنك مراقبة تقدم إنشاء المكدس على الفعاليات التبويب. تكتمل المكدس عندما تظهر حالة المكدس كـ CREATE_COMPLETE.

ينشئ النشر الموارد التالية (جميعها مسبوقة بـ EntTranslate):

• API بوابة API مع مصدرين يسمى /customterm و /translate، مع ثلاثة مفاتيح لواجهة برمجة التطبيقات لتمثيل شخصيتين للترجمة وشخصية المسؤول
• جدول DynamoDB يحتوي على ثلاثة عناصر لتعكس مستهلكًا واحدًا له ثلاثة أدوار مختلفة (ثلاثة مفاتيح لواجهة برمجة التطبيقات)
• العديد من وظائف Lambda (باستخدام Python 3.9) حسب الرسم التخطيطي للهندسة المعمارية

بعد نشر الموارد في حسابك على سحابة AWS ، يمكنك اختبار الحل.

اجمع مفاتيح API

أكمل الخطوات التالية لتجميع مفاتيح API:

1. انتقل إلى النواتج علامة تبويب مكدس CloudFormation وانسخ قيمة المفتاح apiGatewayInvokeURLللعثور على مفاتيح API التي تم إنشاؤها بواسطة الحل ، ابحث في جدول DynamoDB الذي أنشأته للتو أو انتقل إلى صفحة مفاتيح API على وحدة تحكم بوابة API. يستخدم هذا المنشور النهج الأخير.
2. على الموارد علامة تبويب مكدس CloudFormation ، ابحث عن المعرف المنطقي EntTranslateApi لبوابة API وافتح الرابط الموجود أسفل ملف الهوية المادية عمود في علامة تبويب جديدة.
3. في وحدة تحكم API Gateway ، اختر مفاتيح API في جزء التنقل.
4. لاحظ مفاتيح API الثلاثة (القياسية ، والمخصصة ، والمشرف) التي تم إنشاؤها بواسطة الحل. على سبيل المثال ، حدد المفتاح القياسي EntTranslateCus1StandardTierKey واختر إظهار الارتباط مقابل خاصية مفتاح API.

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

الاختبار الأول: الترجمة القياسية

لاختبار واجهة برمجة تطبيقات الترجمة القياسية ، عليك أولاً إنشاء طلب POST في Postman.

1. اختار إضافة طلب في ساعي البريد.
2. اضبط نوع الطريقة على النحو سأعين.
3. أدخل بوابة API التي تستدعي عنوان URL من علامة تبويب الإخراج لمكدس CloudFormation المنشور.
4. أضف /translate إلى نقطة نهاية URL.
5. على رؤوس علامة التبويب ، أضف مفتاح رأس جديد اسمه x-api-key.
6. أدخل قيمة مفتاح API القياسية (تم نسخها في مرحلة تجميع مفاتيح API).
7. على الجسم علامة التبويب، حدد الخام وأدخل نص JSON على النحو التالي:

   {   "sourceText": "some text to translate",   "targetLanguage": "fr",   "sourceLanguage":"en"}

   sourceLanguage هي معلمة اختيارية. إذا لم تقدمه ، فسيقوم النظام بتعيينه كـ auto للكشف التلقائي عن لغة المصدر.

8. استدعاء API عن طريق الاختيار أرسل وتحقق من المخرجات.
   

يجب أن يعمل API بنجاح ويعيد النص المترجم بتنسيق الجسم قسم من كائن الاستجابة.

الاختبار الثاني: ترجمة مخصصة بمصطلحات مخصصة

لاختبار وظيفة تحميل المصطلح المخصص ، نقوم أولاً بإنشاء طلب PUT في Postman.

1. اختار إضافة طلب في ساعي البريد.
2. اضبط نوع الطريقة على النحو ضع.
3. أدخل بوابة API لاستدعاء عنوان URL.
4. أضف /customterm في نهاية عنوان URL.
5. على رؤوس علامة التبويب ، أضف مفتاح رأس جديد اسمه x-api-key.
6. أدخل قيمة مفتاح واجهة برمجة تطبيقات المسؤول (تم نسخها في مرحلة تجميع مفاتيح واجهة برمجة التطبيقات).
7. على الجسم علامة التبويب ، قم بتغيير التنسيق إلى ثنائي وتحميل ملف CSV المصطلح المخصص. يتم توفير نموذج ملف CSV ضمن ملف /Resources مجلد في GitHub repo.
8. استدعاء API عن طريق الاختيار أرسل وتحقق من المخرجات.
   
   يجب أن تعمل واجهة برمجة التطبيقات بنجاح مع ظهور رسالة في قسم النص لكائن الاستجابة تقول "تم تحميل المصطلح المخصص بنجاح"
9. في وحدة تحكم Amazon Translate ، اختر مصطلحات مخصصة في جزء التنقل.
   يجب تحميل ملف مصطلحات مخصص وعرضه في قائمة المصطلحات. بناء جملة اسم الملف هو معرف العميل من جدول DynamoDB لمفتاح API المحدد متبوعًا بسلسلة _customterm_1.
   لاحظ أنه إذا لم تستخدم مفتاح admin API ، فسيفشل النظام في تحميل ملف المصطلح المخصص ، الآن أنت جاهز لإجراء الترجمة المخصصة الخاصة بك.
10. اختار إضافة طلب في ساعي البريد.
11. اضبط نوع الطريقة على النحو سأعين.
12. أدخل بوابة API لاستدعاء عنوان URL.
13. أضف /translate إلى نقطة نهاية URL.
14. على رؤوس علامة التبويب ، أضف مفتاح رأس جديد اسمه x-api-key.
15. أدخل قيمة مفتاح API القياسية.
16. على الجسم علامة التبويب ، أدخل نص JSON كما يلي:

    {   "sourceText": "some text to translate",   "targetLanguage": "fr",   "sourceLanguage":"en"}

17. على بارامس علامة التبويب ، أضف معلمة سلسلة استعلام جديدة باسم useCustomTerm بقيمة 1.
18. استدعاء API عن طريق الاختيار أرسل وتحقق من المخرجات. يجب أن تفشل واجهة برمجة التطبيقات مع ظهور الرسالة "غير مصرح به". هذا لأنك تحاول استدعاء ميزة ترجمة مخصصة باستخدام مفتاح واجهة برمجة تطبيقات شخصي قياسي.
19. على رؤوس علامة التبويب ، أدخل قيمة مفتاح API المخصص.
20. قم بتشغيل الاختبار مرة أخرى ، ويجب أن يكون قادرًا على الترجمة باستخدام ملف المصطلحات المخصص.

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

اختبار 3: إضافة مستهلكين ووحدات أعمال إضافية

نشر هذا الحل مستهلكًا واحدًا (customerA) مع ثلاثة مفاتيح API مختلفة كجزء من نشر مكدس CloudFormation. يمكنك إضافة مستهلكين إضافيين عن طريق إنشاء خطة استخدام جديدة في API Gateway وربط مفاتيح API الجديدة بخطة الاستخدام هذه. لمزيد من التفاصيل حول كيفية إنشاء خطط الاستخدام ومفاتيح واجهة برمجة التطبيقات ، يرجى الرجوع إلى إنشاء واستخدام خطط استخدام مع مفاتيح API. يمكنك بعد ذلك إضافة مفاتيح API هذه كإدخالات إضافية في جدول DynamoDB.

تنظيف

لتجنب تكبد رسوم في المستقبل ، قم بتنظيف الموارد التي قمت بإنشائها كجزء من حزمة CloudFormation:

1. في وحدة تحكم AWS CloudFormation ، انتقل إلى الحزمة التي أنشأتها.
2. حدد المكدس واختر حذف المكدس.

المكدس الخاص بك قد يستغرق بعض الوقت ليتم حذفه. يمكنك تتبع التقدم المحرز على الفعاليات التبويب. عند اكتمال الحذف ، تتغير حالة المكدس من DELETE_IN_PROGRESS إلى DELETE_COMPLETE. ثم يختفي من القائمة.

الاعتبارات

ضع في اعتبارك ما يلي عند استخدام هذا الحل:

• تعد استدعاءات واجهة برمجة التطبيقات لهذا الحل أبطأ من استدعاء Amazon Translate API مباشرة. وذلك لأن الحل يقوم بتنفيذ منطق عمل إضافي واستخدام خدمات إضافية (بوابة API و Lambda).
• يرجى ملاحظة ترجمة أمازون حدود الخدمة للترجمة الفورية المتزامنة وملفات المصطلحات المخصصة.
• يركز هذا الحل على كشف API باستخدام مفتاح API. إذا كنت تخطط لنقل هذا إلى بيئات الإنتاج ، ففكر في آلية مصادقة تستخدم معايير الصناعة المفتوحة (مثل OIDC) لمصادقة الطلب أولاً. لمزيد من المعلومات ، يرجى الرجوع إلى إدارة واجهات برمجة التطبيقات متعددة المستأجرين باستخدام Amazon API Gateway.

وفي الختام

في هذا المنشور ، أوضحنا مدى سهولة إجراء الترجمة في الوقت الفعلي ، وتحميل ملفات المصطلحات المخصصة ، والقيام بترجمة مخصصة في Amazon Translate باستخدام واجهات برمجة التطبيقات الأصلية الخاصة بها ، وإنشاء حل لدعم التخصيص باستخدام بوابة API.

يمكنك توسيع الحل باستخدام التخصيصات ذات الصلة بمتطلبات عملك. على سبيل المثال ، يمكنك توفير وظائف إضافية مثل الترجمة المخصصة النشطة باستخدام البيانات المتوازية عبر مفتاح API آخر ، أو إنشاء طبقة تخزين مؤقت للعمل مع هذا الحل لتقليل تكلفة الترجمات بشكل أكبر وتقديم الترجمات التي يتم الوصول إليها بشكل متكرر من ذاكرة التخزين المؤقت. يمكنك تمكين تقييد واجهة برمجة التطبيقات وتحديد المعدل من خلال الاستفادة من ميزات بوابة API. الاحتمالات لا حصر لها ، ونود أن نسمع كيف تأخذ هذا الحل إلى المستوى التالي لمؤسستك من خلال إرسال AWS اتصل بنا طلب. يمكنك البدء في تخصيص هذا الحل بالانتقال إلى جيثب ريبو لهذه المدونة.

لمزيد من المعلومات حول Amazon Translate ، تفضل بزيارة موارد Amazon Translate للعثور على موارد الفيديو ومشاركات المدونات ، وكذلك الرجوع إلى الأسئلة الشائعة حول ترجمة أمازون. إذا كنت جديدًا في Amazon Translate ، فجربه باستخدام ملف الطبقة المجانية، والتي تقدم ما يصل إلى 2 مليون حرف شهريًا مجانًا لأول 12 شهرًا ، بدءًا من طلب الترجمة الأول.

---

عن المؤلف

فهد احمد هو مهندس حلول في Amazon Web Services (AWS) ويهتم بالأعمال الرقمية الأصلية في المملكة المتحدة. لديه أكثر من 17 عامًا من الخبرة في بناء وتصميم تطبيقات البرمجيات. اكتشف مؤخرًا شغفًا جديدًا بجعل خدمات الذكاء الاصطناعي في متناول الجماهير.