الفصل الرابع · الأدوات

الأدوات هي أيدي الوكيل. يناقش تصنيف الأدوات ومبادئ التصميم العامة، وبروتوكول MCP وتحديات اختيار الأداة، وثلاثة أنواع من الأدوات (الإدراك، والتنفيذ، والتعاون)، والوكلاء غير المتزامنين المعتمدين على الأحداث.

← العودة إلى الملف التمهيدي الرئيسي · 📖 قراءة نص الفصل

المشاريع المصاحبة

التجربة	المشروع	النوع	الوصف
4-1	أدوات الإدراك	✅	قم ببناء مجموعة شاملة من أدوات الإدراك، وتوفير إمكانيات البحث على الويب، والفهم متعدد الوسائط، وعمليات نظام الملفات، والوصول إلى مصادر البيانات العامة. تعتمد معظم الميزات على واجهات برمجة التطبيقات المجانية والمفتوحة (DuckDuckGo، وOpen-Meteo، وYahoo Finance، وOpenStreetMap، وما إلى ذلك) ولا تتطلب مفتاح API.
4-2	أدوات التنفيذ	✅	تنفيذ مجموعة من أدوات التنفيذ مع آليات السلامة، بما في ذلك عمليات الملفات، ومترجم الشفرة، والمحطة الافتراضية، وتكامل النظام الخارجي. منع العمليات الخطيرة من خلال آلية الموافقة الثانوية LLM، وتلخيص المخرجات المعقدة تلقائيًا، وإجراء التحقق من صحة بناء الجملة على الشفرة.
4-3	أدوات التعاون	✅	توفير إمكانات تعاون شاملة، بما في ذلك أتمتة المتصفح (إطار استخدام المتصفح)، وHuman-in-the-Loop، والإشعارات متعددة القنوات (البريد الإلكتروني، وTelegram، وSlack، وDiscord)، وإدارة المؤقت. يدعم موافقة المسؤول على العمليات الحساسة وإرسال المهام المجدولة.
4-4	الوكيل مع مشغل الحدث	✅	وكيل حديث يعتمد على الأحداث تم تصميمه باستخدام FastAPI، ويدمج جميع الأدوات من خوادم MCP الثلاثة الأولى بشكل افتراضي. يستخدم بنية أصلية غير متزامنة لتحميل أداة MCP النظيفة ويستقبل أحداث متعددة المصادر (الويب، والمراسلة الفورية، GitHub، والمؤقتات، وما إلى ذلك) عبر HTTP API. يوفر وثائق API التلقائية (Swagger UI) وقدرات مراقبة الخلفية.
4-5	وكيل غير متزامن	✅	ينفذ نواة إطار Flux للوكلاء غير المتزامنين القائمين على الأحداث، باستخدام نموذج أحادي الخيط. وتوزع قائمة الأحداث الواردة المهام بحسب السياسة المناسبة، مثل المقاطعة أو التنفيذ الفوري أو الاصطفاف، كما تدعم تشغيل الأدوات بالتوازي، ومقاطعة الجولة الحالية، وإلغاء المهام الطويلة والاستعلام عن حالتها. ويتخذ نموذج لغوي حقيقي القرارات عبر استدعاء الدوال.
4-6	الاكتشاف الاستباقي للأدوات	✅	يقارن بين نهجين: إدراج مخططات أكثر من 120 أداة دفعة واحدة، والاكتشاف عند الطلب. ويحتفظ النهج الثاني بعدد قليل من الأدوات الأساسية وأداة discover_tools الوصفية في موجّه النظام، ثم يستخدم تشابه التضمينات لاسترجاع أكثر 3–5 أدوات متخصصة صلةً. ويخفض ذلك استهلاك الرموز ويحد من اختيار أداة عامة أو غير مناسبة من قائمة طويلة.
—	اختيار الأداة النشطة	✅	تنفيذ آلية اختيار أداة ذكية تسمح للوكيل باختيار المجموعة الأكثر ملاءمة من الأدوات بشكل فعال بناءً على متطلبات المهمة، بدلاً من القبول السلبي لمجموعة أدوات محددة مسبقًا.

بالإضافة إلى ذلك، يوفر chapter4/docker-compose.yml وchapter4/DOCKER_DEPLOYMENT.md حلاً مرجعيًا لتخزين ونشر خوادم الأدوات MCP المذكورة أعلاه.

أنواع المشاريع

الأيقونة	النوع	المعنى
✅	مستقل	شفرة كاملة قابلة للتشغيل في هذا المستودع بعد إعداد مفتاح API
📖	دليل إعادة الإنتاج	وثائق تفصيلية تعتمد على مستودع خارجي يُجلب باستخدام git clone
🚧	وثيقة التصميم	وثيقة تصميم وخطة تنفيذ؛ أما الشفرة القابلة للتشغيل فما تزال قيد التطوير