صنع أدوات Python لوكلائك

1. ما هي الدالة (Function) في بايثون؟

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

فكر فيها كأنها وصفة طبخ صغيرة:

• لها اسم (مثلاً: "وصفة الكيك").
• تتبع خطوات محددة (اخلط المكونات، ضعها في الفرن).
• في النهاية، تعطيك نتيجة (كيك جاهز).

في البرمجة، استخدام الدوال يساعدنا على:

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

للحصول على مقدمة ممتازة ومبسطة عن الدوال في بايثون، شاهد المقطع التالي.

2. كيفية بناء دالة بسيطة في بايثون

الآن بعد أن فهمنا أهمية الدوال، دعنا نتعلم كيفية تعريف واحدة. يتكون هيكل الدالة في بايثون من عدة أجزاء أساسية.

لتعريف دالة، نستخدم الصيغة التالية:

def function_name(parameter1, parameter2):
    # الكود الذي تنفذه الدالة
    # ...
    return result

لنتعرف على مكوناتها:

1. def: كلمة مفتاحية (Keyword) تخبر بايثون أننا بصدد تعريف دالة جديدة.
2. function_name: الاسم الذي نختاره للدالة. يجب أن يكون وصفياً (مثل calculate_sum بدلاً من func1).
3. (): الأقواس التي قد تحتوي على "المعاملات" (Parameters). المعاملات هي المدخلات التي تحتاجها الدالة لتعمل.
4. :: النقطتان الرأسيتان اللتان تشيران إلى بداية "جسم" الدالة.
5. الجسم المُزاح (Indented Body): كل الأسطر التي تلي النقطتين وتأتي مع مسافة بادئة (Indentation) هي جزء من الدالة. هذا هو الكود الفعلي الذي يتم تنفيذه عند استدعاء الدالة.
6. return: كلمة مفتاحية اختيارية تعيد نتيجة من الدالة. هذه هي "مخرجات" الأداة التي سيستخدمها وكيل الذكاء الاصطناعي.

لتعميق فهمك لهذه البنية، نقترح عليك قراءة المادة التالية ومشاهدة مقطع الفيديو الذي يشرحها بالتفصيل.

3. بناء "أداة" عملية للوكيل

الآن لنطبق ما تعلمناه لبناء أول أداة حقيقية لوكيلنا. ستكون أداة بسيطة لكنها مفيدة: دالة تقوم بحساب عدد الكلمات في نص معين.

لماذا قد يحتاج الوكيل لمثل هذه الأداة؟ قد يستخدمها لتقدير طول رد المستخدم، أو لتلخيص نص طويل، أو للتأكد من أن طلباً ما يقع ضمن طول معين.

هنا هي الدالة:

def count_words(text):
    """
    هذه الدالة تستقبل نصاً (string) وتعيد عدد الكلمات فيه.
    """
    words = text.split()  # .split() هي دالة جاهزة في بايثون تقسم النص إلى قائمة من الكلمات
    number_of_words = len(words) # len() هي دالة جاهزة تحسب عدد العناصر في قائمة
    return number_of_words

# --- طريقة الاستخدام ---
user_sentence = "ما هي حالة الطقس في الرياض اليوم؟"
word_count = count_words(user_sentence)

print(f"الجملة تحتوي على {word_count} كلمات.") 
# سيطبع: الجملة تحتوي على 7 كلمات.

شرح الكود:

1. def count_words(text):: نُعرّف دالة اسمها count_words تستقبل معاملًا واحدًا اسمه text.
2. words = text.split(): نستخدم دالة split() المدمجة في بايثون لتقسيم النص عند المسافات، والنتيجة هي قائمة (List) من الكلمات.
3. number_of_words = len(words): نستخدم دالة len() المدمجة لحساب عدد العناصر في القائمة words.
4. return number_of_words: نُرجع العدد النهائي. هذه هي القيمة التي سيحصل عليها الوكيل بعد استخدام الأداة.

def get_character_count(text):
    """
    هذه الدالة تستقبل نصاً (string) وتعيد عدد الحروف فيه.
    """
    return len(text)

# --- طريقة الاستخدام ---
my_text = "أهلاً بالعالم"
char_count = get_character_count(my_text)
print(f"النص يحتوي على {char_count} حرفاً.")
# سيطبع: النص يحتوي على 12 حرفاً.

في سياق وكيل الذكاء الاصطناعي، هذه الدالة تمثل "أداة" أو "إجراء" (Action) يمكن للوكيل استدعاؤه. شاهد كيف يصف هذا الفيديو القصير دالة بسيطة على أنها "إجراء" يمكن للذكاء الاصطناعي استخدامه.

خلاصة الدرس

لقد قمنا بخطوة عملية كبيرة اليوم! تعلمنا أساسيات بناء "الأدوات" التي ستمنح وكيلنا قدرات حقيقية.

أهم النقاط:

• الدالة (Function) هي كتلة كود منظمة وقابلة لإعادة الاستخدام تؤدي مهمة محددة.
• لتعريف دالة نستخدم def function_name(parameters):.
• المعاملات (Parameters) هي المدخلات التي تحتاجها الدالة لتعمل.
• نستخدم return لإرجاع نتيجة من الدالة، وهي المخرج الذي سيستخدمه الوكيل.
• لقد قمنا ببناء أول "أداة" لنا: دالة count_words، وهي دالة بايثون بسيطة يمكن للوكيل استدعاؤها نظرياً.

ماذا بعد؟

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

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