Documentation Index
Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
Use this file to discover all available pages before exploring further.
فهم قوة الحالة في Flows
إدارة الحالة هي العمود الفقري لأي سير عمل AI متطور. في CrewAI Flows، يتيح لك نظام الحالة الحفاظ على السياق ومشاركة البيانات بين الخطوات وبناء منطق تطبيق معقد. إتقان إدارة الحالة ضروري لإنشاء تطبيقات AI موثوقة وقابلة للصيانة وقوية.لماذا تهم إدارة الحالة
تمكّنك إدارة الحالة الفعّالة من:- الحفاظ على السياق عبر خطوات التنفيذ - تمرير المعلومات بسلاسة بين مراحل سير العمل المختلفة
- بناء منطق شرطي معقد - اتخاذ قرارات بناءً على البيانات المتراكمة
- إنشاء تطبيقات مستمرة - حفظ واستعادة تقدم سير العمل
- معالجة الأخطاء بلطف - تنفيذ أنماط استرداد لتطبيقات أكثر قوة
- توسيع تطبيقاتك - دعم سير العمل المعقدة بتنظيم بيانات مناسب
- تمكين التطبيقات الحوارية - تخزين والوصول إلى سجل المحادثات للتفاعلات الواعية بالسياق
أساسيات إدارة الحالة
نهجان لإدارة الحالة
يوفر CrewAI طريقتين لإدارة الحالة في Flows:- الحالة غير المنظمة - استخدام كائنات شبيهة بالقاموس للمرونة
- الحالة المنظمة - استخدام نماذج Pydantic لسلامة الأنواع والتحقق
مثال الحالة غير المنظمة
مثال الحالة المنظمة
فوائد الحالة المنظمة
- سلامة الأنواع - اكتشاف أخطاء الأنواع في وقت التطوير
- توثيق ذاتي - نموذج الحالة يوثّق بوضوح البيانات المتاحة
- التحقق - التحقق التلقائي من أنواع البيانات والقيود
- دعم IDE - إكمال تلقائي وتوثيق مضمّن
- قيم افتراضية - تعريف بدائل سهلة للبيانات المفقودة
حفظ حالة Flow
يوفر مزخرف@persist() حفظ حالة تلقائي عند نقاط رئيسية في التنفيذ.
تفرع الحالة المستمرة
يدعم@persist نمطين متميزين للترطيب في kickoff / kickoff_async. استخدم استئناف (inputs["id"]) لمواصلة نفس النسب؛ استخدم تفرع (restore_from_state_id) لبدء نسبٍ جديد من لقطة:
state.id بعد kickoff | كتابات @persist تذهب إلى | |
|---|---|---|
inputs["id"] (استئناف) | المعرّف المقدم | المعرّف المقدم (يمد التاريخ) |
restore_from_state_id (تفرع) | معرّف جديد، أو inputs["id"] إذا ثُبّت | المعرّف الجديد (المصدر محفوظ) |
restore_from_state_idغير موجود في الاستمرارية → يعود kickoff بصمت إلى السلوك الافتراضي (يعكس سلوكinputs["id"]عند عدم العثور عليه). لا يُطلق أي استثناء.- الجمع بين
restore_from_state_idوfrom_checkpointيطلقValueError— يستهدفان نظامي حالة مختلفين (@persistمقابل Checkpointing) ولا يمكن الجمع بينهما. restore_from_state_id=None(افتراضي) متطابق بايت ببايت مع kickoff بدون المعامل.- تثبيت
inputs["id"]أثناء التفرع يعني أن التشغيل الجديد يشارك مفتاح الاستمرارية مع تدفق آخر — عادةً ما تريد فقطrestore_from_state_id.
أنماط حالة متقدمة
المنطق الشرطي المبني على الحالة
أفضل الممارسات لإدارة الحالة
- اجعل الحالة مركّزة - صمم الحالة لتحتوي فقط على ما هو ضروري
- استخدم الحالة المنظمة للـ Flows المعقدة - مع نمو التعقيد تصبح الحالة المنظمة أكثر قيمة
- وثّق انتقالات الحالة - للـ Flows المعقدة، وثّق كيف تتغير الحالة عبر التنفيذ
- عالج أخطاء الحالة بلطف - طبّق معالجة أخطاء للوصول إلى الحالة
- استخدم الحالة لتتبع التقدم - استفد من الحالة لتتبع التقدم في Flows طويلة التشغيل
- استخدم العمليات غير المتغيرة عند الإمكان - خاصة مع الحالة المنظمة
الخلاصة
إتقان إدارة الحالة في CrewAI Flows يمنحك القدرة على بناء تطبيقات AI متطورة وقوية تحافظ على السياق وتتخذ قرارات معقدة وتقدم نتائج متسقة.لقد أتقنت الآن مفاهيم وممارسات إدارة الحالة في CrewAI Flows! بهذه المعرفة، يمكنك إنشاء سير عمل AI قوية تحافظ على السياق بفعالية وتشارك البيانات بين الخطوات وتبني منطق تطبيق متطور.
الخطوات التالية
- جرّب الحالة المنظمة وغير المنظمة في Flows
- جرّب تطبيق حفظ الحالة لسير العمل طويلة التشغيل
- استكشف بناء أول Crew لمعرفة كيف تعمل Crews وFlows معًا
- اطلع على توثيق مرجع Flow لمزيد من الميزات المتقدمة
