Home
Login

إطار عمل خفيف الوزن لوكيل الذكاء الاصطناعي، ينفذ مهام ذكية تلقائيًا من خلال تنفيذ كود Python.

Apache-2.0Python 20.9khuggingfacesmolagents Last Updated: 2025-07-03

smolagents - إطار عمل خفيف الوزن لتطوير وكلاء الذكاء الاصطناعي

نظرة عامة على المشروع

smolagents هي مكتبة Python مفتوحة المصدر تم تطويرها بواسطة Hugging Face، وتركز على بناء وكلاء ذكاء اصطناعي بسيطين وقويين. الفكرة الأساسية للمشروع هي تحقيق أقصى قدر من الوظائف بأقل قدر من التعليمات البرمجية، حيث يتم تحقيق منطق الوكيل بأكمله بحوالي 1000 سطر فقط من التعليمات البرمجية.

الميزات الأساسية

✨ تصميم بسيط للغاية

  • يتم التحكم في المنطق الأساسي للإطار بأكمله في حدود ~1000 سطر من التعليمات البرمجية
  • الحد الأدنى من مستويات التجريد، قريب من عمليات التعليمات البرمجية الأصلية
  • يمكن إنشاء وكيل كامل الوظائف ببضعة أسطر من التعليمات البرمجية

🧑‍💻 وكلاء يعتمدون على التعليمات البرمجية

  • دعم وكلاء التعليمات البرمجية (Code Agents) كمواطنين من الدرجة الأولى
  • يكمل الوكلاء المهام عن طريق كتابة وتنفيذ مقتطفات من تعليمات Python البرمجية
  • بالمقارنة مع عمليات تنسيق JSON/النص التقليدية، يوفر تنفيذ التعليمات البرمجية مرونة وقدرة على الدمج أقوى

🔧 تكامل أدوات غني

  • أدوات عملية مدمجة متعددة، مثل بحث DuckDuckGo وإنشاء الصور وما إلى ذلك
  • دعم توسيع الأدوات المخصصة
  • تكامل عميق مع نظام Hugging Face البيئي

المكونات الرئيسية

أنواع الوكلاء

  1. CodeAgent (وكيل التعليمات البرمجية)

    • ينفذ المهام عن طريق إنشاء وتنفيذ تعليمات Python البرمجية
    • يدعم التعبير المنطقي المعقد ودمج المهام
    • لديه آلية دورة الملاحظة-العمل
  2. ToolCallingAgent (وكيل استدعاء الأدوات)

    • متخصص في سيناريوهات استدعاء الأدوات
    • يدعم مجموعة متنوعة من الأدوات المعرفة مسبقًا والمخصصة

دعم النماذج

  • HfApiModel: يدعم النماذج المختلفة على Hugging Face Hub
  • نماذج OpenAI: متوافقة مع OpenAI API
  • النماذج المحلية: تدعم النماذج اللغوية المنشورة محليًا

الأدوات المدمجة

  • DuckDuckGoSearchTool: وظيفة البحث في الويب
  • PythonInterpreterTool: بيئة تنفيذ تعليمات Python البرمجية
  • ImageGenerationTool: وظيفة إنشاء الصور
  • دعم تطوير الأدوات المخصصة

أمثلة الاستخدام

إنشاء وكيل أساسي

from smolagents import CodeAgent, DuckDuckGoSearchTool, HfApiModel

# إنشاء وكيل
agent = CodeAgent(
    tools=[DuckDuckGoSearchTool()], 
    model=HfApiModel()
)

# تنفيذ المهمة
result = agent.run("حساب الرقم العشرين في سلسلة فيبوناتشي")

وكيل متعدد الأدوات

from smolagents import CodeAgent, DuckDuckGoSearchTool, PythonInterpreterTool

agent = CodeAgent(
    tools=[
        DuckDuckGoSearchTool(),
        PythonInterpreterTool()
    ],
    model=HfApiModel()
)

# تنفيذ مهمة معقدة
result = agent.run("ابحث عن آخر أخبار الذكاء الاصطناعي، وقم بإحصاء تكرار الكلمات الرئيسية")

البنية التقنية

سير العمل

  1. استقبال المهمة: استقبال تعليمات المستخدم باللغة الطبيعية
  2. إنشاء التعليمات البرمجية: يقوم نموذج اللغة الكبير بإنشاء تعليمات Python البرمجية المقابلة
  3. تنفيذ التعليمات البرمجية: تنفيذ التعليمات البرمجية التي تم إنشاؤها في بيئة آمنة
  4. مراقبة النتائج: مراقبة نتائج التنفيذ وإجراء معالجة لاحقة
  5. التحسين التكراري: تعديل وتحسين الإجراءات اللاحقة بناءً على النتائج

آلية الأمان

  • عزل بيئة تنفيذ التعليمات البرمجية
  • الكشف عن التعليمات البرمجية الضارة ومنعها
  • قيود استخدام الموارد

مقارنة مع الأطر الأخرى

بالمقارنة مع أطر الوكلاء التقليدية

  • أكثر إيجازًا: كمية أقل من التعليمات البرمجية، منحنى تعليمي أكثر سلاسة
  • أكثر مرونة: تنفيذ التعليمات البرمجية أكثر تعبيرًا من تنسيق JSON
  • أكثر سهولة: تعليمات Python البرمجية أسهل في الفهم من التكوينات المجردة

بالمقارنة مع LangChain/LangGraph

  • أخف وزنًا: يركز على الوظائف الأساسية، ويتجنب التجريد المفرط
  • أكثر كفاءة: كفاءة تنفيذ أعلى، واستهلاك أقل للموارد
  • أسهل في الاستخدام: تصميم API أبسط وأكثر سهولة

سيناريوهات قابلة للتطبيق

التطوير وتصميم النماذج الأولية

  • بناء نماذج أولية لمساعد الذكاء الاصطناعي بسرعة
  • تعليم وتعلم تطوير وكلاء الذكاء الاصطناعي
  • البحث وتجربة هياكل الوكلاء الجديدة

بيئة الإنتاج

  • أتمتة سير العمل
  • معالجة البيانات وتحليلها
  • إنشاء المحتوى ومعالجته
  • برامج زحف الويب واستخراج المعلومات

تكامل النظام البيئي

تكامل Hugging Face

  • الوصول المباشر إلى النماذج على Hugging Face Hub
  • دعم الضبط الدقيق للنماذج ونشرها
  • العمل بشكل تعاوني مع مكتبات مثل Datasets و Transformers

دعم المجتمع

  • مجتمع مفتوح المصدر نشط
  • أمثلة ودروس تعليمية غنية
  • تحديثات وتحسينات مستمرة للوظائف

مزايا المشروع

  1. تكلفة تعلم منخفضة: تصميم API بسيط، سهل البدء
  2. قابلية توسع قوية: دعم الأدوات والنماذج المخصصة
  3. أداء ممتاز: تصميم خفيف الوزن، كفاءة تنفيذ عالية
  4. مجتمع نشط: خلفية Hugging Face، دعم مجتمعي جيد
  5. مفتوح المصدر ومجاني: مفتوح المصدر بالكامل، يمكن استخدامه وتعديله بحرية

التثبيت والبدء

# تثبيت smolagents
pip install smolagents

# الاستخدام الأساسي
python -c "
from smolagents import CodeAgent, HfApiModel
agent = CodeAgent(model=HfApiModel())
print(agent.run('Hello, World!'))
"

ملخص

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

Star History Chart