الأدوات واستدعاء الوظائف
Tools and Function Calling
كيف يتجاوز الوكيل حدود النص فيحسب ويبحث ويقرأ الملفات ويستعلم قواعد البيانات عبر أدوات موصوفة بمخططات واضحة، وكيف نتعامل مع أخطائها ونؤمّنها.
عن الوحدة
النموذج اللغوي وحده لا يعرف سعر الصرف اليوم ولا يستطيع قراءة ملف على الخادم ولا يضمن دقة عملية حسابية طويلة. الأدوات (Tools) هي الجسر بين تفكير الوكيل والعالم الخارجي. في هذه الوحدة تتعلم ما الأداة وكيف يعمل استدعاء الوظائف (Function Calling) خطوة بخطوة، وكيف تكتب مخطط JSON (JSON Schema) يصف المدخلات بدقة، وكيف يختار الوكيل الأداة المناسبة من بين عدة أدوات، وكيف تتعامل مع المهلات والأخطاء وإعادة المحاولة دون تكرار الآثار الجانبية، وأخيرًا كيف تحمي النظام بمبدأ أقل صلاحية والموافقة البشرية والتحقق من المدخلات. تربط الوحدة كل فكرة بتجربة عملية في مختبر الأدوات ومحاكي الأكاديمية الحتمي.
أهداف التعلم
- شرح دور الأدوات في توسيع قدرات الوكيل وحدود النموذج اللغوي بدونها
- تتبّع دورة استدعاء الوظائف من وصف الأداة حتى عودة النتيجة إلى النموذج
- كتابة مخطط JSON واضح لأداة مع حقول إلزامية وقيود على القيم
- تصميم معايير لاختيار الأداة المناسبة وتقليل الاستدعاءات غير الضرورية
- معالجة أخطاء الأدوات بإعادة محاولة آمنة ومهلات ورسائل خطأ مفيدة
- تطبيق ضوابط الأمان: أقل صلاحية والتحقق من المدخلات والموافقة البشرية
المتطلبات السابقة
- إتمام وحدة الأساسيات (fundamentals) وفهم حلقة الوكيل
- إتمام وحدة الذاكرة (memory) أو الإلمام بمفهوم نافذة السياق
- معرفة أساسية ببايثون (الدوال والقواميس) وبصيغة JSON
المهارات المكتسبة
الدروس
- 1ما الأدوات ولماذا يحتاجها الوكيل؟What Are Tools?النموذج اللغوي بارع في توليد النص، لكنه لا يرى العالم الخارجي ولا يغيّره بنفسه. الأدوات هي الطريقة التي يحصل بها الوكيل على معلومات حديثة وي…
- 2استدعاء الوظائف خطوة بخطوةFunction Callingاستدعاء الوظائف هو الآلية التي تجعل النموذج يعبّر عن رغبته في استخدام أداة بصيغة منظمة يفهمها البرنامج. في هذا الدرس نتتبع الدورة كاملة من ت…
- 3مخططات الأدوات وJSON SchemaTool Schemasالنموذج لا يرى كود الأداة، بل يرى اسمها ووصفها ومخطط مدخلاتها فقط. لذلك فإن المخطط الجيد نصف نجاح الأداة. في هذا الدرس نكتب مخططًا بصيغة JSO…
- 4كيف يختار الوكيل الأداة المناسبة؟Choosing the Right Toolكلما زاد عدد الأدوات المتاحة زادت فرص الاختيار الخاطئ. في هذا الدرس نتعلم كيف نصمم مجموعة أدوات تسهّل على الوكيل القرار، ومتى يكون الخيار ال…
- 5أخطاء الأدوات وإعادة المحاولةTool Errors and Retriesالأدوات تتصل بشبكات وخوادم وقواعد بيانات، وكلها تفشل أحيانًا. الوكيل الجيد لا ينهار عند أول خطأ، ولا يكرر عملية دفع مرتين. في هذا الدرس نصنّ…
- 6أمان الأدوات والصلاحياتTool Security and Permissionsكل أداة تمنحها للوكيل هي باب إلى نظامك. إذا خُدع الوكيل أو أخطأ فإن الأداة هي ما يحوّل الخطأ إلى ضرر حقيقي. في هذا الدرس نتعلم مبدأ أقل صلاح…
مخططات الوحدة
مصطلحات الوحدة
| المصطلح | English | التعريف |
|---|---|---|
| أداة | Tool | وظيفة برمجية موصوفة يطلب الوكيل تشغيلها لقراءة معلومات أو تنفيذ فعل |
| تاريخ انقطاع المعرفة | Knowledge Cutoff | آخر تاريخ تغطيه بيانات تدريب النموذج |
| الهلوسة | Hallucination | توليد معلومة تبدو مقنعة لكنها غير صحيحة أو غير مستندة إلى مصدر |
| ملاحظة | Observation | نتيجة الأداة التي تعود إلى سياق الوكيل |
| أثر جانبي | Side Effect | تغيير في حالة العالم تحدثه أداة كتابة |
| استدعاء الوظائف | Function Calling | قدرة النموذج على إرجاع طلب منظم لتشغيل دالة معرّفة |
| طلب استدعاء | Tool Call | كائن يحمل اسم الأداة ومعاملاتها ومعرّفًا فريدًا |
| المعاملات | Arguments | القيم التي يمررها النموذج إلى الأداة |
| معرّف الاستدعاء | Call ID | رمز يربط نتيجة الأداة بالطلب الذي أنتجها |
| الحد الأقصى للدورات | Max Turns | سقف لعدد دورات الحلقة يمنع الدوران بلا نهاية |
| مخطط JSON | JSON Schema | لغة لوصف شكل بيانات JSON وقيودها |
| الحقول الإلزامية | required | قائمة الحقول التي يجب أن توجد في المدخلات |
| القيم المعدودة | enum | قائمة مغلقة بالقيم المسموح بها لحقل |
| مخطط المدخلات | inputSchema | وصف معاملات الأداة، وهو حقل إلزامي في MCP |
| التحقق | Validation | فحص المدخلات مقابل المخطط قبل تنفيذ الأداة |
| التعليقات التوضيحية | Annotations | تلميحات عن سلوك الأداة لا يُعتمد عليها أمنيًا ما لم يكن الخادم موثوقًا |
| اختيار الأداة | Tool Selection | قرار الوكيل بشأن أي أداة يستدعي أو عدم استدعاء أي أداة |
| تداخل الأدوات | Tool Overlap | وجود أداتين تؤديان المهمة نفسها تقريبًا مما يربك الاختيار |
| الموجّه | Router | مكوّن يوجه الطلب إلى أداة أو مسار معين |
| زمن الاستجابة | Latency | الوقت بين الطلب والحصول على النتيجة |
| مجموعة اختبار | Evaluation Set | طلبات ثابتة بإجابات متوقعة لقياس الأداء بعد كل تعديل |
| خطأ عابر | Transient Error | فشل مؤقت قد يزول بإعادة المحاولة بعد انتظار |
| التراجع الأسّي | Exponential Backoff | مضاعفة مدة الانتظار بعد كل محاولة فاشلة |
| التذبذب العشوائي | Jitter | قدر عشوائي صغير يضاف للانتظار لتجنب تزامن الطلبات |
| تساوي الأثر | Idempotency | خاصية العملية التي يبقى أثرها واحدًا مهما تكرر تنفيذها |
| مفتاح التكرار | Idempotency Key | معرّف فريد يمنع تنفيذ الطلب نفسه مرتين |
| المهلة | Timeout | أقصى زمن انتظار لاستدعاء قبل اعتباره فاشلًا |
| أقل صلاحية | Least Privilege | منح كل مكوّن الحد الأدنى من الصلاحيات اللازمة لمهمته |
| تجاوز المسار | Path Traversal | استخدام ../ للوصول إلى ملفات خارج المجلد المسموح |
| الحقن غير المباشر للتعليمات | Indirect Prompt Injection | تعليمات خبيثة مخبأة في محتوى خارجي يقرؤه الوكيل عبر أداة |
| الموافقة البشرية | Human Approval | خطوة يؤكد فيها الإنسان الفعل قبل تنفيذه |
| القائمة المسموحة | Allowlist | قائمة صريحة بما يُسمح به ورفض كل ما عداه |
| سجل التدقيق | Audit Log | سجل دائم لكل استدعاء أداة ومعاملاته ونتيجته |
التجربة التطبيقية
اختيار الأدوات ومحاكاة فشلها Tool Selection & Failure
أن ترى كيف تُختار الأداة المناسبة لكل نوع من الطلبات، وكيف تؤثر إعادة المحاولة عند فشل الأداة.
- افتح مختبر الأدوات (افتح ↗)
- جرّب ثلاثة طلبات مختلفة: عملية حسابية، وسؤال عن مفهوم، وطلب قراءة ملف، ولاحظ الأداة المختارة لكل طلب (calculator وknowledge_search وfile_reader)
- في المحاكي أضف عقدة Tool بالأداة db_search واكتب args مناسبة وشغّل
- فعّل الخيار fail لعقدة Tool وشغّل مع retry=0 لعقدة Agent
- ارفع retry إلى 3 وأعد التشغيل وقارن السجل
- أضف بعد الأداة عقدة Condition على last_ok لتوجيه الفشل إلى Output برسالة واضحة
ما الذي ستلاحظه: ستجد أن نوع الطلب يحدد الأداة، وأن تفعيل fail ينتج خطأ فشل الأداة بعد استنفاد المحاولات، وأن رفع retry لا يصلح فشلاً دائماً لكنه يظهر في السجل محاولات متكررة. ومع عقدة Condition ينتهي التشغيل بمخرج منظم بدل توقف مفاجئ.
المهمة الختامية
صمّم مجموعة أدوات لوكيل «مساعد مكتبة جامعية» تضم ثلاث أدوات على الأقل: بحث في فهرس الكتب، وحاسبة غرامات التأخير، وأداة حجز كتاب. سلّم ملف بايثون واحدًا يعمل دون مكتبات خارجية يحتوي على: (1) مخطط JSON لكل أداة بحقول إلزامية وقيود (enum أو حدود رقمية)، (2) دالة تحقق ترفض المدخلات المخالفة برسالة خطأ واضحة، (3) موزّعًا ينفّذ استدعاءً ممثلًا كقاموس ويعيد نتيجة أو خطأ منظّمًا، (4) سياسة إعادة محاولة لأداة البحث فقط مع مفتاح تكرار لأداة الحجز. معايير القبول: يرفض الموزّع أداة غير معروفة، ويرفض قيمة خارج القيود، ولا تُنفَّذ أداة الحجز دون علامة موافقة بشرية، ويرفق الطالب جدولًا قصيرًا يبيّن صلاحية كل أداة (قراءة أو كتابة) وسبب ذلك.
تقييم الإكمال: تُعد الوحدة مكتملة عندما تنهي جميع دروسها وتنجح في اختبارها.
المراجع الرسمية
- Toolformer: Language Models Can Teach Themselves to Use Tools arxiv.org روجع في 2026-11-18
- MCP Specification 2026-07-28: Tools modelcontextprotocol.io روجع في 2026-11-18
- OWASP Top 10 for LLM Applications owasp.org روجع في 2026-11-18
