مساحتي

دليلك التطبيقي الأول: كيف تبني "البوت" الخاص بك باستخدام واجهات البرمجة (APIs)؟

هل ترغب في البدء بتطوير تطبيقات الذكاء الاصطناعي؟ انضم إلينا في الدرس الأول من مساحتي لتعلم كيفية بناء "البوت" الخاص بك خطوة بخطوة باستخدام (APIs)

شاشة عرض مقسمة تظهر واجهة برمجة تطبيقات (IDE) وجانب نصي بعنوان الدرس 01 حول بناء البوت باستخدام APIs.

لم يعد بناء تطبيقات الذكاء الاصطناعي حكراً على الشركات العملاقة التي تملك أجهزة كمبيوتر ضخمة وخارقة! اليوم، وبفضل تقنية بسيطة تسمى واجهات برمجة التطبيقات (APIs)، يمكن لأي شخص أن يربط برنامجه الشخصي بأقوى عقول الذكاء الاصطناعي في العالم بأسطر برمجية قليلة جداً. في هذا الدرس التطبيقي الأول من "أكاديمية التعلم" على منصة "مساحتي"، سننتقل معك خطوة بخطوة من الشرح إلى التنفيذ العملي، لنتعلم كيف تبني "البوت" الذكي الخاص بك وتجعله يجيب على أسئلتك ويرد عليك باستخدام لغة بايثون البسيطة.

أولاً: كيف تعمل واجهة البرمجة (API)؟ (فكرة مبسطة)

تخيل أن الـ API مثل "الجرسون" في المطعم: أنت تبقي في مكانك وتطلب الوجبة (سؤالك)، فيأخذ الجرسون الطلب ويذهب به إلى المطبخ (خوادم الذكاء الاصطناعي الضخمة)، ثم يعود إليك بالوجبة جاهزة (الإجابة الذكية)!

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

ثانياً: تجهيز بيئة العمل (خطوات بسيطة وقصيرة)

لتبدأ كتابة كودك الأول، يمكنك استخدام أدوات سريعة ومجانية على المتصفح مثل Jupyter Notebook أو Google Colab. كل ما عليك فعله في البداية هو تثبيت المكتبة التي تمكن بايثون من التحدث مع الذكاء الاصطناعي، وذلك بكتابة الأمر التالي:

pip install openai python-dotenv

بعد تثبيت الأدوات، ستحتاج للحصول على مفتاح واجهة البرمجة (API Key) من موقع الخدمة. احرص على معاملة هذا المفتاح مثل كلمة السر الخاصة بك؛ فلا تشاركه مع أحد لتبقى بياناتك وحسابك في أمان تام.

ثالثاً: كود بناء وتدشين البوت الذكي (جرب بنفسك)

إليك الكود المباشر لبناء واجهة شات بسيطة تتحدث مع الذكاء الاصطناعي. هذا التطبيق يجسد عملياً ما شرحناه في مقالنا عن عالم معالجة اللغات الطبيعية (NLP): مصطلحات تفاعلك اليومي مع ChatGPT وأخوته.

انسخ هذا الكود بضغطة زر وشغله فوراً في بيئتك البرمجية:

import os
from openai import OpenAI

# إعداد العميل باستخدام مفتاح الـ API الخاص بك
client = OpenAI(api_key="ضع_مفتاح_الـ_API_الخاص_بك_هنا")

def ask_my_bot(user_question):
    try:
        # إرسال الطلب إلى نموذج الذكاء الاصطناعي
        response = client.chat.completions.create(
            model="gpt-4o-mini", # تحديد النموذج المستخدم
            messages=[
                {"role": "system", "content": "أنت مساعد ذكي ومحترف، تجيب بلغة عربية فصحى ومبسطة."},
                {"role": "user", "content": user_question}
            ],
            temperature=0.7 # التحكم في مستوى إبداع وعشوائية الإجابة
        )
        # استخراج النص الراجع من الخادم
        answer = response.choices[0].message.content
        return answer
    except Exception as e:
        return f"حدث خطأ أثناء الاتصال بالخادم: {e}"

# تجربة البوت عملياً
prompt = "ما هي واجهات البرمجة APIs باختصار؟"
print(f"السؤال: {prompt}\n")
bot_response = ask_my_bot(prompt)
print(f"رد البوت:\n{bot_response}")

رابعاً: كيف تتحكم في شخصية وإجابات البوت؟

يمكنك ضبط طريقة تفكير البوت وإجاباته وسلوكه بسهولة من خلال تعديل بعض الأرقام والكلمات البسيطة داخل الكود، كما يوضح الجدول التالي:

المحدد البرمجي الوظيفة المبسطة القيم المقترحة
System Role تحديد شخصية البوت ودوره (مثلاً: "أنت معلم رياضيات" أو "أنت كاتب مقالات"). جملة نصية توجيهية
Temperature مستوى الإبداع؛ الرقم المنخفض يعني إجابات علمية دقيقة، والرقم العالي يعني إجابات إبداعية ومبتكرة. من 0.0 إلى 2.0 (المناسب عادة هو 0.7)
Max Tokens الحد الأقصى لطول الإجابة لحماية حسابك من الإجابات الطويلة جداً. أرقام مثل 150 أو 500

هذه الإعدادات البسيطة تمنحك تحكماً كاملاً بالبوت، وهو خطوة ممتازة للتمرس قبل تجربة الخوارزميات التي شرحناها في مقال مصطلحات تعلم الآلة (Machine Learning): المفاتيح السرية لخوارزميات المستقبل.

"إن القوة الحقيقية للـ API لا تكمن فقط في الحصول على إجابة، بل في قدرتك على تحويل هذه الإجابات إلى تطبيق ذكي حل مشكلة يومية للناس."

خاتمة: ما هي خطوتك القادمة؟

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


سؤال لاختبار فهمك العملي:

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

أي قيمة للمحدد (Temperature) يجب عليك اختيارها في الكود؟
1. قيمة منخفضة وقريبة من الصفر (مثل: 0.1 أو 0.2)
2. قيمة مرتفعة وقريبة من الحد الأقصى (مثل: 1.5 أو 1.8)

اكتب لنا إجابتك مع السبب في صندوق التعليقات بالأسفل لنناقشها معاً!