Reference OS v8 5 دقائق قراءة ٢٨ مايو ٢٠٢٦ informational: يريد القارئ معرفة كيفية تثبيت واستخدام CrewAI عملياً، مع خطوات واضحة وأمثلة تطبيقية CrewAI دليل عملي: بناء فريق وكلاء ذكاء اصطناعي متعاونين…

Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
تعتقد أن بناء فريق من وكلاء الذكاء الاصطناعي يتطلب خبرة عميقة وبنية تحتية معقدة؟ الحقيقة أن CrewAI يختزل ذلك في بضعة أسطر من كود Python.
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت مطوراً عربياً وتبحث عن طريقة عملية لبناء فريق من وكلاء الذكاء الاصطناعي يتعاونون لحل مشكلات معقدة، فإن CrewAI هو أحد أسهل الحلول المتاحة. في هذا الدليل، سنأخذك خطوة بخطوة من التثبيت إلى تشغيل أول فريق وكلاء لك، مع مثال عربي حقيقي لتحليل اتجاهات السوق السعودي. لا تحتاج إلى خبرة سابقة في مجال الـ AI agents، فقط معرفة أساسية بـ Python.
CrewAI هو إطار عمل Python مفتوح المصدر (رخصة MIT) لبناء وتنسيق وكلاء ذكاء اصطناعي متعاونين. الفكرة الأساسية: بدلاً من وكيل واحد يؤدي كل المهام، يمكنك تعريف عدة وكلاء لكل منهم دور محدد (باحث، كاتب، محلل) ويتعاونون لإنجاز مهمة معقدة. CrewAI مستقل تماماً عن LangChain، مما يجعله خفيفاً وسريعاً.
يناسب: المطورين العرب الذين يريدون أتمتة مهام مثل البحث والتحليل وكتابة التقارير، أو بناء أنظمة دعم قرار، أو إنشاء محتوى تسويقي. لا يناسب: من يريد حلاً جاهزاً بدون برمجة، أو من يحتاج إلى واجهة رسومية (GUI)، أو من يبحث عن أداة متخصصة في مهمة واحدة فقط.
pip install crewaiuv pip install crewaipip install 'crewai[tools]'pip install 'crewai[embeddings]'pip install tiktoken --prefer-binaryإذا واجهت مشاكل في التثبيت، جرب ترقية pip أولاً: pip install --upgrade pip
أنشئ ملفاً باسم .env في مجلد مشروعك وأضف المفاتيح التالية:
# مفتاح OpenAI API (مطلوب) OPENAI_API_KEY=sk-... # مفتاح Serper.dev للبحث (اختياري لكن موصى به) SERPER_API_KEY=YOUR_KEY_HEREيمكنك الحصول على مفتاح OpenAI من هنا، ومفتاح Serper من serper.dev (يوفر 2500 بحث مجاني شهرياً).
في هذا المثال، سنبني فريقاً من وكيلين: الأول باحث (Research Agent) يبحث عن أحدث اتجاهات السوق السعودي في مجال التكنولوجيا، والثاني كاتب (Writer Agent) يلخص النتائج في تقرير.
import os from dotenv import load_dotenv from crewai import Agent, Task, Crew, Process load_dotenv() # تعريف الوكلاء researcher = Agent( role='باحث في السوق السعودي', goal='البحث عن أحدث اتجاهات التكنولوجيا في السعودية', backstory='خبير في تحليل السوق السعودي، يجيد البحث في المصادر العربية والإنجليزية.', verbose=True, allow_delegation=False ) writer = Agent( role='كاتب تقارير', goal='كتابة تقرير موجز باللغة العربية عن اتجاهات السوق', backstory='صحفي تقني يجيد تبسيط المعلومات.', verbose=True, allow_delegation=False ) # تعريف المهام research_task = Task( description='ابحث عن أحدث 3 اتجاهات في مجال التكنولوجيا في السعودية لعام 2025.', expected_output='قائمة بثلاثة اتجاهات مع مصادر.', agent=researcher ) write_task = Task( description='اكتب تقريراً من فقرة واحدة بالعربية يلخص الاتجاهات.', expected_output='نص عربي من 100-150 كلمة.', agent=writer ) # تشكيل الفريق crew = Crew( agents=[researcher, writer], tasks=[research_task, write_task], process=Process.sequential, # تنفيذ المهام بالتسلسل verbose=2 ) # تشغيل الفريق result = crew.kickoff() print('النتيجة:') print(result)بعد تشغيل الكود، سترى النتيجة في الطرفية. يمكنك تعديل المهمة لتناسب احتياجاتك.
نعم، إذا كنت تبحث عن طريقة مرنة وقابلة للتخصيص لبناء وكلاء AI متعاونين. لكنه ليس حلاً جاهزاً، بل إطار عمل يتطلب برمجة. مناسب للمطورين الذين يريدون تحكماً كاملاً.
نعم، تحتاج إلى مفتاح API صالح. يمكنك استخدام gpt-3.5-turbo وهو رخيص نسبياً.
نظرياً نعم، لكن CrewAI مصمم للعمل مع OpenAI API. يمكنك تعديل الكود لاستخدام نماذج أخرى عبر LangChain (لكن هذا يتطلب جهداً إضافياً).
يدعمها من خلال النموذج اللغوي. إذا استخدمت GPT-4 أو GPT-3.5، يمكنه فهم وإنتاج العربية بشكل جيد.
يمكنك تعريف أدواتك الخاصة باستخدام @tool decorator من مكتبة crewai.tools.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ المكتبة الأساسية لبناء وكلاء AI
كيف؟ شغّل الأمر: pip install crewai
الناتج: تثبيت ناجح للمكتبة
لماذا؟ لتخزين مفاتيح API بأمان
كيف؟ أنشئ ملف .env وأضف OPENAI_API_KEY و SERPER_API_KEY
الناتج: ملف .env جاهز
لماذا؟ تحديد أدوار وأهداف كل وكيل
كيف؟ استخدم كلاس Agent مع role, goal, backstory
الناتج: كائنات وكيل جاهزة
لماذا؟ تحديد ما يفعله كل وكيل
كيف؟ استخدم كلاس Task مع description و expected_output
الناتج: كائنات مهمة مرتبطة بالوكلاء
لماذا؟ لتنفيذ المهام بشكل متسلسل
كيف؟ أنشئ Crew بالوكلاء والمهام، ثم استدعِ kickoff()
الناتج: نتيجة المهمة (تقرير عربي)
حوّل القراءة إلى تنفيذ سريع
import os
from dotenv import load_dotenv
from crewai import Agent, Task, Crew, Process
load_dotenv()
researcher = Agent(
role='باحث في السوق السعودي',
goal='البحث عن أحدث اتجاهات التكنولوجيا في السعودية',
backstory='خبير في تحليل السوق السعودي، يجيد البحث في المصادر العربية والإنجليزية.',
verbose=True,
allow_delegation=False
)
writer = Agent(
role='كاتب تقارير',
goal='كتابة تقرير موجز باللغة العربية عن اتجاهات السوق',
backstory='صحفي تقني يجيد تبسيط المعلومات.',
verbose=True,
allow_delegation=False
)
research_task = Task(
description='ابحث عن أحدث 3 اتجاهات في مجال التكنولوجيا في السعودية لعام 2025.',
expected_output='قائمة بثلاثة اتجاهات مع مصادر.',
agent=researcher
)
write_task = Task(
description='اكتب تقريراً من فقرة واحدة بالعربية يلخص الاتجاهات.',
expected_output='نص عربي من 100-150 كلمة.',
agent=writer
)
crew = Crew(
agents=[researcher, writer],
tasks=[research_task, write_task],
process=Process.sequential,
verbose=2
)
result = crew.kickoff()
print('النتيجة:')
print(result)اعرف أين يتعثر الناس وكيف تتجنب ذلك
ماذا تفعل حسب حالتك؟
إذا: إذا كنت مطوراً عربياً وتريد أتمتة مهام معقدة
إذن: استخدم CrewAI
إذا: إذا كنت تبحث عن حل جاهز بدون برمجة
إذن: ابحث عن بدائل مثل SuperAGI
إذا: إذا كنت تحتاج واجهة رسومية
إذن: جرب SuperAGI أو أدوات أخرى
إذا: إذا كنت تريد تحكماً كاملاً ومرونة
إذن: CrewAI هو الخيار الأفضل
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
1. CrewAI مرخص تحت MIT ومجاني تماماً.
2. يتطلب Python 3.10 أو أحدث.
3. يمكن تعريف وكيل في 3 أسطر من الكود.
4. مستقل عن LangChain مما يجعله خفيفاً.
5. يدعم أدوات مخصصة عبر @tool decorator.
6. يمكن استخدامه مع GPT-3.5 أو GPT-4.
7. مفتاح Serper.dev يوفر 2500 بحث مجاني شهرياً.
8. اللغة العربية مدعومة عبر النموذج اللغوي.
إجابات مباشرة على ما يبحث عنه الزائر
تعريفات مختصرة تمنع الالتباس
كيان ذكاء اصطناعي له دور ومهمة محددة في الفريق.
عمل محدد يُسند إلى وكيل، مع وصف للمطلوب والمخرجات المتوقعة.
مجموعة من الوكلاء يتعاونون لإنجاز مجموعة من المهام.
طريقة تنفيذ المهام، مثل التسلسلي (sequential) أو المتوازي.
استخدمها كمسارات متابعة داخل نفس الموضوع
تحول القارئ: من مطور يجهل كيفية بناء وكلاء AI متعاونين إلى مطور قادر على تثبيت CrewAI وتشغيل فريق وكلاء لمهمة حقيقية.
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
CrewAI أداة قوية وبسيطة لبناء وكلاء ذكاء اصطناعي متعاونين. باتباع هذا الدليل، تكون قد حصلت على أساس متين للبدء. الخطوة التالية: جرب بناء فريق لحالة استخدام حقيقية تهمك، وشارك تجربتك مع المجتمع العربي. لا تتردد في الرجوع إلى الوثائق الرسمية على docs.crewai.com لمزيد من التفاصيل.
حتى يبقى المرجع صالحاً مع الوقت
FAQ