إذا كنت مطوراً عربياً وتبحث عن طريقة عملية لبناء فريق من وكلاء الذكاء الاصطناعي يتعاونون لحل مشكلات معقدة، فإن CrewAI هو أحد أسهل الحلول المتاحة. في هذا الدليل، سنأخذك خطوة بخطوة من التثبيت إلى تشغيل أول فريق وكلاء لك، مع مثال عربي حقيقي لتحليل اتجاهات السوق السعودي. لا تحتاج إلى خبرة سابقة في مجال الـ AI agents، فقط معرفة أساسية بـ Python.

ما هو CrewAI؟

CrewAI هو إطار عمل Python مفتوح المصدر (رخصة MIT) لبناء وتنسيق وكلاء ذكاء اصطناعي متعاونين. الفكرة الأساسية: بدلاً من وكيل واحد يؤدي كل المهام، يمكنك تعريف عدة وكلاء لكل منهم دور محدد (باحث، كاتب، محلل) ويتعاونون لإنجاز مهمة معقدة. CrewAI مستقل تماماً عن LangChain، مما يجعله خفيفاً وسريعاً.

من يحتاج CrewAI ومن لا؟

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

المميزات الرئيسية

• بساطة عالية: يمكن تعريف وكيل في 3 أسطر من الكود.
• سرعة: مبني من الصفر بدون اعتماد على أطر ثقيلة.
• مرونة: دعم لأدوات مخصصة ونماذج LLM مختلفة.
• مستقل: لا يحتاج LangChain.
• مفتوح المصدر: مجاني تماماً.

المتطلبات الأساسية

• Python 3.10 أو أحدث.
• حساب OpenAI (مفتاح API) – يمكن استخدام نماذج GPT-3.5 أو GPT-4.
• مفتاح Serper.dev للبحث في الويب (اختياري لكن مفيد).
• مدير حزم pip أو uv.

تثبيت CrewAI خطوة بخطوة

1. تثبيت المكتبة الأساسية:
   pip install crewai
   أو باستخدام uv: uv pip install crewai
2. تثبيت الأدوات الإضافية (اختياري):
   pip install 'crewai[tools]'
   لتثبيت أدوات مثل البحث في الويب.
3. تثبيت tiktoken (ضروري لبعض النماذج):
   pip install 'crewai[embeddings]'
   أو: pip install tiktoken --prefer-binary

إذا واجهت مشاكل في التثبيت، جرب ترقية pip أولاً: pip install --upgrade pip

إعداد ملف .env

أنشئ ملفاً باسم .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)

بعد تشغيل الكود، سترى النتيجة في الطرفية. يمكنك تعديل المهمة لتناسب احتياجاتك.

أخطاء شائعة وحلولها

استخدامات عملية لـ CrewAI في السوق السعودي

• تحليل المنافسين: فريق وكلاء يجمع معلومات عن المنافسين ويكتب تقريراً.
• إنشاء محتوى تسويقي: وكيل يحلل الجمهور المستهدف، وآخر يكتب إعلانات.
• خدمة عملاء آلية: وكيل يستقبل الاستفسارات ويوجهها للوكيل المختص.
• تلخيص الأخبار: وكيل يجمع الأخبار التقنية من مصادر عربية ويكتب ملخصاً يومياً.

هل يستحق CrewAI التجربة؟

نعم، إذا كنت تبحث عن طريقة مرنة وقابلة للتخصيص لبناء وكلاء AI متعاونين. لكنه ليس حلاً جاهزاً، بل إطار عمل يتطلب برمجة. مناسب للمطورين الذين يريدون تحكماً كاملاً.

بدائل CrewAI

أسئلة شائعة

هل أحتاج إلى حساب OpenAI المدفوع؟

نعم، تحتاج إلى مفتاح API صالح. يمكنك استخدام gpt-3.5-turbo وهو رخيص نسبياً.

هل يمكن استخدام نماذج مجانية؟

نظرياً نعم، لكن CrewAI مصمم للعمل مع OpenAI API. يمكنك تعديل الكود لاستخدام نماذج أخرى عبر LangChain (لكن هذا يتطلب جهداً إضافياً).

هل يدعم CrewAI اللغة العربية؟

يدعمها من خلال النموذج اللغوي. إذا استخدمت GPT-4 أو GPT-3.5، يمكنه فهم وإنتاج العربية بشكل جيد.

كيف أضيف أدوات مخصصة؟

يمكنك تعريف أدواتك الخاصة باستخدام @tool decorator من مكتبة crewai.tools.