شاهد: بناء Agents و Flows في CrewAI باستخدام Coding Agent Skills
قم بتثبيت مهارات وكيل البرمجة الخاصة بنا (Claude Code، Codex، …) لتشغيل وكلاء البرمجة بسرعة مع CrewAI. يمكنك تثبيتها باستخدامnpx skills add crewaiinc/skills
في هذا الدليل ستُنشئ Flow يحدد موضوع بحث، ويشغّل طاقمًا بوكيل واحد (باحث يستخدم البحث على الويب)، وينتهي بتقرير Markdown على القرص. يُعد Flow الطريقة الموصى بها لتنظيم التطبيقات الإنتاجية: يمتلك الحالة وترتيب التنفيذ، بينما الوكلاء ينفّذون العمل داخل خطوة الطاقم.
إذا لم تُكمل تثبيت CrewAI بعد، اتبع دليل التثبيت أولًا.
المتطلبات الأساسية
- بيئة Python وواجهة سطر أوامر CrewAI (راجع التثبيت)
- نموذج لغوي مهيأ بالمفاتيح الصحيحة — راجع LLMs
- مفتاح API من Serper.dev (
SERPER_API_KEY) للبحث على الويب في هذا الدرس
ابنِ أول Flow لك
أنشئ مشروع Flow
من الطرفية، أنشئ مشروع Flow (اسم المجلد يستخدم شرطة سفلية، مثل يُنشئ ذلك تطبيق Flow ضمن
latest_ai_flow):src/latest_ai_flow/، بما في ذلك طاقمًا أوليًا في crews/content_crew/ ستستبدله بطاقم بحث بوكيل واحد في الخطوات التالية.اضبط وكيلًا واحدًا في JSONC
أنشئ
src/latest_ai_flow/crews/content_crew/agents/researcher.jsonc (أنشئ مجلد agents/ إذا لزم). تُملأ المتغيرات مثل {topic} من crew.kickoff(inputs=...).agents/researcher.jsonc
حمّل crew JSON (`content_crew.py`)
استبدل
content_crew.py المُولّد بمحمل صغير يحول crew.jsonc إلى Crew.content_crew.py
عرّف Flow في `main.py`
اربط الطاقم بـ Flow: خطوة
@start() تضبط الموضوع في الحالة، وخطوة @listen تشغّل الطاقم. يظل output_file للمهمة يكتب output/report.md.main.py
متغيرات البيئة
في جذر المشروع، ضبط
.env:SERPER_API_KEY— من Serper.dev- مفاتيح مزوّد النموذج حسب الحاجة — راجع إعداد LLM
التثبيت والتشغيل
crewai run نقطة دخول Flow المعرّفة في المشروع (نفس أمر الطواقم؛ نوع المشروع "flow" في pyproject.toml).كيف يترابط هذا
- Flow — يشغّل
LatestAiFlowأولًاprepare_topicثمrun_researchثمsummarize. الحالة (topic،report) على Flow. - الطاقم — يحمّل
kickoff_content_crewملفcrew.jsoncويشغّل مهمة واحدة بوكيل واحد: الباحث يستخدم Serper للبحث على الويب ثم يكتب التقرير. - المُخرَج — يكتب
output_fileللمهمة التقرير فيoutput/report.md.
Agent واحد وkickoff() بلا مهام، راجع Agents.
أصبح لديك Flow كامل مع طاقم وكيل وتقرير محفوظ — قاعدة قوية لإضافة خطوات أو طواقم أو أدوات.
اتساق التسمية
يجب أن تطابق الأسماء فيcrew.jsonc الملفات والمراجع:
agents: ["researcher"]يحمّلagents/researcher.jsonctasks[].agent: "researcher"يربط المهمة بذلك الـ agent
النشر
ادفع Flow إلى CrewAI AMP بعد أن يعمل محليًا ويكون المشروع في مستودع GitHub. من جذر المشروع:دليل النشر
النشر على AMP خطوة بخطوة (CLI ولوحة التحكم).
المجتمع
ناقش الأفكار وشارك مشاريعك وتواصل مع مطوري CrewAI.
