contiai / apps /api /app /agents /appendix /tasks.py
aliabozahra315's picture
Claude Opus 5
Take a 100-page book from $7.74 to about a tenth of it
b688fe8
Raw History Blame Contribute Delete
7.68 kB
"""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]