Skip to content

03-providers.md

Latest commit

 

History

History
131 lines (92 loc) · 11.3 KB

03-providers.md

File metadata and controls

131 lines (92 loc) · 11.3 KB

اختيار وتكوين مزود نموذج اللغة الكبير 🔑

يمكن أيضًا إعداد التعيينات للعمل مع نشر واحد أو أكثر من نماذج اللغة الكبيرة (LLM) من خلال مزود خدمة مدعوم مثل OpenAI أو Azure أو Hugging Face. توفر هذه نقطة نهاية مستضافة (API) يمكننا الوصول إليها برمجيًا باستخدام بيانات الاعتماد الصحيحة (مفتاح API أو رمز). في هذه الدورة، نناقش هؤلاء المزودين:

  • OpenAI مع نماذج متنوعة بما في ذلك سلسلة GPT الأساسية.
  • Azure OpenAI لنماذج OpenAI مع التركيز على جاهزية المؤسسات
  • Hugging Face للنماذج مفتوحة المصدر وخادم الاستدلال

ستحتاج إلى استخدام حساباتك الخاصة لهذه التمارين. التعيينات اختيارية لذا يمكنك اختيار إعداد واحد، أو جميع المزودين - أو لا شيء - بناءً على اهتماماتك. بعض الإرشادات للتسجيل:

التسجيل التكلفة مفتاح API ساحة اللعب التعليقات
OpenAI التسعير مبني على المشروع بدون كود، ويب نماذج متعددة متاحة
Azure التسعير بدء سريع SDK بدء سريع Studio يجب التقديم مسبقًا للوصول
Hugging Face التسعير رموز الوصول Hugging Chat Hugging Chat يحتوي على نماذج محدودة

اتبع التعليمات أدناه لـ تكوين هذا المستودع للاستخدام مع مزودين مختلفين. التعيينات التي تتطلب مزودًا محددًا ستحتوي على أحد هذه العلامات في اسم الملف:

  • aoai - يتطلب نقطة نهاية Azure OpenAI، مفتاح
  • oai - يتطلب نقطة نهاية OpenAI، مفتاح
  • hf - يتطلب رمز Hugging Face

يمكنك تكوين واحد، أو لا شيء، أو جميع المزودين. التعيينات ذات الصلة ستفشل ببساطة عند فقدان بيانات الاعتماد.

إنشاء ملف .env

نفترض أنك قد قرأت الإرشادات أعلاه وسجلت مع المزود المناسب، وحصلت على بيانات الاعتماد المطلوبة للمصادقة (API_KEY أو الرمز). في حالة Azure OpenAI، نفترض أيضًا أن لديك نشرًا صالحًا لخدمة Azure OpenAI (نقطة نهاية) مع نشر نموذج GPT واحد على الأقل لإكمال الدردشة.

الخطوة التالية هي تكوين متغيرات البيئة المحلية الخاصة بك كما يلي:

  1. ابحث في المجلد الجذر عن ملف .env.copy الذي يجب أن يحتوي على محتويات مثل هذه:

    # مزود OpenAI
OPENAI_API_KEY='<add your OpenAI API key here>'

## أزور OpenAI
AZURE_OPENAI_API_VERSION='2024-02-01' # تم التعيين الافتراضي!
AZURE_OPENAI_API_KEY='<add your AOAI key here>'
AZURE_OPENAI_ENDPOINT='<add your AOIA service endpoint here>'
AZURE_OPENAI_DEPLOYMENT='<add your chat completion model name here>' 
AZURE_OPENAI_EMBEDDINGS_DEPLOYMENT='<add your embeddings model name here>'

## Hugging Face
HUGGING_FACE_API_KEY='<add your HuggingFace API or token here>'

  2. انسخ هذا الملف إلى .env باستخدام الأمر أدناه. هذا الملف مُدرج في gitignore، للحفاظ على الأسرار آمنة.

    cp .env.copy .env

  3. املأ القيم (استبدل العناصر النائبة على الجانب الأيمن من =) كما هو موضح في القسم التالي.

  4. (اختياري) إذا كنت تستخدم GitHub Codespaces، لديك خيار حفظ متغيرات البيئة كـ أسرار Codespaces مرتبطة بهذا المستودع. في هذه الحالة، لن تحتاج إلى إعداد ملف .env محلي. ومع ذلك، لاحظ أن هذا الخيار يعمل فقط إذا كنت تستخدم GitHub Codespaces. ستظل بحاجة إلى إعداد ملف .env إذا كنت تستخدم Docker Desktop بدلاً من ذلك.

ملء ملف .env

لنلقِ نظرة سريعة على أسماء المتغيرات لفهم ما تمثله:

المتغير الوصف
HUGGING_FACE_API_KEY هذا هو رمز وصول المستخدم الذي قمت بإعداده في ملفك الشخصي
OPENAI_API_KEY هذا هو مفتاح التفويض لاستخدام الخدمة لنقاط نهاية OpenAI غير Azure
AZURE_OPENAI_API_KEY هذا هو مفتاح التفويض لاستخدام تلك الخدمة
AZURE_OPENAI_ENDPOINT هذه هي نقطة النهاية المنشورة لمورد Azure OpenAI
AZURE_OPENAI_DEPLOYMENT هذه هي نقطة نشر نموذج توليد النص
AZURE_OPENAI_EMBEDDINGS_DEPLOYMENT هذه هي نقطة نشر نموذج تضمين النصوص

ملاحظة: المتغيران الأخيران لـ Azure OpenAI يعكسان نموذجًا افتراضيًا لإكمال الدردشة (توليد النص) والبحث المتجهي (التضمينات) على التوالي. سيتم تعريف التعليمات الخاصة بإعدادها في التعيينات ذات الصلة.

تكوين Azure: من البوابة

سيتم العثور على قيم نقطة نهاية Azure OpenAI والمفتاح في بوابة Azure فلنبدأ من هناك.

  1. اذهب إلى بوابة Azure
  2. انقر على خيار المفاتيح ونقطة النهاية في الشريط الجانبي (القائمة على اليسار).
  3. انقر على إظهار المفاتيح - يجب أن ترى التالي: المفتاح 1، المفتاح 2، ونقطة النهاية.
  4. استخدم قيمة المفتاح 1 لـ AZURE_OPENAI_API_KEY
  5. استخدم قيمة نقطة النهاية لـ AZURE_OPENAI_ENDPOINT

بعد ذلك، نحتاج إلى نقاط النهاية للنماذج المحددة التي نشرناها.

  1. انقر على خيار نشر النماذج في الشريط الجانبي (القائمة اليسرى) لمورد Azure OpenAI.
  2. في الصفحة الوجهة، انقر على إدارة النشرات

سيأخذك هذا إلى موقع Azure OpenAI Studio، حيث سنجد القيم الأخرى كما هو موضح أدناه.

تكوين Azure: من الاستوديو

  1. انتقل إلى Azure OpenAI Studio من موردك كما هو موضح أعلاه.
  2. انقر على علامة التبويب النشرات (الشريط الجانبي، اليسار) لعرض النماذج المنشورة حاليًا.
  3. إذا لم يكن النموذج المطلوب منشورًا، استخدم إنشاء نشر جديد لنشره.
  4. ستحتاج إلى نموذج توليد نص - نوصي بـ: gpt-35-turbo
  5. ستحتاج إلى نموذج تضمين نص - نوصي بـ text-embedding-ada-002

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

AZURE_OPENAI_DEPLOYMENT='gpt-35-turbo'
AZURE_OPENAI_EMBEDDINGS_DEPLOYMENT='text-embedding-ada-002'

لا تنس حفظ ملف .env عند الانتهاء. يمكنك الآن الخروج من الملف والعودة إلى التعليمات لتشغيل الدفتر.

تكوين OpenAI: من الملف الشخصي

يمكن العثور على مفتاح API الخاص بـ OpenAI في حساب OpenAI الخاص بك. إذا لم يكن لديك واحد، يمكنك التسجيل للحصول على حساب وإنشاء مفتاح API. بمجرد حصولك على المفتاح، يمكنك استخدامه لملء متغير OPENAI_API_KEY في ملف .env.

تكوين Hugging Face: من الملف الشخصي

يمكن العثور على رمز Hugging Face الخاص بك في ملفك الشخصي تحت رموز الوصول. لا تنشرها أو تشاركها علنًا. بدلاً من ذلك، أنشئ رمزًا جديدًا لاستخدام هذا المشروع ونسخه إلى ملف .env تحت متغير HUGGING_FACE_API_KEY. ملاحظة: هذا تقنيًا ليس مفتاح API ولكنه يُستخدم للمصادقة لذا نحتفظ بهذا التسمية للاتساق.

إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق به. للمعلومات الهامة، يُنصح بالاعتماد على الترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.