كتب الذكاء الاصطناعيمشاريع الذكاء الاصطناعيمقالات الذكاء الاصطناعيمعجم الذكاء الاصطناعياسئلة واجوبة في الذكاء الاصطناعيأكاديمية الذكاء الاصطناعي للأطفالأكاديمية الذكاء الاصطناعيمدرسة رياضيات الذكاء الاصطناعيمختبر الذكاء الاصطناعيمختبر الخوارزميات المستوحاة من الطبيعةأطلس نماذج الذكاء الاصطناعيموسوعة تطبيقات الذكاء الاصطناعيمستكشف مجموعات البيانات للذكاء الاصطناعياختبارات الذكاء الاصطناعيالفايب كودينغدليل البرمجة بالذكاء الاصطناعيمولّد مشاريع الذكاء الاصطناعيمرصد الذكاء الاصطناعيدليل أدوات الذكاء الاصطناعي البحث والنشر الأكاديميمكتبة البرومبتات الأكاديميةمستودع الرسائل والأطاريح في الذكاء الاصطناعيحاسبة الترقية العلميةأكاديمية الوكلاء الذكيينمختبر أخلاقيات الذكاء الاصطناعي والعدالةساحة ألعاب الذكاء الاصطناعيمختبر التنبؤ بالسلاسل الزمنيةمتحف الذكاء الاصطناعيمختبر الرؤية الحاسوبيةمختبر الشبكات العصبية البيانيةمختبر معالجة اللغة الطبيعيةمختبر الحوسبة الكمّيةخرائط طريق الذكاء الاصطناعي

الأدوات واستدعاء الوظائف

Tools and Function Calling

كيف يتجاوز الوكيل حدود النص فيحسب ويبحث ويقرأ الملفات ويستعلم قواعد البيانات عبر أدوات موصوفة بمخططات واضحة، وكيف نتعامل مع أخطائها ونؤمّنها.

أساسيالمستوى
6الدروس
89 دقيقةزمن القراءة
0أسئلة الوحدة

عن الوحدة

النموذج اللغوي وحده لا يعرف سعر الصرف اليوم ولا يستطيع قراءة ملف على الخادم ولا يضمن دقة عملية حسابية طويلة. الأدوات (Tools) هي الجسر بين تفكير الوكيل والعالم الخارجي. في هذه الوحدة تتعلم ما الأداة وكيف يعمل استدعاء الوظائف (Function Calling) خطوة بخطوة، وكيف تكتب مخطط JSON (JSON Schema) يصف المدخلات بدقة، وكيف يختار الوكيل الأداة المناسبة من بين عدة أدوات، وكيف تتعامل مع المهلات والأخطاء وإعادة المحاولة دون تكرار الآثار الجانبية، وأخيرًا كيف تحمي النظام بمبدأ أقل صلاحية والموافقة البشرية والتحقق من المدخلات. تربط الوحدة كل فكرة بتجربة عملية في مختبر الأدوات ومحاكي الأكاديمية الحتمي.

أهداف التعلم

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

المتطلبات السابقة

  • إتمام وحدة الأساسيات (fundamentals) وفهم حلقة الوكيل
  • إتمام وحدة الذاكرة (memory) أو الإلمام بمفهوم نافذة السياق
  • معرفة أساسية ببايثون (الدوال والقواميس) وبصيغة JSON

المهارات المكتسبة

  • كتابة أوصاف أدوات ومخططات JSON قابلة للتحقق
  • بناء موزّع (dispatcher) بسيط ينفّذ استدعاءات الأدوات
  • تصميم سياسة إعادة محاولة مع تراجع أسّي ومفتاح تكرار آمن
  • تحليل سيناريو واختيار الأداة الأنسب أو عدم استخدام أي أداة
  • تقييم مخاطر أداة وتحديد صلاحياتها ونقاط الموافقة البشرية

الدروس

  1. 1ما الأدوات ولماذا يحتاجها الوكيل؟What Are Tools?النموذج اللغوي بارع في توليد النص، لكنه لا يرى العالم الخارجي ولا يغيّره بنفسه. الأدوات هي الطريقة التي يحصل بها الوكيل على معلومات حديثة وي…12 د
  2. 2استدعاء الوظائف خطوة بخطوةFunction Callingاستدعاء الوظائف هو الآلية التي تجعل النموذج يعبّر عن رغبته في استخدام أداة بصيغة منظمة يفهمها البرنامج. في هذا الدرس نتتبع الدورة كاملة من ت…15 د
  3. 3مخططات الأدوات وJSON SchemaTool Schemasالنموذج لا يرى كود الأداة، بل يرى اسمها ووصفها ومخطط مدخلاتها فقط. لذلك فإن المخطط الجيد نصف نجاح الأداة. في هذا الدرس نكتب مخططًا بصيغة JSO…15 د
  4. 4كيف يختار الوكيل الأداة المناسبة؟Choosing the Right Toolكلما زاد عدد الأدوات المتاحة زادت فرص الاختيار الخاطئ. في هذا الدرس نتعلم كيف نصمم مجموعة أدوات تسهّل على الوكيل القرار، ومتى يكون الخيار ال…14 د
  5. 5أخطاء الأدوات وإعادة المحاولةTool Errors and Retriesالأدوات تتصل بشبكات وخوادم وقواعد بيانات، وكلها تفشل أحيانًا. الوكيل الجيد لا ينهار عند أول خطأ، ولا يكرر عملية دفع مرتين. في هذا الدرس نصنّ…16 د
  6. 6أمان الأدوات والصلاحياتTool Security and Permissionsكل أداة تمنحها للوكيل هي باب إلى نظامك. إذا خُدع الوكيل أو أخطأ فإن الأداة هي ما يحوّل الخطأ إلى ضرر حقيقي. في هذا الدرس نتعلم مبدأ أقل صلاح…17 د

مخططات الوحدة

1234567المستخدمUserالتطبيقApp / RuntimeالنموذجModel + Tool Schemasطلب استدعاء{"name","arguments"}تنفيذ الأداةValidate → Executeنتيجة الأداةTool Resultالإجابة النهائيةFinal Answer
استدعاء الأدوات: النموذج لا ينفذ شيئاً بنفسه؛ يقترح استدعاءً منظماً، والتطبيق يتحقق منه وينفذه ويعيد النتيجة.
فحص المدخلات والمحتوى المسترجعInput & Retrieved-Content Filteringأقل صلاحية لكل أداةLeast Privilegeموافقة بشرية للأفعال الحساسةHuman-in-the-Loopعزل التنفيذ وحدود المواردSandbox & Limitsالتتبع والمراقبة والتنبيهTracing & Monitoring
الدفاع في العمق: لا تعتمد على طبقة واحدة؛ افحص المدخلات، وقيّد الصلاحيات، واطلب الموافقة، واعزل التنفيذ، وراقب.

مصطلحات الوحدة

المصطلحEnglishالتعريف
أداةToolوظيفة برمجية موصوفة يطلب الوكيل تشغيلها لقراءة معلومات أو تنفيذ فعل
تاريخ انقطاع المعرفةKnowledge Cutoffآخر تاريخ تغطيه بيانات تدريب النموذج
الهلوسةHallucinationتوليد معلومة تبدو مقنعة لكنها غير صحيحة أو غير مستندة إلى مصدر
ملاحظةObservationنتيجة الأداة التي تعود إلى سياق الوكيل
أثر جانبيSide Effectتغيير في حالة العالم تحدثه أداة كتابة
استدعاء الوظائفFunction Callingقدرة النموذج على إرجاع طلب منظم لتشغيل دالة معرّفة
طلب استدعاءTool Callكائن يحمل اسم الأداة ومعاملاتها ومعرّفًا فريدًا
المعاملاتArgumentsالقيم التي يمررها النموذج إلى الأداة
معرّف الاستدعاءCall IDرمز يربط نتيجة الأداة بالطلب الذي أنتجها
الحد الأقصى للدوراتMax Turnsسقف لعدد دورات الحلقة يمنع الدوران بلا نهاية
مخطط JSONJSON 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

أن ترى كيف تُختار الأداة المناسبة لكل نوع من الطلبات، وكيف تؤثر إعادة المحاولة عند فشل الأداة.

  1. افتح مختبر الأدوات (افتح ↗)
  2. جرّب ثلاثة طلبات مختلفة: عملية حسابية، وسؤال عن مفهوم، وطلب قراءة ملف، ولاحظ الأداة المختارة لكل طلب (calculator وknowledge_search وfile_reader)
  3. في المحاكي أضف عقدة Tool بالأداة db_search واكتب args مناسبة وشغّل
  4. فعّل الخيار fail لعقدة Tool وشغّل مع retry=0 لعقدة Agent
  5. ارفع retry إلى 3 وأعد التشغيل وقارن السجل
  6. أضف بعد الأداة عقدة Condition على last_ok لتوجيه الفشل إلى Output برسالة واضحة

ما الذي ستلاحظه: ستجد أن نوع الطلب يحدد الأداة، وأن تفعيل fail ينتج خطأ فشل الأداة بعد استنفاد المحاولات، وأن رفع retry لا يصلح فشلاً دائماً لكنه يظهر في السجل محاولات متكررة. ومع عقدة Condition ينتهي التشغيل بمخرج منظم بدل توقف مفاجئ.

افتح التجربة

المهمة الختامية

صمّم مجموعة أدوات لوكيل «مساعد مكتبة جامعية» تضم ثلاث أدوات على الأقل: بحث في فهرس الكتب، وحاسبة غرامات التأخير، وأداة حجز كتاب. سلّم ملف بايثون واحدًا يعمل دون مكتبات خارجية يحتوي على: (1) مخطط JSON لكل أداة بحقول إلزامية وقيود (enum أو حدود رقمية)، (2) دالة تحقق ترفض المدخلات المخالفة برسالة خطأ واضحة، (3) موزّعًا ينفّذ استدعاءً ممثلًا كقاموس ويعيد نتيجة أو خطأ منظّمًا، (4) سياسة إعادة محاولة لأداة البحث فقط مع مفتاح تكرار لأداة الحجز. معايير القبول: يرفض الموزّع أداة غير معروفة، ويرفض قيمة خارج القيود، ولا تُنفَّذ أداة الحجز دون علامة موافقة بشرية، ويرفق الطالب جدولًا قصيرًا يبيّن صلاحية كل أداة (قراءة أو كتابة) وسبب ذلك.

تقييم الإكمال: تُعد الوحدة مكتملة عندما تنهي جميع دروسها وتنجح في اختبارها.

المراجع الرسمية