ai-agents-for-beginners

إعداد الدورة

المقدمة

ستتناول هذه الدرس كيفية تشغيل نماذج التعليمات البرمجية الخاصة بهذه الدورة.

انضم إلى المتعلمين الآخرين واحصل على المساعدة

قبل أن تبدأ في استنساخ المستودع الخاص بك، انضم إلى قناة Discord الخاصة بـ AI Agents للمبتدئين للحصول على أي مساعدة في الإعداد، أو للإجابة على أي أسئلة حول الدورة، أو للتواصل مع المتعلمين الآخرين.

استنساخ أو تفريع هذا المستودع

للبدء، يرجى استنساخ أو تفريع مستودع GitHub. سيتيح لك ذلك إنشاء نسخة خاصة بك من مواد الدورة لتتمكن من تشغيل واختبار وتعديل التعليمات البرمجية!

يمكن القيام بذلك بالنقر على الرابط للحصول على نسخة مفروعة من هذه الدورة في الرابط التالي:

Forked Repo

تشغيل التعليمات البرمجية

تقدم هذه الدورة سلسلة من دفاتر Jupyter التي يمكنك تشغيلها للحصول على تجربة عملية في بناء وكلاء الذكاء الاصطناعي.

تستخدم نماذج التعليمات البرمجية أحد الخيارات التالية:

يتطلب حساب GitHub - مجاني:

1) إطار عمل Semantic Kernel Agent + سوق النماذج في GitHub. مُشار إليه بـ (semantic-kernel.ipynb) 2) إطار عمل AutoGen + سوق النماذج في GitHub. مُشار إليه بـ (autogen.ipynb)

يتطلب اشتراك Azure: 3) Azure AI Foundry + خدمة Azure AI Agent. مُشار إليه بـ (azureaiagent.ipynb)

نوصي بتجربة جميع الأنواع الثلاثة من الأمثلة لمعرفة أيها يناسبك بشكل أفضل.

أيًا كان الخيار الذي تختاره، سيحدد الخطوات التي تحتاج إلى اتباعها أدناه:

المتطلبات

لقد قمنا بتضمين ملف requirements.txt في جذر هذا المستودع يحتوي على جميع حزم Python المطلوبة لتشغيل نماذج التعليمات البرمجية.

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

pip install -r requirements.txt

نوصي بإنشاء بيئة Python افتراضية لتجنب أي تعارضات أو مشاكل.

إعداد VSCode

تأكد من أنك تستخدم الإصدار الصحيح من Python في VSCode.

image

الإعداد للأمثلة باستخدام نماذج GitHub

الخطوة 1: استرجاع رمز الوصول الشخصي (PAT) الخاص بك من GitHub

تستخدم هذه الدورة سوق النماذج في GitHub، مما يوفر وصولًا مجانيًا إلى نماذج اللغة الكبيرة (LLMs) التي ستستخدمها لبناء وكلاء الذكاء الاصطناعي.

للاستفادة من نماذج GitHub، ستحتاج إلى إنشاء رمز الوصول الشخصي من GitHub.

يمكن القيام بذلك من خلال الانتقال إلى حساب GitHub الخاص بك.

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

  1. اختر خيار Fine-grained tokens على الجانب الأيسر من الشاشة من خلال الانتقال إلى إعدادات المطور.

    ثم اختر Generate new token.

    Generate Token

  2. أدخل اسمًا وصفيًا للرمز يعكس الغرض منه، مما يسهل التعرف عليه لاحقًا.

    🔐 توصية مدة الرمز

    المدة الموصى بها: 30 يومًا
    للحصول على وضع أمني أكثر، يمكنك اختيار فترة أقصر - مثل 7 أيام 🛡️
    إنها طريقة رائعة لتحديد هدف شخصي وإكمال الدورة بينما تكون في ذروة حماسك للتعلم 🚀.

    Token Name and Expiration

  3. قم بتحديد نطاق الرمز ليقتصر على النسخة المفروعة من هذا المستودع.

    Limit scope to fork repository

  4. قم بتقييد أذونات الرمز: ضمن علامة التبويب Permissions، انقر على زر “+ Add permissions”. ستظهر قائمة منسدلة. يرجى البحث عن Models وتحديد المربع الخاص بها. Add Models Permission

  5. تحقق من الأذونات المطلوبة قبل إنشاء الرمز. Verify Permissions

  6. قبل إنشاء الرمز، تأكد من أنك مستعد لتخزين الرمز في مكان آمن مثل مدير كلمات المرور، حيث لن يتم عرضه مرة أخرى بعد إنشائه. Store Token Securely

انسخ الرمز الجديد الذي قمت بإنشائه للتو. ستقوم الآن بإضافته إلى ملف .env المضمن في هذه الدورة.

الخطوة 2: إنشاء ملف .env

لإنشاء ملف .env، قم بتشغيل الأمر التالي في الطرفية.

cp .env.example .env

سيقوم هذا بنسخ ملف المثال وإنشاء ملف .env في الدليل الخاص بك حيث يمكنك ملء القيم لمتغيرات البيئة.

بعد نسخ الرمز الخاص بك، افتح ملف .env في محرر النصوص المفضل لديك والصق الرمز في الحقل GITHUB_TOKEN. GitHub Token Field

يجب أن تكون الآن قادرًا على تشغيل نماذج التعليمات البرمجية لهذه الدورة.

الإعداد للأمثلة باستخدام Azure AI Foundry وخدمة Azure AI Agent

الخطوة 1: استرجاع نقطة النهاية الخاصة بمشروع Azure الخاص بك

اتبع الخطوات لإنشاء مركز ومشروع في Azure AI Foundry الموجودة هنا: نظرة عامة على موارد المركز

بمجرد إنشاء مشروعك، ستحتاج إلى استرجاع سلسلة الاتصال الخاصة بمشروعك.

يمكن القيام بذلك من خلال الانتقال إلى صفحة نظرة عامة لمشروعك في بوابة Azure AI Foundry.

Project Connection String

الخطوة 2: إنشاء ملف .env

لإنشاء ملف .env، قم بتشغيل الأمر التالي في الطرفية.

cp .env.example .env

سيقوم هذا بنسخ ملف المثال وإنشاء ملف .env في الدليل الخاص بك حيث يمكنك ملء القيم لمتغيرات البيئة.

بعد نسخ الرمز الخاص بك، افتح ملف .env في محرر النصوص المفضل لديك والصق الرمز في الحقل PROJECT_ENDPOINT.

الخطوة 3: تسجيل الدخول إلى Azure

كأفضل ممارسة أمان، سنستخدم المصادقة بدون مفتاح للمصادقة على Azure OpenAI باستخدام Microsoft Entra ID.

بعد ذلك، افتح الطرفية وقم بتشغيل az login --use-device-code لتسجيل الدخول إلى حساب Azure الخاص بك.

بمجرد تسجيل الدخول، اختر اشتراكك في الطرفية.

متغيرات البيئة الإضافية - Azure Search وAzure OpenAI

بالنسبة لدرس Agentic RAG - الدرس الخامس - هناك أمثلة تستخدم Azure Search وAzure OpenAI.

إذا كنت ترغب في تشغيل هذه الأمثلة، ستحتاج إلى إضافة متغيرات البيئة التالية إلى ملف .env الخاص بك:

صفحة النظرة العامة (المشروع)

مركز الإدارة

صفحة النماذج + نقاط النهاية

بوابة Azure

صفحة ويب خارجية

إعداد المصادقة بدون مفتاح

بدلاً من كتابة بيانات الاعتماد الخاصة بك، سنستخدم اتصالًا بدون مفتاح مع Azure OpenAI. للقيام بذلك، سنقوم باستيراد DefaultAzureCredential ثم استدعاء وظيفة DefaultAzureCredential للحصول على بيانات الاعتماد.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

هل واجهت مشكلة؟

إذا واجهت أي مشاكل أثناء تشغيل هذا الإعداد، انضم إلى قناتنا للحصول على الدعم.

الدرس التالي

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

مقدمة إلى وكلاء الذكاء الاصطناعي وحالات الاستخدام الخاصة بهم

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

This site is open source. Improve this page.