إرشادات لإنشاء أوصاف المنتجات باستخدام حجر الأساس الخاص بأمازون

إنشاء أوصاف المنتج باستخدام Bedrock

يحتوي هذا الحل على واجهة خلفية بدون خادم وتطبيق ReactJS للواجهة الأمامية الذي ينشئ أوصاف المنتج من الصور وإدخال النص، ويعزز أوصاف المنتج ويترجمها باستخدام خدمة الذكاء الاصطناعي التوليدية المُدارة الجديدة، Amazon Bedrock.

جدول المحتويات

1. ملخص
   • يكلف
2. المتطلبات الأساسية
3. خطوات النشر
4. التحقق من صحة النشر
5. تشغيل الإرشاد
6. الخطوات التالية
7. تنظيف
8. اعتبارات وقيود إضافية

ملخص

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

1. يرسل العميل طلبًا يتضمن بيانات الإدخال (إما صورة المنتج أو وصف المنتج الأساسي لتحسينه) إلى Amazon API Gateway REST API.
2. تقوم Amazon API Gateway بتمرير الطلب إلى AWS Lambda من خلال تكامل الوكيل.
3. عند التشغيل على مدخلات صور المنتج، تستدعي AWS Lambda خدمة Amazon Rekognition، التي تستخدم التعلم الآلي لاكتشاف الكائنات الموجودة في الصورة. ويمكن بعد ذلك إدخال أوصاف الكائنات المكتشفة في الخطوات اللاحقة لإنشاء وصف المنتج.
4. تستدعي AWS Lambda نماذج اللغات الكبيرة (LLMs) التي تستضيفها Amazon Bedrock، مثل نماذج لغة Amazon Titan، لإنتاج أوصاف المنتج. يمكن لـ LLMs إما تحسين الأوصاف النصية الأساسية الموجودة، أو إنشاء أوصاف جديدة بناءً على الكائنات التي اكتشفها Amazon Rekognition.
5. تقوم AWS Lambda بتمرير الاستجابة إلى Amazon API Gateway.
6. وأخيرًا، تقوم Amazon API Gateway بإرجاع استجابة HTTP إلى العميل.

يكلف

أنت مسؤول عن تكلفة خدمات AWS المستخدمة أثناء تشغيل هذه الإرشادات. اعتبارًا من نوفمبر 2023، تبلغ تكلفة تشغيل هذه الإرشادات بالإعدادات الافتراضية في شرق الولايات المتحدة (شمال فيرجينيا) حوالي 86 دولارًا أمريكيًا شهريًا لمعالجة 1000 منتج كل شهر.

يتضمن هذا التوجيه خدمات AWS Rekognition وBedrock وCognito وLambda وAPI Gateway وCloudWatch بتكاليف على النحو التالي:

• التعرف: 0.001 USD لكل صورة (لأول مليون صورة)
• حجر الأساس: يعتمد على النموذج. على سبيل المثال، يبلغ سعر Claude Instant 0.00163 دولارًا أمريكيًا لكل 1000 رمز إدخال و0.00551 دولارًا أمريكيًا لكل 1000 رمزًا مميزًا للمخرجات، ويبلغ نموذج AI21 Jurassic 0.0125 دولارًا أمريكيًا لكل 1000 رمزًا مميزًا للإدخال/الإخراج
• Cognito: مجاني لما يصل إلى 50 ألف مستخدم (0.0055 دولار لكل مستخدم نشط شهريًا بعد ذلك)
• بوابة API: 3.50 دولارًا لكل مليون طلب
• Lambda: 0.0000166667 USD لكل جيجابايت في الثانية أو 0.0005 USD لكل استدعاء لهذا التوجيه بافتراض مدة 30 ثانية لأسوأ حالة
• سجلات CloudWatch: 0.50 USD لكل جيجابايت تم جمعها، و0.03 USD شهريًا لكل جيجابايت مخزنة

بشكل متحفظ (يخطئ في المبالغة في التقدير)، باستخدام هذا الحل لإنشاء أوصاف المنتج استنادًا إلى الصور المدخلة 1000 مرة شهريًا (بما في ذلك إنشاء ترجمات إلى الإسبانية والألمانية والفرنسية)، وافتراض أسوأ حالة تبلغ 30 ثانية لكل استدعاء لوظيفة Lambda و 1000 رمز إدخال/إخراج لجميع المكالمات إلى نماذج Claude Instant وJurassic، وستكون التكاليف تقريبًا كما يلي:

• التعرف: 0.001 دولار لكل صورة * 1000 صورة = 1.00 دولار
• الأساس: 0.00163 USD + 0.00551 USD لكل مكالمة إلى Claude Instant * 1000 مكالمة = 7.14 USD و0.0125 USD * 2 لكل مكالمة إلى Jurassic * 1000 مكالمة * 3 لغات = 75 دولارًا
• الكونيتو: مجاني
• بوابة API: 3.50 USD لكل مليون استدعاء * إجمالي 5000 استدعاء = 0.0175 USD
• Lambda: 0.0005 USD لكل استدعاء * إجمالي 5000 استدعاء = 2.50 USD
• سجلات CloudWatch: افترض بشكل متحفظ أنه تم جمع 1 غيغابايت، بتكلفة 0.53 USD تقريبًا للشهر الأول
• الإجمالي: 86 دولارًا أمريكيًا شهريًا مع 1000 استخدام شهريًا (أو 11 دولارًا أمريكيًا فقط شهريًا إذا تم تعطيل الترجمات)

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

ستحتاج إلى تثبيت جميع المتطلبات الأساسية على جهازك المحلي:

1. بايثون 3.8 أو أعلى
2. Node.js وnpm
3. قم بتثبيت مجموعة أدوات AWS CDK (الأمر cdk ) كما هو موثق هنا. ستحتاج أيضًا إلى تشغيل cdk bootstrap إذا لم تكن قد استخدمت CDK من قبل في حسابك كما تمت مناقشته هنا.
4. واجهة سطر أوامر AWS
5. مطلوب Docker للسماح لـ CDK بحزم كود Lambda مع تبعيات Python الضرورية
6. يجب أن يعمل المشروع في أي بيئة macOS أو Linux أو Windows مع المتطلبات الأساسية المذكورة أعلاه، ولكن تم اختبار المشروع في macOS وLinux. تفترض بعض الأوامر والبرامج النصية المساعدة بيئة Bash Shell.
7. يجب تمكين Claude Instant وStable Diffusion SDXL0.8 وAI21 Jurassic-2 Mid في Bedrock كما هو موثق هنا

ملاحظة: يجب تثبيت Docker وتشغيله . يمكنك التأكد من تشغيل البرنامج الخفي Docker من خلال التأكد من تشغيل أمر مثل docker ps دون أخطاء. إذا لم تكن هناك أي حاويات قيد التشغيل، فيجب على docker ps إرجاع قائمة فارغة بالحاويات مثل هذا:

 CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

خطوات النشر

1. أنشئ بيئة EC2 في AWS Cloud9، وقم بتشغيل مثيل EC2 في شبكة فرعية عامة، واكتب عنوان IPv4 العام الخاص به (#cloud9_ec2_ip).

2. قم بتغيير حجم وحدة تخزين EBS التي تستخدمها البيئة (التي تم إنشاؤها في الخطوة 1) إلى 20 جيجابايت على الأقل. يأتي بسعة 10 جيجابايت لـ t2.micro بشكل افتراضي.

3. استنساخ الريبو:

    git clone https://github.com/aws-solutions-library-samples/guidance-for-generating-product-descriptions-with-bedrock.git
   

4. القرص المضغوط إلى مجلد الريبو:

    cd guidance-for-generating-product-descriptions-with-bedrock
   

5. (اختياري) قم بإنشاء Python virtualenv جديد للتبعيات الخاصة بالمشروع:

    python -m venv .env && source .env/bin/activate
   

6. تثبيت تبعيات CDK:

    pip install -r deployment/requirements.txt
   

7. التمهيد لـ AWS CDK، إذا لم يتم ذلك مسبقًا:

    cd deployment && cdk bootstrap
   

8. نشر الواجهة الخلفية:

    cd deployment && cdk deploy
   

9. القرص المضغوط يعود إلى جذر المشروع:

    cd ..
   

10. قم بإنشاء مستخدم Cognito الأولي:

     deployment/create-user.sh <>
    

11. قم بتحديث config.js بالقيم المناسبة من مخرجات مكدس CDK. يمكن القيام بذلك تلقائيًا عن طريق التشغيل

     deployment/update-config.sh
    

12. تثبيت تبعيات الواجهة الأمامية:

     cd source/frontend && npm install
    

13. قم بتشغيل نموذج تطبيق العميل، واكتب رقم المنفذ (#web_port) الذي تستمع إليه حزمة الويب، على سبيل المثال. 8080.

     npm start
    

14. افتح مجموعات الأمان الخاصة بـ EC2 التي تم إنشاؤها في الخطوة 1، وأضف قاعدة واردة، والتي تسمح بـ TCP المخصص، ونطاق المنفذ #web_port، والمصدر "My IP"، ثم حفظ القواعد.

التحقق من صحة النشر

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

تشغيل الإرشاد

يمكنك تجربة تطبيق الويب التجريبي باتباع الخطوات التالية:

1. تحقق من بريدك الإلكتروني بحثًا عن كلمة مرور مؤقتة
2. قم بالوصول إلى التطبيق من متصفح محلي على #cloud9_public_ip:#web_port
3. اتبع المطالبات لتسجيل الدخول وتغيير كلمة المرور الخاصة بك
4. لإنشاء وصف منتج من صورة (الوضع الافتراضي)، استعرض بحثًا عن ملف صورة لبعض المنتجات أو العناصر
5. بمجرد التحميل، سيتم إنشاء وصف المنتج وترجماته إلى عدة لغات

الخطوات التالية

راجع صفحة منتج Bedrock للحصول على المزيد من الموارد حول استخدام Amazon Bedrock.

تنظيف

يمكن حذف البنية الأساسية المتوفرة عن طريق تشغيل الأمر التالي:

 cd deployment && cdk destroy

اعتبارات وقيود إضافية

• نظرًا لأن هذا المشروع يقوم بتمرير الصور المشفرة بـ base64 إلى وظائف Lambda من خلال حمولة الحدث، فإن إجمالي حجم الإدخال يقتصر على 6 ميجابايت، مما يحد من حجم الصور المدخلة.
• يحد تكامل وكيل Lambda وAPI Gateway من وقت المعالجة إلى 29 ثانية لكل مكالمة، مما قد يمنع إنشاء أوصاف أكبر للمنتج. يمكن التغلب على هذا القيد باستخدام طرق بديلة، مثل تدفق الاستجابات عبر عناوين URL لوظيفة Lambda بدلاً من بوابة API.