من ورقة بحثية إلى مستودع مؤرشف
نشرت Microsoft Research ورقة TaskWeaver على arXiv وأصدرت الكود على GitHub في أواخر عام 2023، ووصفته بأنه "أول إطار عمل وكيل يعتمد أولاً على الكود للتخطيط لمهام تحليل البيانات وتنفيذها بسلاسة".
استمر التطوير خلال عام 2024 وحتى أوائل 2025: صدر وضع تنفيذ كود افتراضي قائم على الحاويات في مارس 2024، تلته صورة Docker شاملة في الشهر نفسه، ووصل نظام ذاكرة مشتركة لتمرير المعلومات بين الأدوار في سبتمبر 2024، ثم تكامل مراقبة مع AgentOps في ديسمبر 2024، ودور استدلال تجريبي يُسمى Recepta في يناير 2025، ومدخل رؤية لدور Planner في مارس 2025.
لم تتبع تلك التحديثات في مارس 2025 أي إعلانات ميزات جديدة في سجل تغييرات المشروع نفسه. تباطأ نشاط الالتزامات (commits) ليقتصر على تحديثات التبعيات فقط، وأرشفت Microsoft المستودع في 23 مارس 2026 — يذكر شريط الأرشفة على GitHub أن المستودع "أرشفه المالك في 23 مارس 2026" وأنه "أصبح الآن للقراءة فقط"، ما يعطّل الالتزامات الجديدة وطلبات السحب (pull requests) وتقديم المشكلات.
هذا يضع TaskWeaver في موقع مختلف عن معظم أطر العمل الأخرى في هذه السلسلة. AutoGen في وضع صيانة تديره Microsoft (إصلاحات أخطاء وأمان فقط) مع خليفة معلن، هو Microsoft Agent Framework. أما TaskWeaver فلا يملك خليفة معلنًا ولا أي التزام بالصيانة على الإطلاق — إنه مجمّد تمامًا في الحالة التي كان عليها وقت الأرشفة.
إنشاء المستودع
- التاريخ:
- 2023-09
- ماذا يعني ذلك:
- يُنشأ مستودع GitHub الخاص بـ microsoft/TaskWeaver؛ وتُنشر الورقة البحثية على arXiv بعد ذلك بوقت قصير
وضع الحاوية الافتراضي + صورة Docker
- التاريخ:
- 2024-03
- ماذا يعني ذلك:
- يصبح تنفيذ الكود افتراضيًا داخل حاوية معزولة؛ تظهر صورة Docker شاملة لإعداد بخطوة واحدة
ذاكرة مشتركة + تكامل AgentOps
- التاريخ:
- 2024-09 – 2024-12
- ماذا يعني ذلك:
- يمكن للأدوار مشاركة المعلومات عبر نظام ذاكرة؛ يصل تكامل مراقبة مع AgentOps
دور استدلال Recepta + مدخل رؤية
- التاريخ:
- 2025-01 – 2025-03
- ماذا يعني ذلك:
- يظهر دور استدلال تجريبي ومدخل رؤية لدور Planner — آخر الميزات الموثّقة
أرشفة المستودع من قبل Microsoft
- التاريخ:
- 2026-03-23
- ماذا يعني ذلك:
- يضع GitHub علامة على المستودع بأنه للقراءة فقط: لا التزامات أو إصدارات أو طلبات سحب أو مشكلات جديدة
📌ملاحظة: لا يتغير ترخيص MIT بسبب الأرشفة — يبقى الكود الحالي حرًا في الاستخدام والتفرّع (fork) والتعديل وفق شروطه. ما يتغير هو أن Microsoft لن تُصلح الأخطاء أو تسدّ الثغرات الأمنية أو تضيف ميزات جديدة من الآن فصاعدًا.
ما هو TaskWeaver؟
TaskWeaver هو إطار عمل وكيل ذكاء اصطناعي مفتوح المصدر ويعتمد أولاً على الكود (ترخيص MIT، مؤرشف، github.com/microsoft/TaskWeaver) طورته Microsoft Research لتحليل البيانات — يفسّر طلبًا بلغة طبيعية على أنه كود Python قابل للتنفيذ بدلاً من تعليمات نصية حرة، وينفّذ ذلك الكود في جلسة تحتفظ بحالتها.
- دور Planner: يفكك طلبًا معقدًا إلى سلسلة من المهام الفرعية ويتتبع التقدم طوال المحادثة
- دور Code Generator: يكتب مقاطع كود Python قابلة للتنفيذ لإنجاز كل مهمة فرعية، بالتنسيق مع الإضافات المُهيَّأة
- نظام الإضافات: تُحزَّم العمليات الخاصة بمجال معين (استعلامات قواعد البيانات، التنبؤ، استرجاع المستندات وغيرها) كإضافات يمكن لـ Code Generator استدعاؤها
- تنفيذ يحتفظ بحالة: يحافظ TaskWeaver على سجل المحادثة وسجل تنفيذ الكود معًا — بما في ذلك بنى بيانات موجودة في الذاكرة مثل DataFrames من pandas — طوال الجلسة، وليس فقط نص الرسائل السابقة
- بنى بيانات غنية: بما أن الحالة تبقى في الذاكرة، يمكن لـ TaskWeaver تمرير DataFrame أو كائن Python آخر مباشرة بين الخطوات بدلاً من إعادة تسلسله إلى نص
- التحقق من الكود: يُفحص الكود المولَّد بحثًا عن مشكلات محتملة قبل التنفيذ، مع اقتراح إصلاحات للمستخدم
- فصل متعدد المستخدمين على مستوى الجلسة: تحافظ إدارة جلسات أساسية على فصل بيانات المستخدمين المختلفين، ويعمل تنفيذ الكود في عمليات منفصلة لتجنب التداخل
- تنفيذ قائم على الحاويات افتراضيًا: منذ مارس 2024، يعمل الكود المولَّد داخل حاوية بدلاً من العملية المضيفة، ما يتطلب Docker
مستقل عن النموذج، مع توثيق مثال OpenAI
يتصل TaskWeaver بنموذج لغة تُهيّئه في taskweaver_config.json بدلاً من تضمين نموذج مدمج. يستعرض التوثيق مثالاً باستخدام OpenAI (llm.api_key مع llm.model) ويغطي تهيئة مزودين آخرين في إعدادات أكثر تقدمًا — لكن بما أن المشروع مؤرشف، لن يتلقى هذا التوثيق مزيدًا من التحديثات لواجهات برمجة تطبيقات مزودين أحدث.
# استنساخ وتثبيت (يتطلب Python 3.10+)
git clone https://github.com/microsoft/TaskWeaver.git
cd TaskWeaver
pip install -r requirements.txt
# قم بتهيئة نموذج اللغة في taskweaver_config.json ثم شغّل:
python -m taskweaver -p ./project/كم تكلفة TaskWeaver؟
TaskWeaver نفسه مجاني بموجب ترخيص MIT — لا يوجد اشتراك أو باقة مدفوعة أو خدمة مستضافة من Microsoft يجب دفع ثمنها. أنت تدفع مقابل الأجهزة أو الخادم الخاص بك، بالإضافة إلى أي رسوم واجهة برمجة تطبيقات (API) من مزود نموذج اللغة الذي تُهيّئه في taskweaver_config.json.
- TaskWeaver (إطار العمل مفتوح المصدر): مجاني إلى الأبد بموجب ترخيص MIT، يُستضاف ذاتيًا، بلا حدود استخدام، ولا يتطلب حساب Microsoft لتشغيله
- لا يوجد منتج أو اشتراك مستضاف من Microsoft: TaskWeaver هو كود تشغّله بنفسك، وليس خدمة مُدارة — لا يوجد شيء تشترك فيه
- تكلفة اختيارية: أجهزتك أو خادمك الخاص، بالإضافة إلى رسوم واجهة برمجة تطبيقات مزود نموذج اللغة المُهيَّأ (مثل تسعير OpenAI لكل رمز) إذا وصلت نموذجًا سحابيًا بدلاً من نموذج محلي
- تكلفة اختيارية: يلزم Docker لوضع تنفيذ الكود الافتراضي القائم على الحاويات، والذي يعمل على بنية تحتية تمتلكها بالفعل أو تُهيّئها بنفسك
كيف تثبّت TaskWeaver وتبدأ استخدامه؟
لا توجد لدى TaskWeaver حزمة PyPI — ثبّته باستنساخ مستودع GitHub وتثبيت متطلباته عبر pip، ما يتطلب Python 3.10 أو أحدث. بما أن المشروع مؤرشف، فهذه هي عملية التثبيت نفسها التي صدر بها وقت الأرشفة؛ ولن تكون هناك إصدارات مستقبلية لتثبيتها بدلاً منها.
- 1تأكد من تثبيت Python 3.10 أو أحدث (يمكنك اختياريًا إنشاء بيئة مخصصة أولاً:
conda create -n taskweaver python=3.10 && conda activate taskweaver). - 2استنسخ المستودع:
git clone https://github.com/microsoft/TaskWeaver.git. - 3ثبّت التبعيات:
cd TaskWeaver && pip install -r requirements.txt. - 4هيّئ مزود نموذج لغة في
taskweaver_config.json— على سبيل المثال{"llm.api_key": "مفتاحك", "llm.model": "gpt-4"}لـ OpenAI. - 5ثبّت Docker إذا كنت تخطط لاستخدام وضع تنفيذ الكود الافتراضي القائم على الحاويات (موصى به)؛ راجع توثيق تنفيذ الكود للبديل بلا حاوية.
- 6شغّل واجهة سطر الأوامر من المجلد المستنسخ:
python -m taskweaver -p ./project/، أو استورد المشروع كمكتبة بدلاً من ذلك — راجع توثيق الاستخدام كمكتبة.
تثبيت إصدار أقدم
إذا أردت إصدارًا موسومًا محددًا بدلاً من آخر حالة لفرع main، ثبّته مباشرة من وسم إصدار.
- تحقق من صفحة الإصدارات للاطلاع على الوسوم المتاحة (مثل
v0.0.2-alpha). - ثبّت هذا الوسم مباشرة:
pip install git+https://github.com/microsoft/TaskWeaver@<TAG>.
هل يمكنني تثبيت TaskWeaver رغم أرشفته؟
نعم. الأرشفة تجعل المستودع للقراءة فقط بالنسبة للمساهمات الجديدة، لكن الكود الحالي والفروع والإصدارات الموسومة تبقى قابلة للتنزيل والتثبيت بالكامل كما نُشرت تمامًا.
هل توجد حزمة PyPI لـ TaskWeaver؟
لا. مسار التثبيت الموثّق هو git clone ثم pip install -r requirements.txt من داخل المجلد المستنسخ، أو pip install git+https://github.com/microsoft/TaskWeaver@<TAG> لإصدار موسوم محدد.
لمن يناسب TaskWeaver؟
يناسب TaskWeaver الفرق التي لديها بالفعل نشر عملي مبني عليه، أو التي تريد دراسة بنية Planner/Code Generator الخاصة به كتنفيذ مرجعي. إنه خيار أضيق لمن يبدأ اليوم مشروع وكيل إنتاجي جديد، نظرًا لحالة الأرشفة.
استخدم TaskWeaver إذا
- كان لديك بالفعل نشر إنتاجي مبني على TaskWeaver يلبي احتياجاتك كما هو — الأرشفة لا تُعطّل عمليات التثبيت القائمة
- أردت دراسة بنية Planner + Code Generator موثّقة وتعتمد أولاً على الكود، بما في ذلك نهجها في سجل تنفيذ الكود الذي يحتفظ بحالته، كمرجع لتنفيذك الخاص
- كانت حالة استخدامك تحديدًا تحليل البيانات — جلب البيانات وتحويلها وتشغيل خوارزمية وإنتاج نتيجة — حيث يكون توليد وتشغيل كود Python حقيقي، وليس فقط استدعاء أدوات، هو النمط الصحيح
- كنت على استعداد لصيانة إطار العمل بنفسك من الآن فصاعدًا، بما في ذلك أي إصلاحات توافق مستقبلية لواجهات برمجة تطبيقات نماذج لغة أو إصدارات Python أحدث
تجنّب TaskWeaver إذا
- كنت تبدأ مشروعًا إنتاجيًا جديدًا وتحتاج إلى صيانة نشطة أو تصحيحات أمنية أو تحديثات توافق — AutoGen على الأقل في وضع صيانة تديره Microsoft، وMicrosoft Agent Framework هو المنصة الخليفة التي تطورها Microsoft بنشاط
- احتجت إلى إطار عمل محادثة متعدد الوكلاء عام الغرض بدلاً من مولّد كود مخصص لتحليل البيانات — AutoGen أو CrewAI مبنيان لأنماط محادثة أوسع بين الوكلاء
- احتجت إلى دعم مؤسسي أو اتفاقية مستوى خدمة (SLA) — لا يملك المستودع المؤرشف أي قناة دعم على الإطلاق، ولا حتى قناة تديرها المجتمع
- أردت سير عمل يحتفظ بحالته ومبني على رسم بياني يمكنك فحصه واستئنافه — LangGraph مصمم خصيصًا لهذا النمط ويُصان بنشاط
متى يجب عدم استخدام TaskWeaver؟
تجنّب TaskWeaver لأي مشروع إنتاجي جديد اعتبارًا من هذه المراجعة — أرشفت Microsoft المستودع في 23 مارس 2026، ولا توجد صيانة أو تصحيحات أمنية أو خارطة طريق من الآن فصاعدًا.
- فريق يبدأ مشروع وكيل جديدًا من الصفر — مستودع مؤرشف يحتوي على 53 مشكلة غير محلولة ومجمّدة يُعد أساسًا ضعيفًا لعمل إنتاجي جديد
- فريق يحتاج إلى تصحيحات أمنية للتبعيات — الإصدارات المثبَّتة في
requirements.txtمجمّدة منذ الأرشفة ولن تتلقى تحديثات، لذا فإن أي ثغرة تُكتشف لاحقًا في تبعية مثبَّتة لن تُصلح من المصدر - فريق يحتاج إلى دعم رسمي — لم تعد GitHub Issues، التي كانت وفق ملف README الخاص بالمشروع قناة الدعم "المفضّلة"، تقبل تقديمات جديدة في مستودع مؤرشف
- فريق يقيّم تحديدًا أطر عمل وكلاء Microsoft لبناء جديد — ابدأ بدلاً من ذلك بـ AutoGen (وضع صيانة، لا يزال يتلقى إصلاحات على الأقل) أو Microsoft Agent Framework الذي يُطوَّر بنشاط
- استخدم TaskWeaver فقط عندما تحتاج تحديدًا إلى دراسة أو صيانة نشر قائم من نمطه الذي يعتمد أولاً على الكود ويحتفظ بحالته لـ Planner/Code Generator
TaskWeaver مقابل البدائل
يتنافس TaskWeaver مع أطر عمل وكلاء أخرى قائمة على تنفيذ الكود وضمن نظام Microsoft البيئي، ومعظمها — بخلاف TaskWeaver — لا يزال يُصان بنشاط أو على الأقل في وضع صيانة رسمي.
الأداة | الواجهة | الترخيص | الحالة | الأنسب لـ |
|---|---|---|---|---|
| TaskWeaver | كود Python / سطر أوامر | MIT | مؤرشف (2026-03) | دراسة/صيانة عمليات نشر قائمة |
| AutoGen | كود Python | MIT / CC BY 4.0 | وضع صيانة | تطبيقات AutoGen القائمة فقط |
| Semantic Kernel | SDK لـ .NET/Python/Java | MIT | نشط (يتقارب مع MAF) | SDK تنسيق للمؤسسات |
| CrewAI | كود Python | MIT | نشط، مدعوم برأس مال مخاطر | فرق وكلاء متعددة قائمة على الأدوار |
| LangGraph | كود Python | MIT | نشط | سير عمل يحتفظ بحالته ومبني على رسم بياني |
أخطاء شائعة عند تقييم TaskWeaver
تنشأ هذه الأخطاء من عدم التحقق مباشرة من حالة المستودع، أو من الخلط بين TaskWeaver ومشاريع وكلاء Microsoft الأخرى.
الخطأ 1: عدم التحقق من حالة الأرشفة قبل بدء مشروع جديد
لا يزال وصف TaskWeaver على GitHub يقول "أول إطار عمل وكيل يعتمد أولاً على الكود للتخطيط لمهام تحليل البيانات وتنفيذها بسلاسة" دون ذكر الأرشفة في العنوان — تظهر حالة القراءة فقط كشريط تنبيه في صفحة المستودع نفسها فقط. تحقق دائمًا من المستودع المباشر بحثًا عن شريط أرشفة قبل الاعتماد على إطار عمل لعمل جديد.
الخطأ 2: افتراض أن الأرشفة تعني أن الأداة معطّلة
تعطّل الأرشفة الالتزامات وتقديم المشكلات وطلبات السحب الجديدة — لكنها لا تحذف الكود ولا تُلغي ترخيص MIT. يستمر نشر TaskWeaver القائم بالعمل تمامًا كما كان قبل الأرشفة؛ لا شيء يتعطل في تاريخ الأرشفة نفسه.
الخطأ 3: الخلط بين TaskWeaver وAutoGen أو Microsoft Agent Framework
الثلاثة جميعها مشاريع وكلاء مرتبطة بـ Microsoft، لكنها تقع عند نقاط مختلفة على طيف الصيانة: TaskWeaver مؤرشف (مجمّد)، وAutoGen في وضع صيانة (إصلاحات أخطاء وأمان فقط)، وMicrosoft Agent Framework هو المنصة الخليفة التي تطورها Microsoft بنشاط. تحقق من أي منها تقيّمه فعليًا.
الأسئلة الشائعة
هل لا يزال TaskWeaver مدعومًا؟
لا. أرشفت Microsoft مستودع microsoft/TaskWeaver في 23 مارس 2026، ما جعله للقراءة فقط — لن تُقبل من الآن فصاعدًا أي التزامات جديدة أو إصدارات أو تقديمات مشكلات.
هل TaskWeaver مجاني للاستخدام؟
نعم. TaskWeaver مرخّص بموجب MIT ومجاني للاستخدام التجاري والتعديل والاستضافة الذاتية. لا يوجد اشتراك أو منتج مستضاف من Microsoft يجب دفع ثمنه.
ماذا يعني "مؤرشف" بالنسبة لمستودع GitHub؟
تضع GitHub علامة على المستودع بأنه للقراءة فقط عندما يؤرشفه المالك: لا يمكن تقديم التزامات أو طلبات سحب أو مشكلات جديدة، رغم أن الكود والفروع والإصدارات الحالية تبقى قابلة للتنزيل.
ما هي البنية الأساسية لـ TaskWeaver؟
يفكك دور Planner الطلب إلى مهام فرعية، ويكتب دور Code Generator كود Python وينفّذه لكل مهمة فرعية، ويوفر نظام إضافات عمليات خاصة بمجال معين — كل ذلك منسّق ضمن جلسة تحتفظ بحالتها وتحافظ على سجل المحادثة وسجل تنفيذ الكود.
كيف أثبّت TaskWeaver؟
استنسخ المستودع باستخدام git clone https://github.com/microsoft/TaskWeaver.git، ثم شغّل pip install -r requirements.txt من داخل المجلد المستنسخ. لا توجد حزمة PyPI.
هل يتطلب TaskWeaver Docker؟
ليس بشكل صارم، لكن وضع تنفيذ الكود الافتراضي منذ مارس 2024 يشغّل الكود المولَّد داخل حاوية، ما يتطلب Docker — راجع توثيق تنفيذ الكود للبديل بلا حاوية.
بأي ترخيص يصدر TaskWeaver؟
بترخيص MIT، الذي يسمح بالاستخدام التجاري المجاني والتعديل والاستضافة الذاتية. لا تغيّر أرشفة المستودع الترخيص.
ما الذي حلّ محل TaskWeaver؟
لا يملك TaskWeaver أي خليفة معلن رسميًا. لإطار عمل وكلاء مايكروسوفت عام الغرض ويُطوَّر بنشاط، قيّم بدلاً من ذلك Microsoft Agent Framework أو Semantic Kernel.
كم عدد نجوم GitHub التي يملكها TaskWeaver؟
تجاوز مستودع microsoft/TaskWeaver 6,100 نجمة على GitHub و780 تفرعًا، اعتبارًا من سبتمبر 2026.
هل ما زال بإمكاني فتح مشكلات أو المساهمة في TaskWeaver؟
لا. تعطّل الأرشفة المشكلات الجديدة وطلبات السحب. تبقى الـ53 مشكلة المفتوحة وقت الأرشفة مرئية لكنها مجمّدة — لن تُعالج ولن تُغلق.