الانتقال إلى المحتوى الرئيسي

نظرة عامة

يمكن توسيع وكلاء CrewAI بـ خمسة أنواع مميزة من القدرات، كل منها يخدم غرضًا مختلفًا. فهم متى تستخدم كل نوع — وكيف يعملون معًا — هو المفتاح لبناء وكلاء فعّالين.

الأدوات

دوال قابلة للاستدعاء — تمنح الوكلاء القدرة على اتخاذ إجراءات. البحث على الويب، عمليات الملفات، استدعاءات API، تنفيذ الكود.

خوادم MCP

خوادم أدوات عن بُعد — تربط الوكلاء بخوادم أدوات خارجية عبر Model Context Protocol. نفس تأثير الأدوات، لكن مستضافة خارجيًا.

التطبيقات

تكاملات المنصة — تربط الوكلاء بتطبيقات SaaS (Gmail، Slack، Jira، Salesforce) عبر منصة CrewAI. تعمل محليًا مع رمز تكامل المنصة.

المهارات

خبرة المجال — تحقن التعليمات والإرشادات والمواد المرجعية في إرشادات الوكلاء. المهارات تخبر الوكلاء كيف يفكرون.

المعرفة

حقائق مُسترجعة — توفر للوكلاء بيانات من المستندات والملفات وعناوين URL عبر البحث الدلالي (RAG). المعرفة تعطي الوكلاء ما يحتاجون معرفته.

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

أهم شيء يجب فهمه: هذه القدرات تنقسم إلى فئتين.

قدرات الإجراء (الأدوات، MCP، التطبيقات)

تمنح الوكلاء القدرة على فعل أشياء — استدعاء APIs، قراءة الملفات، البحث على الويب، إرسال رسائل البريد الإلكتروني. عند التنفيذ، تتحول الأنواع الثلاثة إلى نفس التنسيق الداخلي (مثيلات BaseTool) وتظهر في قائمة أدوات موحدة يمكن للوكيل استدعاؤها.
from crewai import Agent
from crewai_tools import SerperDevTool, FileReadTool

agent = Agent(
    role="Researcher",
    goal="Find and compile market data",
    backstory="Expert market analyst",
    tools=[SerperDevTool(), FileReadTool()],  # أدوات محلية
    mcps=["https://mcp.example.com/sse"],     # أدوات خادم MCP عن بُعد
    apps=["gmail", "google_sheets"],           # تكاملات المنصة
)

قدرات السياق (المهارات، المعرفة)

تُعدّل إرشادات الوكيل — بحقن الخبرة أو التعليمات أو البيانات المُسترجعة قبل أن يبدأ الوكيل في التفكير. لا تمنح الوكلاء إجراءات جديدة؛ بل تُشكّل كيف يفكر الوكلاء وما هي المعلومات التي يمكنهم الوصول إليها.
from crewai import Agent

agent = Agent(
    role="Security Auditor",
    goal="Audit cloud infrastructure for vulnerabilities",
    backstory="Expert in cloud security with 10 years of experience",
    skills=["./skills/security-audit"],        # تعليمات المجال
    knowledge_sources=[pdf_source, url_source], # حقائق مُسترجعة
)

متى تستخدم ماذا

تحتاج إلى…استخدممثال
الوكيل يبحث على الويبالأدواتtools=[SerperDevTool()]
الوكيل يستدعي API عن بُعد عبر MCPMCPmcps=["https://api.example.com/sse"]
الوكيل يرسل بريد إلكتروني عبر Gmailالتطبيقاتapps=["gmail"]
الوكيل يتبع إجراءات محددةالمهاراتskills=["./skills/code-review"]
الوكيل يرجع لمستندات الشركةالمعرفةknowledge_sources=[pdf_source]
الوكيل يبحث على الويب ويتبع إرشادات المراجعةالأدوات + المهاراتاستخدم كليهما معًا

دمج القدرات

في الممارسة العملية، غالبًا ما يستخدم الوكلاء أنواعًا متعددة من القدرات معًا. إليك مثال واقعي:
from crewai import Agent
from crewai_tools import SerperDevTool, FileReadTool, CodeInterpreterTool

# وكيل بحث مجهز بالكامل
researcher = Agent(
    role="Senior Research Analyst",
    goal="Produce comprehensive market analysis reports",
    backstory="Expert analyst with deep industry knowledge",

    # الإجراء: ما يمكن للوكيل فعله
    tools=[
        SerperDevTool(),         # البحث على الويب
        FileReadTool(),          # قراءة الملفات المحلية
        CodeInterpreterTool(),   # تشغيل كود Python للتحليل
    ],
    mcps=["https://data-api.example.com/sse"],  # الوصول لـ API بيانات عن بُعد
    apps=["google_sheets"],                      # الكتابة في Google Sheets

    # السياق: ما يعرفه الوكيل
    skills=["./skills/research-methodology"],    # كيفية إجراء البحث
    knowledge_sources=[company_docs],            # بيانات خاصة بالشركة
)

جدول المقارنة

الميزةالأدواتMCPالتطبيقاتالمهاراتالمعرفة
يمنح الوكيل إجراءات
يُعدّل الإرشادات
يتطلب كودنعمإعداد فقطإعداد فقطMarkdown فقطإعداد فقط
يعمل محليًانعميعتمدنعم (مع متغير بيئة)غير متاحنعم
يحتاج مفاتيح APIلكل أداةلكل خادمرمز التكامللاالمُضمّن فقط
يُعيَّن على Agenttools=[]mcps=[]apps=[]skills=[]knowledge_sources=[]
يُعيَّن على Crewskills=[]knowledge_sources=[]

تعمّق أكثر

هل أنت مستعد لمعرفة المزيد عن كل نوع من أنواع القدرات؟

الأدوات

إنشاء أدوات مخصصة، استخدام كتالوج OSS مع أكثر من 75 خيارًا، تكوين التخزين المؤقت والتنفيذ غير المتزامن.

تكامل MCP

الاتصال بخوادم MCP عبر stdio أو SSE أو HTTP. تصفية الأدوات، تكوين المصادقة.

المهارات

بناء حزم المهارات مع SKILL.md، حقن خبرة المجال، استخدام الكشف التدريجي.

المعرفة

إضافة المعرفة من ملفات PDF وCSV وعناوين URL والمزيد. تكوين المُضمّنات والاسترجاع.