btp genai starter kit

مجموعة أدوات SAP BTP genAI للمبتدئين

وصف

يريد هذا الريبو أن يمنح مستخدمي SAP Business Technology Platform (BTP) طريقة سريعة لتعلم كيفية استخدام الذكاء الاصطناعي التوليدي مع خدمات BTP.

متطلبات

• لديك حق الوصول إلى حساب SAP BTP عالمي أو حساب SAP BTP فرعي موجود.

• تم تثبيت Visual Studio Code على جهازك باستخدام ملحق Dev Container . أنت تفهم الغرض والمفاهيم الأساسية لحاويات التطوير في VS Code.

• كشرط أساسي لاستخدام حاويات التطوير، يتم تثبيت Docker على جهازك ويمكنك فهم مفاهيمه الأساسية.

• يتوفر Git على جهازك (اختبره باستخدام git --version ) وأنت تعرف كيفية استنساخ مشروع من github.

• يجب أن يتمتع حساب SAP BTP العالمي بالحق الكافي لاستخدام الخدمات والتطبيقات التالية:

  اسم	الخدمة/التطبيق	يخطط
  منظمة العفو الدولية الأساسية	aicore (خدمة)	extended
  لوحة تشغيل الذكاء الاصطناعي (اختياري)	ai-launchpad (اشتراك التطبيق)	standard
  هانا كلاود	hana-cloud (خدمة)	hana
  أدوات هانا السحابية	hana-cloud-tools (اشتراك التطبيق)	tools

التحميل والتثبيت

الخطوة 1: إعداد البنية التحتية لـ SAP BTP

• انسخ مستودع GitHub هذا على جهازك المحلي وافتحه في VS Code.
• افتح حاوية Dev على جهازك من داخل VS Code ( Reopen in Dev Container ).
• انتظر حتى يتم إنشاء حاوية التطوير وتحميل المشروع بداخلها.

  انتبه إلى أن فتح حاوية التطوير قد يستغرق بعض الوقت!

• في المجلد config/secrets قم بإعادة تسمية الملف btp_ai_setup.tfvars إلى my_btp_ai_setup.tfvars .
  • قم بتعديل قيمة globalaccount للحساب الفرعي الذي سيتم إنشاؤه داخله. تجده في الصفحة المقصودة للحساب العالمي ("النطاق الفرعي: .....").
  • إذا كنت ترغب في استخدام IDP مخصص، فقم بتوفير قيمة idp ، على سبيل المثال <your-ias-tenant>.accounts.ondemand.com .
  • أضف عنوان بريدك الإلكتروني إلى admins المتغيرين. يجب أن يبدو هذا مشابهًا لما يلي: admins = ["[email protected]"] .
  • احفظ الملف.
• في المجلد config/secrets قم بإعادة تسمية الملف btp_credentials.tfvars إلى my_btp_credentials.tfvars .
  • قم بتكييف قيمة المتغير BTP_USERNAME مع عنوان بريدك الإلكتروني.
  • احفظ الملف.
• ضمن VS Code، افتح جلسة طرفية.
• في الوحدة الطرفية، اكتب ببساطة ./run.sh وأدخل BTP_PASSWORD بالإضافة إلى كلمة المرور الخاصة HANA DB (ستتم مطالبتك وفقًا لذلك).

  تأكد من أن كلمة المرور الخاصة بقاعدة بيانات HANA تطابق الحد الأدنى من المتطلبات (الطول >= 8، 1+ أحرف كبيرة، 2+ أحرف صغيرة، 1+ أرقام)!

في حالة رغبتك في المصادقة عبر الدخول الموحد (SSO)، يجب عليك تعيين متغير enironment BTP_ENABLE_SSO إلى true . يمكنك القيام بذلك عن طريق تشغيل الأمر التالي داخل حاوية التطوير الخاصة بك: export BTP_ENABLE_SSO=true

سيقوم البرنامج النصي للبدء الآن بإعداد الأشياء التالية لك في حساب SAP BTP العالمي الخاص بك:

• يقوم بإنشاء حساب فرعي بالاسم الذي تم تكوينه في ملف my_btp_ai_setup.tfvars (folder config/secrets ).
• يقوم بإنشاء مثيلات/اشتراكات الخدمة للخدمات التالية
  • SAP AI Core (خدمة)
  • SAP HANA Cloud (خدمة) مع محرك متجه متكامل
  • أدوات SAP HANA Cloud (اشتراك التطبيق)
• يقوم بإنشاء ملف يسمى .env الذي سيتم نسخه إلى مجلد config/secrets .

الخطوة 2: نشر نماذج الذكاء الاصطناعي لتجارب genAI الخاصة بك في AI Core

سيتم الاهتمام بالخطوة الثانية تلقائيًا عن طريق تشغيل الأمر ./run.sh من الخطوة 1.
بعد الإعداد الناجح لحساب BTP الفرعي، فإنه يستدعي poetry run python main.py في المجلد scripts .

يقوم برنامج Python النصي بما يلي:

• يقوم بتحميل محتوى ملف .env الذي تم إنشاؤه حديثًا من الخطوة 1 إلى متغيرات البيئة الخاصة بالجلسة.
• فهو يستدعي واجهات برمجة التطبيقات AI Core لتمنحك إمكانية الوصول إلى النماذج التي حددتها في الملف config/secrets/my_btp_ai_setup.tfvars (من خلال المتغير target_ai_core_model ).

الخطوة 3: تشغيل أمثلة GenAI

بعد الخطوات المذكورة أعلاه، أصبحت جاهزًا لإجراء تجارب genAI الأولى على SAP BTP.

يمكنك المتابعة بالتبديل إلى المجلد scripts/step03_explore_examples .

ستجد هنا بعض الأمثلة مع التعليمات الخاصة ونموذج التعليمات البرمجية.

القضايا المعروفة

❗هناك مشكلة موجودة تجعل رمز AI Core API غير صالح لمدة تتراوح بين ساعة وساعتين تقريبًا بعد إنشائه. لقد طبقنا آلية إعادة المحاولة، ومع ذلك، حتى يتم حل المشكلة، قد يؤدي تشغيل ./run.sh إلى حدوث الخطأ التالي. كحل مؤقت، ما عليك سوى إعادة تشغيل ./run.sh خلال ساعة أو ساعتين.

كيفية الحصول على الدعم

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

للحصول على دعم إضافي، اطرح سؤالاً في مجتمع SAP.

المساهمة

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

رخصة

حقوق الطبع والنشر (ج) لعام 2024 مملوكة لشركة SAP SE أو إحدى الشركات التابعة لـ SAP. جميع الحقوق محفوظة. تم ترخيص هذا المشروع بموجب ترخيص برنامج Apache، الإصدار 2.0 باستثناء ما هو مذكور بخلاف ذلك في ملف الترخيص.