"""One analysis task, then six specialist tasks that read it. Ported from `ملتي_ايجنت_ملحقات_الفصول_(1).ipynb`, cell 13. The prompts and schema descriptions are copied byte for byte - they are the work product. Only the credentials and the file paths are adapted. """ from __future__ import annotations from crewai import Task from app.agents.appendix.agents import ( agent_analyzer, agent_case_study, agent_checklist, agent_indicators, agent_reflection, agent_scenarios, agent_tools, ) from app.schemas.appendix import ( CaseStudySection, ChapterAnalysis, ChecklistSection, IndicatorsSection, ReflectionCardsSection, ScenariosSection, ToolsSection, ) def build_tasks(chapter_title: str, chapter_text: str): chapter_block = f'عنوان الفصل: "{chapter_title}"\n\nنص الفصل الكامل (~1500 كلمة):\n---\n{chapter_text}\n---\n\n' task_analysis = Task( description=( chapter_block + "المطلوب: حلّل هذا الفصل وفكّكه بدقة إلى عناصر توجيهية لفريق كتابة متخصص، بحيث:\n" "- تستخرج المحاور الرئيسية والمفاهيم/المصطلحات/النماذج التي وردت حرفيًا في النص (لا تُضف مفاهيم من خارجه).\n" "- تقترح 2-4 فرص أدوات تطبيقية مستمدة من فقرات محددة في الفصل.\n" "- تقترح زاويتين لبطاقات تأمل مختلفتين عن بعضهما.\n" "- تقترح زاويتين لسيناريوهات مدرسية مختلفتين عن بعضهما وعن زوايا التأمل.\n" "- تحدد زاوية واحدة الأنسب لدراسة حالة (أكثر مفهوم إشكالي وتفصيلي في الفصل).\n" "- تحدد زاوية واحدة لقائمة تحقق (أكثر ممارسات قابلة للرصد اليومي).\n" "- تقترح 2-3 فئات مؤشرات قياس منطقية غير متداخلة منبثقة من محاور الفصل.\n" "تأكد أن كل زاوية أو فرصة مرتبطة بجزء محدد وواضح من النص، لتفادي التكرار بين الفرق المتخصصة لاحقًا." ), agent=agent_analyzer(), expected_output="كائن JSON مطابق تمامًا لمخطط ChapterAnalysis", output_pydantic=ChapterAnalysis, ) task_tools = Task( description=( chapter_block + "استخدم تحليل الفصل المرفق في السياق (خصوصًا tools_opportunities وkey_concepts) لتحديد تركيزك.\n" "المطلوب: أنشئ من 2 إلى 4 (أدوات تطبيقية) مستمدة حصريًا من محتوى الفصل أعلاه، بحيث تجيب كل أداة على: " "ما الأداة؟ ما خطوات التنفيذ؟ ما النموذج أو المثال؟ متى تُستخدم؟ مع سؤال تأمل قيادي ختامي لكل أداة. " "لا تكرر نفس الفكرة بين الأدوات، ولا تنسخ مثالاً وارداً حرفيًا في نص الفصل — اصنع مثالاً تطبيقيًا جديدًا ومحددًا." ), agent=agent_tools(), expected_output="كائن JSON مطابق تمامًا لمخطط ToolsSection", output_pydantic=ToolsSection, context=[task_analysis], ) task_reflection = Task( description=( chapter_block + "استخدم تحليل الفصل المرفق في السياق (خصوصًا reflection_angles) لتحديد زوايا بطاقاتك.\n" "المطلوب: أنشئ بطاقة تأمل واحدة أو بطاقتين، كل بطاقة تغطي زاوية مختلفة، بأسئلة تأمل ذاتي موجهة " "للقائد المدرسي (بصيغة المخاطَب المباشر) مرتبطة بمضمون الفصل تحديدًا، مع رسالة تأمل ختامية قصيرة لكل بطاقة." ), agent=agent_reflection(), expected_output="كائن JSON مطابق تمامًا لمخطط ReflectionCardsSection", output_pydantic=ReflectionCardsSection, context=[task_analysis], ) task_scenarios = Task( description=( chapter_block + "استخدم تحليل الفصل المرفق في السياق (خصوصًا scenario_angles) لبناء سيناريوهاتك.\n" "المطلوب: أنشئ سيناريو مدرسي واحدًا أو اثنين، كل سيناريو موقف واقعي قصير (2-4 جمل) " "يُجسِّد مفهومًا محددًا من مفاهيم الفصل عمليًا، متبوعًا بأسئلة نقاش فقط دون حل جاهز." ), agent=agent_scenarios(), expected_output="كائن JSON مطابق تمامًا لمخطط ScenariosSection", output_pydantic=ScenariosSection, context=[task_analysis], ) task_case_study = Task( description=( chapter_block + "استخدم تحليل الفصل المرفق في السياق (خصوصًا case_study_angle) لبناء حالتك.\n" "المطلوب: أنشئ دراسة حالة مدرسية واحدة تفصيلية فقط، بها سياق واضح، 3-5 مؤشرات مشكلة ملموسة، " "ثم 3-5 أسئلة (مهمة القائد) تتدرج من التشخيص إلى الإجراء إلى قياس الأثر." ), agent=agent_case_study(), expected_output="كائن JSON مطابق تمامًا لمخطط CaseStudySection", output_pydantic=CaseStudySection, context=[task_analysis], ) task_checklist = Task( description=( chapter_block + "استخدم تحليل الفصل المرفق في السياق (خصوصًا checklist_angle) لبناء قائمتك.\n" "المطلوب: أنشئ قائمة تحقق من 6 إلى 8 عناصر سلوكية ملموسة (لا أهداف عامة) مرتبطة بمحتوى الفصل، " "مع تفسير للنتيجة حسب عدد الإجابات بـ(نعم) في 3 نطاقات واقعية (مرتفع/متوسط/منخفض)." ), agent=agent_checklist(), expected_output="كائن JSON مطابق تمامًا لمخطط ChecklistSection", output_pydantic=ChecklistSection, context=[task_analysis], ) task_indicators = Task( description=( chapter_block + "استخدم تحليل الفصل المرفق في السياق (خصوصًا indicators_angles) لبناء فئات مؤشراتك.\n" "المطلوب: أنشئ مجموعة مؤشرات قياس مقسّمة إلى فئتين أو ثلاث فئات منطقية غير متداخلة " "مرتبطة بمحتوى الفصل، بـ2-4 مؤشرات قابلة للرصد الفعلي لكل فئة، مع تفسير عام للنتائج ومتى تُستخدم." ), agent=agent_indicators(), expected_output="كائن JSON مطابق تمامًا لمخطط IndicatorsSection", output_pydantic=IndicatorsSection, context=[task_analysis], ) return [task_analysis, task_tools, task_reflection, task_scenarios, task_case_study, task_checklist, task_indicators]