مفتوح المصدر · Apache 2.0 · Python 3.11+
Phronesis (φρόνησις): عند أرسطو هي الحكمة العملية — القدرة على التداول الجيد والتصرف بفطنة في مواقف ملموسة. يمتلك نموذج اللغة الكبير episteme (المعرفة). يحتاج الوكيل إلى phronesis.
from phronesis import Agent, anthropic
researcher = Agent(
name="researcher",
model=anthropic("claude-opus-4-7"),
system_prompt="You investigate questions thoroughly and cite sources.",
)
answer = await researcher.run("What is phronesis in Aristotelian ethics?")from phronesis import Agent, anthropic
researcher = Agent(
name="researcher",
model=anthropic("claude-opus-4-7"),
system_prompt="You investigate questions thoroughly and cite sources.",
)
answer = await researcher.run("What is phronesis in Aristotelian ethics?")لماذا Phronesis
تعرف نماذج اللغة الكبيرة أشياء — تلك هي الإبستيمي (episteme). لكن على الوكلاء أن يقرروا ويتصرفوا بفطنة في مواقف ملموسة. تلك هي الفرونسيس (phronesis). تعامل معظم أطر الوكلاء وكلاءها كروبوتات محادثة معززة ملصقة بحلقة استخدام أدوات. أما Phronesis فيتعامل معهم كأنظمة متداولة ذات عقود صريحة: مدخلات مطبَّعة، تأثيرات مُعلنة، ذاكرة محدودة، أنماط تنفيذ مُسمَّاة.
تفرض الأطر الحالية اختيارًا. من جهة، تكتب تدفق تحكم اعتباطيًا كشيفرة: أقصى تعبيرية ونظام متعدد الوكلاء لا يستطيع أحد تنقيحه بعد ستة أشهر. ومن جهة أخرى، يُوصف كل شيء بـ YAML أو بُناة رسوم بيانية: مقروء للوهلة الأولى، مستحيل بمجرد أن تحتاج شيئًا غير تافه. يفصل Phronesis المواصفة التعريفية عن التنفيذ في زمن التشغيل. الوكلاء والأدوات والذاكرة والأنابيب هي مواصفات مطبَّعة وثابتة وقابلة للتسلسل إلى JSON. تأتي أنماط التنفيذ من كتالوج مغلق ومُعرَّف جيدًا — تعبيرية دون فوضى.
كل تشغيل قابل للمراقبة عبر OpenTelemetry، وكل مواصفة قابلة للإصدار، وكل عقد فحص في زمن التشغيل، لا تعليق في موجِّه. هذا هو الفرق بين إطار ينتج عروضًا توضيحية وآخر ينتج أنظمة يمكنك تشغيلها.
جولة في الشيفرة
يربط الوكيل نموذجًا وأدوات وذاكرة تحت مواصفة تعريفية واحدة.
from phronesis import Agent, anthropic
from phronesis.memory import SemanticMemory
agent = Agent(
name="assistant",
model=anthropic("claude-opus-4-7"),
tools=[search_web, read_file],
memory=SemanticMemory(scope="session"),
system_prompt="You are a careful research assistant.",
)from phronesis import Agent, anthropic
from phronesis.memory import SemanticMemory
agent = Agent(
name="assistant",
model=anthropic("claude-opus-4-7"),
tools=[search_web, read_file],
memory=SemanticMemory(scope="session"),
system_prompt="You are a careful research assistant.",
)الأنماط
وكلاء يجمعون المعلومات ويستدلون عليها ويُجمِّعون إجابات مع استشهادات.
وكلاء يقرؤون المستندات ويُهيكلونها ويتصرفون عليها بذاكرة صريحة لما رأوه.
أنابيب تُركِّب وكلاء متخصصين عبر تسليمات أو نقاشات أو إجماع.
وكلاء يستدعون أدوات مطبَّعة وخوادم MCP تحت عقود أمان صريحة.
المبادئ
يُكوَّن الوكلاء من أجزاء — نموذج وأدوات وذاكرة وموجِّهات — لا عبر الفئات الفرعية. أنت تُجمِّع؛ لا تتجاوز.
البث والتزامن والإلغاء افتراضات أساسية. لا توجد واجهة برمجة متزامنة موازية لصيانتها.
Pydantic v2 في كل مكان. الأنواع ليست توثيقًا — بل عقود في زمن التشغيل يفرضها الإطار.
التعريفات قابلة للتسلسل إلى JSON وقابلة للاستنساخ. حالة التنفيذ تعيش منفصلة، قابلة للمراقبة والاستعلام.
فترات OpenTelemetry لكل تشغيل وكيل واستدعاء أداة ومرحلة أنبوب — من أول التزام، لا مُلصقة لاحقًا.
Sequence وParallel وReActLoop وConsensus وDebate وHandoff. أنماط مُسمَّاة يمكن الاستدلال عليها — لا تدفقات تحكم اعتباطية.
ماذا في الداخل
الأوّليّات التي يُبنى منها كل وكيل.
كيف يتذكر الوكلاء وماذا يتشاركون.
كيف يتشكل الوكلاء إلى أنظمة.
حالة المشروع
ستتغير واجهة البرمجة. نحن نعمل علنًا لبناء إطار يأخذ أنظمة الوكلاء على محمل الجد — مطبَّع، قابل للتركيب، قابل للمراقبة. لا ادعاءات إنتاج، ولا دراسات حالة مُختلقة، ولا بوابات مؤسسية. فقط الشيفرة والتزام صادق بتصميمها.
نرحب بالملاحظات والأفكار والمساهمات عبر GitHub Discussions وIssues. خارطة الطريق والنقاط الخشنة والأسئلة المفتوحة موجودة جميعها في المستودع.
