عقلية التدفق أولاً
عند بناء تطبيقات ذكاء اصطناعي إنتاجية مع CrewAI، نوصي بالبدء بتدفق (Flow). بينما يمكن تشغيل أطقم أو وكلاء فرديين، فإن تغليفهم في تدفق يوفر الهيكل اللازم لتطبيق متين وقابل للتوسع.لماذا التدفقات؟
- إدارة الحالة: توفر التدفقات طريقة مدمجة لإدارة الحالة عبر مراحل مختلفة من تطبيقك. هذا ضروري لتمرير البيانات بين الأطقم والحفاظ على السياق ومعالجة مدخلات المستخدم.
- التحكم: تتيح لك التدفقات تحديد مسارات تنفيذ دقيقة، بما في ذلك الحلقات والشرطيات ومنطق التفريع. هذا أساسي لمعالجة الحالات الاستثنائية وضمان سلوك تطبيقك بشكل متوقع.
- المراقبة: توفر التدفقات هيكلًا واضحًا يسهّل تتبع التنفيذ وتصحيح الأخطاء ومراقبة الأداء. نوصي باستخدام تتبع CrewAI للحصول على رؤى تفصيلية. ما عليك سوى تشغيل
crewai loginلتفعيل ميزات المراقبة المجانية.
البنية
يبدو تطبيق CrewAI الإنتاجي النموذجي هكذا:1. فئة التدفق
فئةFlow هي نقطة الدخول. تحدد مخطط الحالة والطرق التي تنفذ منطقك.
2. إدارة الحالة
استخدم نماذج Pydantic لتعريف حالتك. يضمن هذا أمان الأنواع ويوضح البيانات المتاحة في كل مرحلة.- اجعلها بسيطة: خزّن فقط ما تحتاجه للاستمرار بين المراحل.
- استخدم بيانات منظمة: تجنب القواميس غير المنظمة قدر الإمكان.
3. الأطقم كوحدات عمل
فوّض المهام المعقدة إلى الأطقم. يجب أن يكون الطاقم مركّزًا على هدف محدد (مثل “البحث في موضوع”، “كتابة مقال مدونة”).- لا تبالغ في هندسة الأطقم: اجعلها مركّزة.
- مرر الحالة بشكل صريح: مرر البيانات الضرورية من حالة التدفق إلى مدخلات الطاقم.
عناصر التحكم الأولية
استفد من عناصر التحكم الأولية في CrewAI لإضافة المتانة والتحكم إلى أطقمك.1. حواجز المهام
استخدم حواجز المهام للتحقق من مخرجات المهام قبل قبولها. يضمن هذا أن وكلاءك ينتجون نتائج عالية الجودة.2. المخرجات المنظمة
استخدم دائمًا المخرجات المنظمة (output_pydantic أو output_json) عند تمرير البيانات بين المهام أو إلى تطبيقك. يمنع هذا أخطاء التحليل ويضمن أمان الأنواع.
3. خطافات LLM
استخدم خطافات LLM لفحص أو تعديل الرسائل قبل إرسالها إلى LLM، أو لتنقية الاستجابات.أنماط النشر
عند نشر تدفقك، ضع في اعتبارك ما يلي:CrewAI Enterprise
أسهل طريقة لنشر تدفقك هي استخدام CrewAI Enterprise. تتعامل مع البنية التحتية والمصادقة والمراقبة نيابة عنك. راجع دليل النشر للبدء.التنفيذ غير المتزامن
للمهام طويلة التشغيل، استخدمkickoff_async لتجنب حظر واجهتك البرمجية.
الاستمرارية
استخدم مزيّن@persist لحفظ حالة تدفقك في قاعدة بيانات. يتيح لك هذا استئناف التنفيذ إذا تعطلت العملية أو إذا كنت بحاجة لانتظار مدخلات بشرية.
الخلاصة
- ابدأ بتدفق.
- حدد حالة واضحة.
- استخدم الأطقم للمهام المعقدة.
- انشر مع API واستمرارية.
