استخدام OpenAI API في Python

1. فهم واجهة OpenAI API والحصول على مفتاحك

قبل كتابة أي كود، نحتاج إلى فهم الأداة التي سنستخدمها والحصول على "مفتاح الدخول" الخاص بنا.

تذكر تشبيه "النادل في المطعم" الذي تعلمناه سابقاً عند الحديث عن واجهات برمجة التطبيقات (APIs). في سياقنا اليوم:

• أنت (برنامج بايثون الخاص بك): العميل الجالس على الطاولة.
• المطبخ (خوادم OpenAI): المكان الذي توجد فيه نماذج اللغة العملاقة (مثل GPT-4o mini).
• النادل (OpenAI API): هو الوسيط الذي يأخذ طلبك (التلقين)، يوصله إلى المطبخ، ثم يعود لك بالوجبة الجاهزة (الاستجابة).

ولأن هذه خدمة قوية ومكلفة التشغيل، فإنها ليست مجانية تمامًا. للوصول إليها، تحتاج إلى "بطاقة عضوية" خاصة، وهي ما نسميه مفتاح الـ API (API Key). هذا المفتاح يثبت هويتك لـ OpenAI ويسمح لهم بتتبع استخدامك.

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

الآن بعد أن أصبح لديك مفتاح الـ API الخاص بك، أنت جاهز للخطوة التالية: إعداد بيئة بايثون للتواصل مع OpenAI.

2. إعداد بيئة بايثون وتأمين مفتاحك

للتحدث مع OpenAI API بسهولة، سنستخدم مكتبة بايثون رسمية توفرها OpenAI. كما سنتعلم أفضل ممارسة لتأمين مفتاحنا السري.

أ. تثبيت المكتبات اللازمة

افتح الطرفية (Terminal) في VS Code وقم بتشغيل الأمرين التاليين لتثبيت مكتبتين:

1. openai: المكتبة الرسمية للتفاعل مع OpenAI.
2. python-dotenv: مكتبة مساعدة لتحميل البيانات الحساسة (مثل مفتاح API) من ملف خارجي.

pip install openai
pip install python-dotenv

ب. تأمين مفتاح API (ممارسة احترافية)

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

1. في مجلد مشروعك في VS Code، قم بإنشاء ملف جديد باسم .env (لاحظ النقطة في البداية).

2. داخل ملف .env، اكتب السطر التالي، مع استبدال sk-xxxx بمفتاح API الحقيقي الذي نسخته من موقع OpenAI:

   OPENAI_API_KEY="sk-xxxx"
   

بهذه الطريقة، يبقى مفتاحك السري معزولاً عن منطق البرنامج الرئيسي.

3. كتابة الكود للتواصل مع النموذج اللغوي

حان الآن الجزء الممتع! سنكتب برنامج بايثون بسيطًا يقرأ مفتاحك السري، ويرسل تلقينًا إلى OpenAI، ويطبع الإجابة.

شاهد هذا المقطع القصير أولاً لترى بنية الكود العامة، ثم سنقوم بكتابته معًا مع شرح باللغة العربية.

الآن، قم بإنشاء ملف بايثون جديد (مثلاً main.py) واكتب فيه الكود التالي. لقد أضفت تعليقات توضيحية بالعربية لشرح كل سطر:

# الخطوة 1: استيراد المكتبات اللازمة
import os  # مكتبة للتعامل مع نظام التشغيل، سنستخدمها لقراءة متغيرات البيئة
from openai import OpenAI  # مكتبة OpenAI الرسمية
from dotenv import load_dotenv  # مكتبة لتحميل المتغيرات من ملف .env

# تحميل المتغيرات من ملف .env (سيقوم بالبحث عن ملف اسمه .env)
load_dotenv()

# الخطوة 2: إعداد العميل (Client)
# نقوم بإنشاء كائن من OpenAI ونمرر له مفتاح الـ API
# الكود يقرأ المفتاح من متغيرات البيئة الذي قمنا بتعيينه في ملف .env
client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),
)

# الخطوة 3: إرسال الطلب إلى النموذج
# نستخدم دالة chat.completions.create للتحدث مع نماذج المحادثة
chat_completion = client.chat.completions.create(
    model="gpt-4o-mini",  # تحديد النموذج الذي نريد استخدامه (نموذج فعال وقليل التكلفة)
    messages=[
        # هنا نضع "التلقين" أو التعليمات التي تعلمناها في الدرس السابق
        # نستخدم دور "user" لنطرح سؤالاً أو نعطي أمرًا
        {"role": "user", "content": "اكتب قصيدة قصيرة من أربعة أسطر عن جمال البرمجة."}
    ]
)

# الخطوة 4: طباعة الاستجابة
# الاستجابة الكاملة تحتوي على الكثير من المعلومات الإضافية
# النص الفعلي الذي نريده موجود داخل response.choices[0].message.content
response_text = chat_completion.choices[0].message.content
print("إجابة النموذج:")
print(response_text)

قم بتشغيل البرنامج! سترى في الطرفية استجابة النموذج اللغوي للطلب الذي أرسلته.

الصورة التالية توضح كيف يبدو الكود والناتج في بيئة VS Code، وهو مشابه جدًا لما يجب أن تراه على شاشتك.

    messages=[
        {"role": "system", "content": "أنت خبير تسويق مبدع متخصص في الحملات الرقمية."},
        {"role": "user", "content": "اقترح فكرة حملة إعلانية على وسائل التواصل الاجتماعي لمنتج جديد وهو 'قهوة سريعة التحضير بنكهة الهيل'."}
    ]

خلاصة الدرس

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

أهم النقاط التي تعلمناها:

• واجهة OpenAI API هي بوابتنا البرمجية للتحدث مع نماذج اللغة الكبيرة.
• مفتاح API هو هويتك السرية للوصول إلى هذه الخدمة، ويجب الحفاظ على سريته دائمًا.
• استخدام ملف .env ومكتبة python-dotenv هو الطريقة الاحترافية لإدارة المفاتيح السرية.
• باستخدام مكتبة openai في بايثون، يمكننا بسهولة إرسال تلقين (Prompt) واستقبال استجابة من نماذج مثل gpt-4o-mini.
• لقد كتبنا أول برنامج يتواصل فعليًا مع "عقل" ذكاء اصطناعي!

ماذا بعد؟

لقد أنهيت الآن الوحدة الثالثة بنجاح، والتي كانت بمثابة مدخل إلى عالم الذكاء الاصطناعي ونماذج اللغة الكبيرة. لديك الآن الأدوات الأساسية:

1. تجيد أساسيات بايثون (الوحدة 1).
2. تفهم كيفية التعامل مع البيانات والـ APIs (الوحدة 2).
3. تعرف كيف توجه وتتواصل مع عقل الذكاء الاصطناعي (الوحدة 3).

في الوحدة القادمة، "مبادئ وكلاء الذكاء الاصطناعي ومكوناتها"، سنبدأ في تجميع هذه القطع معًا. سنتعلم نظريًا ما هو وكيل الذكاء الاصطناعي، وما هي دورة حياته (إدراك - تفكير - تنفيذ)، وسنتعرف على مكوناته الأساسية: العقل (LLM)، الذاكرة، والأدوات. استعد لتبدأ رحلة تصميم وكيلك الأول.